bug-fix

バグ修正

段階的に厳密にバグを修正します。バグを理解する → 根本原因を追跡する → 修正を設計する → 実装する → 検証してリグレッションを確認する。

クイックスタート

バグの報告とともに呼び出します：/bug-fix the login button does nothing on mobile

Claude が質問モードとログモードを有効にするかを尋ねてから、各段階を進めます。修正を適用する前に、必ず承認を求めます。

基本原則

• 修正前に再現する — 理解していないバグの修正は、決して書かないでください
• 根本原因を追跡する — 症状ではなく、原因を修正してください
• 最小限で的を絞った修正 — 根本原因に正しく対処できる、最小の変更を優先してください
• リグレッションを防ぐ — すべての修正は別の問題を引き起こす可能性があります。必ず影響がないことを確認してください
• すべてを追跡する — TodoWrite を使ってすべての段階と進捗を追跡してください
• 判断を記録する — ログモードが有効な場合は、LOG.md に従って調査結果を plans/ に記録してください

Stage 0: セットアップ

1. すべての段階を含む TODO リストを作成します。
2. 報告を読みます：$ARGUMENTS
3. この分野に関連する過去のバグや既知の問題がないか、メモリを確認します。
4. AskUserQuestion を使って、ユーザーに次の2つの質問をします（1回の呼び出しで2つの質問）：
   • 質問モード：Quick / Normal / Grill Me（下記のモードを参照）
   • ログモード：On または Off

質問モード

Quick Mode — 原因が明らかなバグに適しています。想定される根本原因と修正方針を確認してから、質問を最小限に抑えて進めます。

Normal Mode — 期待される動作と実際の動作、再現手順、発生時期、関連する最近の変更について、焦点を絞って質問します。AskUserQuestion を1つずつ使います。

Grill Me Mode — 正確なエラーメッセージ、再現条件、環境、エッジケース、最近の変更、関連する症状など、あらゆる詳細を確認します。AskUserQuestion を1つずつ使います。決して推測しないでください。

どのモードでも、コードベースやエラー出力を読めば答えられる質問には、自分で答えてください。

Stage 1: バグの聞き取りと再現

1. 選択したモードに従って、期待される動作、実際の動作、再現手順、深刻度と影響を明確にします。
2. 関連ファイルを読み、報告されたエントリーポイントからコードの実行経路を追跡します。
3. 再現状況についての理解を確認します。障害がどこで、なぜ発生するのかを記録します。
4. ログモードが有効な場合は、LOG.md に従って初期調査結果をログに記録します。

Stage 2: 根本原因の分析

まずコードマップを確認します。 .codemap/MAP.md が存在する場合は、grep を使う前に読みます。疑わしいシンボルの呼び出し元と呼び出し先を追跡するには、使用箇所を grep する代わりに .codemap/graph.json のエッジ（type: "calls"、type: "imports"）を使います。マップで確認できない詳細については、Glob/Grep/Read に切り替えます。マップが存在しない、または古い場合は、適切なビルダーを提案します：TS/JS には /ken-swe:ts-codemap、Java/Go/Python/Rust には /ken-swe:codemap。

1. AGENTS.md の Tracer プロンプトを使い、汎用エージェントを2〜3個並行して起動します。
2. エージェントが特定したファイルをすべて読みます。
3. 調査結果を提示します。確認された根本原因、正確な障害箇所、影響を受けるすべてのコードパスを示します。
4. 現在の質問モードを使って、追加の質問をします。
5. ログモードが有効な場合は、根本原因をログに記録します。

Stage 3: 修正の設計

1. AGENTS.md の Fixer プロンプトを使い、汎用エージェントを2〜3個並行して起動します。
2. すべてのアプローチを確認し、推奨案を自分でまとめます。
3. 各アプローチの概要、トレードオフとリグレッションのリスク、推奨案とその理由を提示します。
4. ユーザーに希望するアプローチを尋ねます（AskUserQuestion）。
5. ログモードが有効な場合は、修正方針をログに記録します。

Stage 4: 実装

ユーザーから明示的な承認を得るまで、開始してはいけません。

1. 選択した修正の承認を待ちます。
2. これまでの段階で特定した関連ファイルをすべて読みます。
3. コードベースの規約に従って修正を適用します。作業を進めながら TODO を更新します。
4. リグレッションテスト：テストフレームワークがある場合は、このバグを検出できるテストを作成します。ない場合は、テストなしで進めてよいかユーザーに尋ねます。

ステージ 5：回帰テストと品質チェック

1. 自動品質チェックを実施するか、ユーザーに確認します（AskUserQuestion）。
2. 実施する場合：変更したコードをレビューします（正確性、副作用、規約）。重大度別に報告し、今すぐ修正するものと後回しにするものを確認します。
3. AGENTS.md の Regression および Reviewer プロンプトを使用して、エージェントを並行して起動します。
4. 新たに発生した回帰や問題を提示し、ユーザーの判断に基づいて対処します。

ステージ 6：要約

1. すべての TODO を完了済みにします。
2. バグ、根本原因、適用した修正、追加した回帰テスト、変更したファイル、回帰リスク、推奨するフォローアップを要約します。
3. ログモードが有効な場合は、要約セクションを追加してログを仕上げます。