プロンプトの書き方(コーディング編)

AI Navigate Original / 2026/5/16

共有:

要点

  • コーディング AI は頼み方で出力品質が大きく変わる
  • 5 原則:文脈・完了条件・制約・ファイル参照・計画先
  • 新機能/バグ修正/リファクタ/テストの頻出パターンを使う
  • 曖昧依頼を避け言語別のコツ、Rules で永続化

同じ AI コーディングツールでも、頼み方で返ってくるコードの質はまるで変わります。ふつうの会話プロンプトと違い、コーディングでは「どのファイルを見せるか」「何ができたら完了か」「破ってはいけない制約は何か」を先に渡すほど成功率が上がる。本稿は Cursor・Claude Code・GitHub Copilot のような 2026 年の主要ツールを念頭に、初めての人でも今日から使える具体的な書き方を整理します。

ふわっとした依頼 「このコードをいい感じに直して」 解釈がブレる 文脈+完了条件+制約 Next.js / TS strict / Vitest。 テスト全通過まで直して 狙い通り出る

FIG.1 コーディングのプロンプトは「察してもらう」より「条件をそろえて渡す」

01まず押さえる 5 つの土台

個別のテクニックの前に、どのツールでも効く 5 つの基本があります。これを満たすだけで、やり直しの回数が目に見えて減ります。

01

文脈を十分に渡す

「直して」だけでは前提が伝わりません。「このプロジェクトは Next.js・TypeScript の strict モード・テストは Vitest。認証まわりの X を Y のように直して」のように、フレームワーク・言語設定・テスト基盤を添える。AI はリポジトリ全体を必ずしも読んでいないので、関係する前提を明示するほど精度が上がります。

02

「完了」の条件を言葉にする

「いい感じに」ではゴールが決まりません。「テストが全部通る/Lint エラーなし/既存 API と互換」のように、満たすべき状態を箇条書きで渡す。完了条件があると AI は自分の出力を自己点検しやすくなります。

03

守るべき制約を伝える

「新しいライブラリは足さず既存依存のみ」「外部 API は呼ばない」「計算量は O(N) 以下」など、やってほしくないことこそ明記する。制約がないと AI は手近な解(新規パッケージ追加など)を選びがちです。

04

見てほしいファイルを名指しする

関連コードを指し示すと、的外れな書き換えが激減します。ツールごとの指定方法は後述。曖昧な「このへん」ではなく、ファイル名・関数名で具体的に。

05

大きな作業は計画を先に出させる

いきなり書かせず、「まず実装計画を箇条書きで。OK を出したら実装。途中で迷ったら質問して」と頼む。計画を見て方向を直せば、書き直しのコストを払わずに済みます。

コーディングの成功率を決めるのは、賢い言い回しより渡す文脈の設計。2026 年はモデルが十分賢くなり、何を見せ・どこで区切るかの“段取り”が出力差を生みます。

02ファイル参照:ツールごとの「見せ方」

コーディングで最も効くのが「関係するコードを的確に見せる」こと。主要ツールはそれぞれ指定方法を持っています。読み込ませる量は多すぎても少なすぎても精度が落ちるので、必要な箇所に絞るのがコツです。

続きを読むには無料登録が必要です

アカウントを作成すると、オリジナル記事の全文をお読みいただけます。