「アプリを作って」とAIに頼んでも、画面や機能が思っていたものと違う。そんなときは、長い専門用語を並べるより、目的・今の状況・守ってほしい条件・完成の確認方法を短く伝えるのが近道です。
この記事では、AIコーディングで使い回せる依頼文の型と、出力を確認しながら修正を頼む手順を紹介します。AIツールごとの細かな操作や料金ではなく、依頼内容の整理に絞ります。
結論：目的・状況・制約・完了条件を伝える
最初の依頼には、何を実現したいか、どんな環境や既存ファイルがあるか、変更してよい範囲、どうなれば完成かを入れます。大きな機能を一度に作らせず、まず小さく調べてもらい、確認できる単位で進めてください。
この記事が向いている人
- AIにコードを書いてもらったが、意図と違う結果になる人
- 新しい機能の依頼を、どこまで具体化すればよいか迷う人
- 作業後の確認方法まで含めてAIに頼みたい人
この記事が向いていない人
- 特定のAIサービスやモデルの料金・性能を比べたい人
- 出てきたコードのエラー原因だけを調べたい人
エラーがすでに出ている場合は、依頼文の作り方より、AIが作ったコードが動かないときの切り分け手順から確認できます。
依頼文に入れる4項目
1. 目的：何をできるようにしたいか
「便利なアプリ」ではなく、「CSVを読み込んで担当者ごとの合計を一覧表示する」のように、使う人と操作、得たい結果を書きます。画面の見た目だけでなく、利用場面も添えると優先する機能が伝わります。
2. 状況：今あるものと使う環境
既存プロジェクトなら、関連ファイルや使用言語、起動方法、再現手順を示します。分からない項目は推測させず、「まず関連ファイルを確認し、不明点を質問してください」と書きます。コード作成エージェントでは、必要な資料や参照先を具体的に示すことも役立ちます。
3. 制約：変えてよい範囲と避けること
「画面1つだけ」「既存の設定は変えない」「新しいライブラリは追加前に理由を説明する」など、作業範囲を決めます。顧客情報や本番データを含むファイルを渡さないことも、先に確認しておきたい制約です。
4. 完了条件：何を確認すれば終わりか
「動くようにする」だけでなく、「指定した入力で合計が表示される」「空欄なら説明が出る」「実行した確認方法と結果を報告する」のように観察できる条件を置きます。AIの説明だけで完了とせず、自分でも動作を確かめられる形にします。
コピペ用：小さな変更を依頼するテンプレート
目的：［誰が何をできるようにしたいか］
状況：［使っている環境、関連ファイル、再現手順］
制約：［変更してよい範囲、変えないもの、避けること］
完了条件：［入力・操作と、期待する結果］
まず関連ファイルと現在の動きを確認してください。
不明点や前提があれば、変更前に質問してください。
完了後は変更したファイル、確認方法、確認結果、残った課題を説明してください。最初からすべての欄を埋める必要はありません。必要な情報が足りないなら、AIに先に質問させるのも方法です。依頼が大きい場合は、いきなり実装せず、調査と手順案を先に出してもらい、内容を確認してから変更に進みます。
一度で仕上げようとせず、結果を見て追加する
出力を確認したら、「もう少し良くして」だけでなく、期待との差を1つずつ伝えます。たとえば「合計は出たが、空のCSVで画面が止まる。空の場合は『データがありません』と表示し、その動作を確認してください」のように、再現条件と望む結果を加えます。
複数の変更を一度に頼むと、問題が起きたときに原因を追いにくくなります。変更差分を確認し、必要なら元に戻せる状態を保ってから次の依頼へ進みましょう。公開前の差分・テスト・権限の確認は、AIが書いたコードを公開前に確認する手順も参考になります。
依頼文で失敗しやすいポイント
- 目的を伝えず、技術用語や実装方法だけを指定する
- 関係するファイルや現在の動きを伝えず、AIの推測に任せる
- 完成条件を置かず、見た目ができた時点で終わりにする
- 変更範囲を決めず、無関係なファイルまで触らせる
- テスト結果を見ずに、本番データや公開環境でそのまま使う
よくある質問
英語で依頼したほうがよいですか？
まずは自分が条件を正確に伝えられる言語で書けば十分です。画面表示、エラー文、ファイル名などは実際の表記を残し、必要なら用語の説明を添えてください。
プロンプトの決まった正解はありますか？
どの作業にも通用する固定の文章はありません。目的・状況・制約・完了条件を土台に、AIの返答や実際の動きを見て不足を補います。公式ガイドも、明確な指示や作業の範囲、完了の基準を示す方法を案内しています。
プログラミングを知らなくても依頼できますか？
小さな作業から試すことはできますが、出力の確認や安全な使い方の知識は必要です。学ぶ順番を整理したい場合はAIコーディングを独学するときの学習手順を、質問しながら学べる選択肢も比べたい場合はバイテックGEEKの料金と独学との違いを確認してください。
まとめ：小さく頼み、確認できる形で終える
AIコーディングの依頼文では、目的・状況・制約・完了条件を短くそろえます。まず関連ファイルや前提を確認させ、小さな変更から試し、差分と動作を確かめてください。独学の流れは学習手順の記事、AI作業に必要な周辺環境はAI作業用デスク環境ガイドで続けて整理できます。
