エンジニア向けChatGPT活用中級者〜

「とりあえず作っておいて」「いい感じにして」——エンジニアなら何度も経験したはずの、曖昧な実装依頼。AIを使えば、ふわっとした依頼文から確認すべき質問リストを自動生成できます。手戻りを防ぎ、実装前に認識ズレをつぶすプロンプト集です。

「とりあえず作って」が生む手戻りコスト

曖昧な仕様のまま実装を進めると、こんなことが起きます。

😰 曖昧な依頼あるある

「検索機能をつけておいて」

→ 部分一致?完全一致?複数条件は?

「エラーが出たら教えてほしい」

→ ユーザーに?管理者に?どんなエラーを?

「ページネーションを実装して」

→ 1ページ何件?URLパラメータは?スクロール型?

✅ 質問リスト化後の流れ

実装前に依頼者へ確認リストを送る

認識ズレを実装前につぶせる

「言った言わない」を防げる

手戻り工数が大幅に減る

チケットの受け入れ条件が明確になる

エンジニアが「何を確認すべきか」を一から考えるのは時間がかかります。AIに叩き台を作らせて、自分でフィルタリングするほうが圧倒的に速い。

プロンプト①「曖昧な依頼から確認質問を生成」

依頼文をそのまま貼り付けて、確認すべき質問リストを出させます。

📝 PROMPT

あなたはシニアエンジニアです。以下の実装依頼を受け取りました。
実装を始める前に確認すべき質問リストを作成してください。

【実装依頼】
[依頼内容をここに貼り付け]

以下の観点で、実装に影響する曖昧点を洗い出してください:
1. 機能の範囲・境界(何をする・何をしない)
2. エッジケース・例外処理
3. パフォーマンス要件
4. 既存機能との兼ね合い
5. 認証・権限(誰が使える?)
6. UI/UXの細部(バリデーション・エラー表示など)

各質問には「なぜ確認が必要か」を一行添えてください。
優先度(高・中・低)もつけてください。

実際の出力例(Before/After)

📥 入力した依頼文

「ユーザーが商品を検索できる機能を追加してほしい。できれば絞り込みもできるといいな」

📤 AI生成の質問リスト(抜粋)

【高】検索対象フィールドはどれですか?(商品名のみ?説明文・タグも含む?)

【高】検索方式は部分一致ですか?完全一致ですか?(実装コストに大きく影響)

【高】絞り込み条件は何を想定していますか?(カテゴリ・価格帯・在庫あり/なし?)

【中】検索結果が0件のときの表示はどうしますか?

【低】検索キーワードの履歴保存は必要ですか?

プロンプト②「チケット・Issue から受け入れ条件を生成」

JiraやGitHub IssueのチケットをAIに読ませて、受け入れ条件(Acceptance Criteria)を自動生成させます。

📝 PROMPT

以下のチケット内容をもとに、受け入れ条件(Acceptance Criteria)を作成してください。

【チケット内容】
[チケットのタイトルと説明をここに貼り付け]

受け入れ条件は以下の形式で記述してください:
– 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メッセージ)を作成してください。

【依頼内容】
[元の依頼内容]

【確認したいこと】
[確認事項を箇条書きで]

条件:
– 実装に前向きな姿勢を示しつつ、確認が必要な旨を伝える
– 箇条書きで読みやすく整理する
– 「なぜ確認が必要か」を一言添えて、依頼者が答えやすくする
– 丁寧だが簡潔に(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個に絞ってから依頼者に送る
  • 確認内容はチケットに記録しておくと、将来の自分とチームへの貢献になる