障害調査プロンプトは、エラーメッセージを実行可能なチェックリストに変えます。エラーメッセージ、関連ログ、壊れる直前に変更したコードを貼り付けるだけで、AIがまず最も可能性の高い原因を特定し、次に簡単なものから順に確認手順を並べ、最後に修正手順と検証方法を示します。開発者、運用担当者、他人のコードを引き継いだばかりの人に適しており、エラーが出たその場で使えます。原因を推測したり、ドキュメントをあさったりする必要はありません。
このプロンプトをコピーしてそのまま使う
あなたは10年の経験を持つソフトウェアエンジニアで、本番障害やローカルエラーの原因特定が得意です。以下の手順に沿って問題の調査を手伝ってください。手順を飛ばさず、結論を先に言わないでください。 [エラーコードとスタックトレースの先頭20行を含む、完全なエラーを貼り付ける] [エラー前後1分間のログを貼り付ける。関係するサービスのみ] [エラー直前に最後に変更した内容を書く：ファイル、設定、依存関係のバージョン] [言語とバージョン、フレームワーク、OS、デプロイ方法]
次の順序で出力してください：
1. 最も可能性の高い原因を3つ、可能性の高い順に。それぞれ根拠を一文で
2. 検証方法：各原因に対応する、すぐ試せるコマンドまたは確認ポイントを1つずつ
3. 修正手順：最も可能性の高い原因から順に。何を先に変え、変えた後にどう検証するか
4. どれにも当てはまらない場合、追加で必要な情報を挙げる変数を入れ替えれば、同じ文面を繰り返し使える
角かっこ内の4か所が毎回入れ替える変数で、それ以外の文はそのまま使えます。エラーメッセージは今回の障害に関係する部分だけを貼り、スタックトレースが20行を超える場合は繰り返しのフレームを切り取ります。ログはエラー前後1分間で十分で、全文を貼ると本当の原因が埋もれます。最近の変更は最も見落とされやすい項目です。エラーのみ貼って変更内容を書かない人が多く、その場合AIは推測するしかありません。変更内容を明確に書けば、原因特定はたいてい一度で当たります。実行環境ではバージョン番号をフルに書きます。Python 3.12か3.9か、依存関係を上げたかどうか。マイナーバージョンが一つ違うだけで、まったく別の問題になることもあります。
AIに振り回されない使い方
一度に調査するエラーは一つだけにします。二つのエラーを混ぜて貼ると、AIは存在しない一つの原因にまとめてしまいます。回答が来たら、まず1番目の原因に対応する検証方法を見て、1分かけて実行してから修正に取りかかります。5か所まとめて変えてから戻って探すのではなく、一段階変えるごとに検証します。AIが提示したコマンドはまずテスト環境で実行し、無害と確認してから本番に適用します。ログに秘密情報、実際のユーザーデータ、内部アドレスが含まれる場合は、貼る前に伏せます。原因を特定してコードを修正したら、コードレビューのプロンプトでAIに変更内容を重大度順に確認させ、新しい問題が残っていないか確かめられます。拡大中の本番障害は、調査より先に被害を止めること。再現できない問題は、まず再現手順を補うこと。このプロンプトではどちらも手伝いできません。
