仕様が曖昧なままの実装依頼をAIで「質問リスト」に変換するプロンプト|認識ズレを実装前につぶす
エンジニア向けChatGPT活用中級者〜
「とりあえず作って」が生む手戻りコスト
曖昧な仕様のまま実装を進めると、こんなことが起きます。
😰 曖昧な依頼あるある
「検索機能をつけておいて」
→ 部分一致?完全一致?複数条件は?
「エラーが出たら教えてほしい」
→ ユーザーに?管理者に?どんなエラーを?
「ページネーションを実装して」
→ 1ページ何件?URLパラメータは?スクロール型?
✅ 質問リスト化後の流れ
実装前に依頼者へ確認リストを送る
認識ズレを実装前につぶせる
「言った言わない」を防げる
手戻り工数が大幅に減る
チケットの受け入れ条件が明確になる
エンジニアが「何を確認すべきか」を一から考えるのは時間がかかります。AIに叩き台を作らせて、自分でフィルタリングするほうが圧倒的に速い。
プロンプト①「曖昧な依頼から確認質問を生成」
依頼文をそのまま貼り付けて、確認すべき質問リストを出させます。
📝 PROMPT
実装を始める前に確認すべき質問リストを作成してください。
【実装依頼】
[依頼内容をここに貼り付け]
以下の観点で、実装に影響する曖昧点を洗い出してください:
1. 機能の範囲・境界(何をする・何をしない)
2. エッジケース・例外処理
3. パフォーマンス要件
4. 既存機能との兼ね合い
5. 認証・権限(誰が使える?)
6. UI/UXの細部(バリデーション・エラー表示など)
各質問には「なぜ確認が必要か」を一行添えてください。
優先度(高・中・低)もつけてください。
実際の出力例(Before/After)
📥 入力した依頼文
「ユーザーが商品を検索できる機能を追加してほしい。できれば絞り込みもできるといいな」
📤 AI生成の質問リスト(抜粋)
【高】検索対象フィールドはどれですか?(商品名のみ?説明文・タグも含む?)
【高】検索方式は部分一致ですか?完全一致ですか?(実装コストに大きく影響)
【高】絞り込み条件は何を想定していますか?(カテゴリ・価格帯・在庫あり/なし?)
【中】検索結果が0件のときの表示はどうしますか?
【低】検索キーワードの履歴保存は必要ですか?
プロンプト②「チケット・Issue から受け入れ条件を生成」
JiraやGitHub IssueのチケットをAIに読ませて、受け入れ条件(Acceptance Criteria)を自動生成させます。
📝 PROMPT
【チケット内容】
[チケットのタイトルと説明をここに貼り付け]
受け入れ条件は以下の形式で記述してください:
– Given(前提条件)
– When(操作・イベント)
– Then(期待される結果)
ハッピーパス(正常系)を3〜5件、エラーパス(異常系)を2〜3件作成してください。
曖昧な部分は「要確認:〇〇」と明記してください。
💡 Given/When/Then(GWT)形式とは
BDD(振る舞い駆動開発)でよく使われる受け入れ条件の書き方。「誰が・何をしたとき・どうなるか」を明確にするので、エンジニア・QA・PdMの認識を揃えるのに有効です。AIはこの形式が得意です。
プロンプト③「口頭ミーティングのメモから仕様を構造化」
会議中に取ったメモや議事録をAIに渡して、仕様書の骨格を作らせます。
📝 PROMPT
【ミーティングメモ】
[メモをここに貼り付け]
以下の形式で整理してください:
## 機能概要
(1〜2文で説明)
## スコープ(やること・やらないこと)
– やること:
– やらないこと(今回は対象外):
## 機能詳細
(画面・APIごとに箇条書き)
## 未決事項
(決まっていないこと・要確認事項)
## 技術的な考慮点
(パフォーマンス・セキュリティ・既存機能への影響など)
曖昧な部分や矛盾している部分があれば「⚠️ 要確認」と明記してください。
出力例(抜粋)
📥 入力メモ(例)
「通知機能を追加する。メール送信。ユーザーが設定できるようにしたい。管理者は全員に送れる。頻度は考えてない。まず基本的なのだけ」
📤 AI整理後(抜粋)
スコープ(やること):メール通知送信・ユーザー設定画面・管理者一括送信
スコープ(今回は対象外):プッシュ通知・SMS・送信頻度制限
⚠️ 要確認:「基本的なの」の定義が不明。最低限の機能セットを確認が必要
⚠️ 要確認:管理者の一括送信にオプトアウト(受信拒否)は考慮するか
プロンプト④「実装の影響範囲を洗い出す」
新機能追加・変更時に、既存機能への影響を事前にAIに整理させます。
📝 PROMPT
【変更内容】
[変更・追加する機能の説明]
【システム概要】
[既存システムの概要(使用技術・主な機能・ユーザー種別など)]
以下の観点で影響範囲を整理してください:
1. 既存機能への影響(壊れる可能性があるもの)
2. データベース・スキーマへの影響
3. 外部連携・APIへの影響
4. パフォーマンスへの影響(特に高トラフィック時)
5. 必要なマイグレーション・データ変換
6. テストが必要な範囲
各項目について「影響あり / なし / 要確認」で分類し、影響ありのものは具体的な内容を記述してください。
プロンプト⑤「依頼者への確認メールを生成」
質問リストができたら、依頼者に送る確認メールもAIに書かせましょう。失礼にならない言い回しに整えてくれます。
📝 PROMPT
【依頼内容】
[元の依頼内容]
【確認したいこと】
[確認事項を箇条書きで]
条件:
– 実装に前向きな姿勢を示しつつ、確認が必要な旨を伝える
– 箇条書きで読みやすく整理する
– 「なぜ確認が必要か」を一言添えて、依頼者が答えやすくする
– 丁寧だが簡潔に(Slackで読める長さ)
– 最後に「〇〇までに回答いただけると助かります」の一文を入れる
出力例(抜粋)
📥 よくある確認メッセージ
「検索機能の件、いくつか確認があります。部分一致でいいですか?絞り込みは何を想定ですか?0件のときはどうしますか?」
(質問が連続して読みにくい)
📤 AI整形後のメッセージ
「検索機能の実装を進める前に、以下3点を確認させてください。
① 検索方式:部分一致・完全一致のどちらでしょうか(DBのクエリ設計に影響します)
② 絞り込み条件:カテゴリ・価格帯・在庫など、どの項目を想定していますか
③ 0件時の表示:「該当なし」メッセージだけでよいですか
木曜EODまでにご回答いただけると、今週中に着手できます。」
実務で使うときのポイント
⚠️ AIの質問リストをそのまま送らない
AIは考えられる質問を網羅的に出しますが、全部送ると依頼者が疲弊します。自分の経験で「これは聞かなくても判断できる」「これは後で決めても影響ない」をフィルタリングして、本当に必要な3〜5個に絞ってから送りましょう。
💡 システム概要をプロンプトに入れると精度が上がる
「Djangoで作られたBtoBのSaaSで、ユーザー種別は管理者・一般・ゲストの3種類」など、システムの前提をプロンプトに添えると、より的確な質問が生成されます。よく使うシステム概要はテンプレとして保存しておきましょう。
✅ チケットに質問と回答を記録しておく
確認して得た回答は、JiraやGitHub Issueのチケットにそのまま貼り付けておきましょう。後からジョインしたメンバーや、数ヶ月後の自分が「なぜこうなったか」を追えるようになります。
📌 まとめ
- 曖昧な依頼はAIで質問リスト化すれば、実装前に認識ズレをつぶせる
- プロンプト②のGiven/When/Then形式で受け入れ条件を作ると、QAとの認識共有が楽になる
- プロンプト③で会議メモを構造化すれば、仕様書作成の工数を大幅削減できる
- AIが出す質問は多すぎるので、自分でフィルタリングして3〜5個に絞ってから依頼者に送る
- 確認内容はチケットに記録しておくと、将来の自分とチームへの貢献になる


