この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。OpenAIの現在のモデルガイダンスを確認し、旧版のCoT全文出力中心の説明を、観測可能な証拠とテストで仮説を絞るデバッグ手順へ見直しました。検証ステータス：📘 公式情報確認済み／特定コードベースでの実行検証は未実施
LLMへ「このバグを直して」とだけ頼むと、もっともらしい原因を1つ選び、そのまま修正へ進むことがあります。先に必要なのは、原因の説明ではなく再現できる証拠です。
4つを分けて渡す
- 期待する動作
- 実際の動作
- 最小の再現条件
- ログ・例外・状態値など観測事実
仮説には反証条件を付ける
「原因はAだと思う」で終わらせず、「Aが原因ならこのテストで差が出る」という確認方法をセットにします。テスト結果が一致しなければ次の仮説へ進みます。
修正は最小差分から
原因が確認できたら、関係ないリファクタリングを混ぜず、最小差分で直して既存テストと再現テストを実行します。コード品質改善は別の変更として扱う方が原因追跡しやすくなります。
依頼テンプレート
期待値: {{expected}}
実際値: {{actual}}
再現手順: {{steps}}
観測ログ: {{logs}}
依頼:
- 観測事実と推測を分ける
- 原因候補は最大3つ
- 各候補に反証テストを付ける
- 確認できるまで大規模な修正を提案しない
- 最終修正には回帰テストを付けるまとめ
デバッグでは思考過程の長さより、再現・観測・反証・最小差分・テストを残す方が再現可能です。
公式情報・一次情報
この記事の更新履歴
- 2026-09-13 追加：反証条件と観測事実を使った原因絞り込みを追加。
- 2026-09-13 変更：思考ログ中心から再現可能なデバッグ手順へ変更。
- 2026-09-13 削除：内部メタ情報、本文H1、旧モデル前提、thinkingタグ強制を削除。
