debug

デバッグ

報告された問題を、再現してから修正する体系的な手順でデバッグします。

フェーズ 1：再現と根本原因の分析

1. 調査 — バグ報告から主な症状とエラーメッセージを分析します
2. 追跡 — コードベース内でエラーの発生パターンを検索し、症状から発生源まで追跡します
3. 根本原因 — データフローの分析とエッジケースの確認を通じて根本原因を特定します
4. 再現 — 最小限で有用な確認方法（コマンド、ドライラン、手動フロー、自動テスト）を使って、正確なエラーを再現します
5. 記録 — 根本原因と再現手順を明確に記録します

フェーズ 2：修正の実装

1. 計画 — 根本原因に基づいて最適な修正方法を分析し、コードベース内に類似の修正がないか確認します
2. 実装 — 根本原因に対処する、最小限かつ的を絞った修正を行います
3. 検証 — 再現手順を繰り返して修正を確認し、関連する既存のチェックを実行します。適切な範囲で verify-and-ship に従い、具体的な障害に対して長期的なカバレッジが必要な場合にのみ回帰テストを追加します

原則

• 変更は最小限に — バグのみを修正し、それ以上は変更しません
• 的を絞る — 影響を受けるコードパスのみを変更します
• 検証する — 修正後に再現手順が成功することを確認し、関連する既存の保護措置を維持します。新しいテストファイルの追加は必須ではありません
• 無関係な改善は行わない — 特定のバグの修正に集中します