コーディング向けプロンプト実践：目的・前提・期待出力の分け方

文章を書いてもらうプロンプトと違い、コーディングを頼むプロンプトには「実際に動くかどうか」という明確な合否ラインがあります。あいまいな指示でも、それらしい文章なら及第点に見えることがありますが、コードは動かなければ意味がありません。だからこそ、目的・前提・期待する出力を分けて具体的に伝えることが、通常のプロンプト以上に重要になります。

基本のプロンプトの型はプロンプトの基本で解説した内容と共通していますが、この記事ではコーディング特有の観点に絞って掘り下げます。ツールによって得意な指示の粒度は異なるため、AIコーディングエージェント比較2026年版もあわせて参考にしてください。目的・前提・期待出力を分けて伝える考え方は、AIベンダーが公開しているプロンプト設計のガイドでも共通して推奨されています（参考：Claude Docsの「Prompt engineering overview」）。

まず、何のためにそのコードが必要かを伝えます。「ログイン機能を作って」だけでなく、「メールアドレスとパスワードでログインできるようにしたい。誤ったパスワードを入れたときはエラーメッセージを表示したい」のように、実現したい状態を具体的に書きます。目的が明確だと、AIは実装の方向性を迷わずに済みます。

前提は、AIが正しい判断をするための「制約条件」です。次のような情報を含めると、的外れな実装を減らせます。

• 既存の構成：どんな仕組み・構成の上で動かすか（既存プロジェクトに追加するのか、新規で作るのか）。
• 使ってよい・使ってはいけない方法：特定のやり方を避けたい場合はその理由も添える。
• 影響範囲：他の機能やファイルに影響を与えてよいか、変更してよい範囲はどこまでか。
• すでに分かっている制約：対応させたい環境や、守りたいルールがあれば明記する。

前提を書かずに依頼すると、AIは適当に前提を補って実装してしまい、後から「そこは変えてほしくなかった」というズレが起きやすくなります。

期待出力は、「何をもって成功とみなすか」の基準です。次のように書くと、AI自身が完成度を確認しやすくなります。

悪い例：「入力フォームを作って。」

良い例：「名前とメールアドレスを入力するフォームを作ってください。名前が空欄、またはメールアドレスの形式が誤っている場合は、送信ボタンを押した時点でエラーメッセージを表示してください。正しく入力された場合は『送信しました』という表示に切り替えてください。」

この違いは、正常時の動作と異常時の動作の両方が明記されている点です。期待出力を具体的に書くほど、実装後に自分で確認すべきポイントも明確になります。この点はAIが書いたコードのテストとレビューとも直結します。

複雑な機能ほど、一度のプロンプトで完璧な実装を求めないほうがうまくいきます。「まずは骨組みだけ作って」「動いたら、この部分にエラー処理を足して」のように段階的に依頼し、都度出てきたコードを確認しながら進めましょう。大きな変更を一気に依頼すると、意図しない箇所まで書き換えられるリスクも高まります。小さく依頼し、小さく確認する——この往復が、コーディング向けプロンプトの実践的な基本です。

Q1. 目的・前提・期待出力は毎回すべて書く必要がありますか？
小さな修正であれば省略しても構いません。ただし新機能の追加や複雑な変更を頼むときほど、3つを分けて書くことで手戻りが減ります。慣れないうちは意識的にすべて書く練習をするのがおすすめです。

Q2. 期待出力には何を書けばよいですか？
正常時の動作と異常時の動作の両方を書きます。「正しく入力されたらどうなるか」と「誤った入力のときはどうなるか」をセットで伝えると、AIは完成度を自分で確認しやすくなります。

Q3. 一度に大きな機能を丸ごと依頼してもよいですか？
複雑な機能ほど、一度に完璧な実装を求めないほうがうまくいきます。骨組みだけ作らせてから段階的に肉付けし、都度出てきたコードを確認しながら進める方が、意図しない箇所までの書き換えを防げます。

この記事は無料で読める入門です。コーディング向けプロンプトの実践は、全12週のシラバス第2〜3週「AIコーディングエージェント基礎」で、実際に手を動かしながら扱います（成果や収益をお約束するものではありません）。先行案内はこちら。