安全なバグ修正・テスト・レビュー

このレッスンで学ぶこと

既存プロジェクトのバグ修正は、「エラーらしいものを消す」ことではありません。再現条件と期待する動作を整理し、原因についての根拠を集め、影響を限定した修正を行い、テストと差分で意図した動作を確認します。

作業前に、次をメモします。

共有できない情報はテスト用の値に置き換え、個人情報や認証情報はプロンプトに含めません。既存の作業差分やプロジェクトのルールも確認します。

まず変更せずに、再現手順、関係するコード、関連テスト、原因候補を説明してもらいます。

この不具合を再現する手順、関係する処理、関連テストを調べてください。まだファイルを変更しないでください。確認できた事実と仮説を分け、原因候補ごとに根拠となるファイルと追加で確かめる方法を示してください。

調査結果を読み、原因が分からない場合は修正へ進まず、再現手順や入力条件を絞ります。計画には、変更するファイル、変更の目的、影響範囲、テスト方法、完了条件を含めます。

計画に同意したら、対象と範囲を指定して修正を許可します。テストが不足している場合は、不具合が起きる条件を再現するテストを追加できるか相談します。既存テストの期待値を変えるだけで失敗を消すのではなく、要件との整合性を確認します。

テストコマンドを実行する前に、リポジトリに定義されたコマンドと副作用を確認します。依存追加、データベース変更、ネットワークアクセスなどが計画に含まれる場合は、必要性と影響について別に確認します。

次を順番に確かめます。

Claude Codeには、変更ファイル、実行したテストと結果、未実施の検証を分けて報告するよう依頼できます。最終的な差分と画面・実行結果は自分でも確認してください。

練習用の既存プロジェクトから、個人データや外部サービスに依存しない再現可能な不具合を一つ選びます。原因調査のみの依頼、修正計画のレビュー、修正の許可、テスト、差分レビューの順に進めます。

公式ドキュメントの参照先を2026年10月18日に確認しました。プロジェクトのルール、承認設定、利用環境が優先されます。