AIに「直して」で壊されない。5分で作るバグ報告テンプレ

【購入前に確認できること】
コード経験は不要です。5分版なら、不具合が起きた画面・再現操作・利用環境があれば作れます。完全版の所要時間は15〜30分です。
完成するもの：AIが原因調査を始められるバグ報告と、調査・修正・確認を分ける指示文。
完成しないもの：不具合の自動修正や、個別環境へのサポート。AIへ頼めば必ず直ると約束する記事ではありません。
【Before / After】
Before：保存ボタンが動きません。原因を調べて直してください。
After：Windows 11のChromeで、設定画面の表示名を変更して保存すると成功表示は出ますが、再読み込みすると元へ戻ります。5回中5回再現し、画面上のエラーはありません。まずコードを変更せず、不足情報を最大5問だけ質問してください。
文章を長くするのではなく、観測事実と次の調査行動を明確にすることで、保存API・再取得処理・キャッシュ・画面状態へ調査対象を絞れます。

購入後は、15項目の完全版へ事実を記入し、不足情報だけを質問させ、調査中はコードを変更させず、承認後に最小差分で修正し、最後に再発防止テストへ変える順番で進められます。
収録内容は、完全版バグ報告テンプレート、調査・修正・テストを分離した12本のプロンプト、失敗しやすいパターン、直ったと判断するチェック項目です。

【最初の10分でやること】
記事末のMarkdown版テンプレートをコピーし、症状・再現手順・期待結果・実際の結果・環境・エラーだけ埋めます。
次に「プロンプト1：不足情報だけを質問してもらう」を実行し、分からない項目は「未確認」と書いて「プロンプト3：関連ファイルを特定する」へ進みます。
この時点では修正を許可しません。原因調査とコード変更を分けることが、別の機能を壊すリスクを抑える最初の防波堤です。

「
ボタンを押しても動きません。直してください」

AIにこう頼んだら、関係のないファイルまで書き換えられた。
一度は直ったように見えたのに、別の画面が壊れた。
何度説明しても「こちらでは再現できません」で終わる。

AIを使ってアプリを作っていると、こんな場面にぶつかります。

原因は、AIの能力不足だけではありません。多くの場合、修正に必要な証拠が足りないまま、いきなり修正を頼んでいることが原因です。

この記事では、曖昧な「動かない」を、ChatGPTやCodexが原因を絞り込めるバグ報告へ変える方法をまとめました。

• 5分で集めるべき情報

• 再現手順の書き方

• エラー文やログの安全な渡し方

• 原因調査と修正を分けるプロンプト

• 変更範囲を広げない指示

• 修正後の再発防止テスト

すべてコピペして使える形にしています。

対象は、AIを使ってWebアプリや小さなツールを作っている非エンジニア〜初級者です。専門用語が分からなくても、画面で確認できる事実から順番に埋められます。

なぜ「動かない、直して」では直らないのか

バグ修正は、推理に似ています。

AIが見られるのは、あなたが渡したコード、画面、ログ、説明だけです。情報が足りないと、AIは「よくある原因」を推測するしかありません。

たとえば「ログインできない」だけでは、次のどれか判断できません。

• メールアドレスの入力形式が不正

• パスワードが間違っている

• ログインAPIへ通信できていない

• APIは成功したが画面遷移していない

• セッションの保存に失敗している

• 特定のブラウザだけCookieが拒否されている

この状態で修正を頼むと、当たれば直ります。しかし外れれば、関係のないコードが増え、問題が複雑になります。

大切なのは、最初から原因を言い当てることではありません。
AIが原因を切り分けられる観測事実をそろえることです。

まず5分で集める「最小バグ報告」

急いでいるときは、最初に次の7項目だけ埋めてください。

## 症状
何をすると、何が起きますか？

## 再現手順
1.
2.
3.

## 期待する結果
本来どうなるべきですか？

## 実際の結果
実際にはどうなりますか？

## 発生頻度
毎回 / ときどき / 1回だけ

## 環境
端末：
OS：
ブラウザまたはアプリ：

## エラー
画面のエラー文：
コンソールやログのエラー：

ポイントは、「ログインがおかしい」のような解釈ではなく、見たものをそのまま書くことです。

悪い例：

良い例：

後者なら、通信、画面遷移、エラー表示のどこを調べるべきか候補を作れます。

スクリーンショットだけでは足りない

スクリーンショットは「結果」を伝えるのに便利ですが、その直前に何をしたかは分かりません。

画像を渡すときは、次の3点を添えてください。

この画像は、
- どの画面か：
- 何をした直後か：
- 注目してほしい場所：

操作の途中でだけ起こる不具合は、短い画面録画も有効です。録画には個人情報、通知、APIキー、顧客データが映らないようにしてください。

AIへ渡す前の安全確認

エラーやログには、公開してはいけない情報が混ざることがあります。

次の情報は、そのまま貼らずに伏せ字へ置き換えます。

• パスワード

• APIキー、アクセストークン

• Cookie、セッションID

• 個人のメールアドレス、電話番号、住所

• 顧客名や注文情報

• 非公開URLや社内の識別子

たとえば、

Authorization: Bearer sk-xxxxxxxx

ではなく、

Authorization: Bearer [REDACTED]

とします。

秘密情報を一度送信してしまった場合は、削除するだけでなく、そのキーやトークンを無効化・再発行してください。

無料部分のまとめ

AIに修正を頼む前に、最低でも次の3点を言葉にします。

1. どんな操作で再現するか

2. 期待した結果と実際の結果は何か

3. どの環境で、どんなエラーが出たか

ここまででも、やみくもな修正はかなり減らせます。

ここから先では、原因の切り分け精度を上げる15項目、AIへそのまま渡せる完全版バグ報告、調査・修正・テストを分離した12本のプロンプトを紹介します。