Triage Issue(問題のトリアージ)
報告された問題を調査し、根本原因を特定し、TDD修正計画を含むGitHub Issueを作成します。これはほぼハンズオフのワークフローです — ユーザーへの質問は最小限に抑えてください。
プロセス
1. 問題を把握する
ユーザーから問題の簡単な説明を受け取ります。ユーザーが説明を提供していない場合は、1つだけ質問してください: 「どんな問題が起きていますか?」
フォローアップの質問はしないでください。すぐに調査を開始します。
2. 探索と診断
Agentツールを subagent_type=Explore で使用し、コードベースを徹底的に調査します。目標は以下を見つけることです:
- どこで バグが現れるか(エントリポイント、UI、APIレスポンス)
- どの コードパスが関係しているか(フローを追跡)
- なぜ 失敗するか(症状ではなく根本原因)
- どのような 関連コードが存在するか(類似パターン、テスト、隣接モジュール)
以下を確認します:
- 関連するソースファイルとその依存関係
- 既存のテスト(何がテストされていて、何が不足しているか)
- 影響を受けるファイルへの最近の変更(該当ファイルの
git log) - コードパス内のエラーハンドリング
- コードベース内の他の場所で正しく動作している類似パターン
3. 修正アプローチを特定する
調査結果に基づいて、以下を判断します:
- 根本原因を修正するために必要な最小限の変更
- 影響を受けるモジュール/インターフェース
- テストで検証すべき動作
- これが回帰、機能不足、設計上の欠陥のいずれであるか
4. TDD修正計画を設計する
具体的で順序付けられたRED-GREENサイクルのリストを作成します。各サイクルは1つの垂直スライスです:
- RED: 壊れた/欠落した動作を捕捉する特定のテストを記述する
- GREEN: そのテストをパスさせるための最小限のコード変更を記述する
ルール:
- テストは実装の詳細ではなく、公開インターフェースを通じて動作を検証する
- 一度に1つのテスト、垂直スライス(すべてのテストを先に書いてからすべてのコードを書くのではない)
- 各テストは内部リファクタリング後も有効であるべき
- 必要に応じて最終的なリファクタリングステップを含める
- 耐久性: コードベースの大幅な変更後も有効な修正のみを提案する。内部構造ではなく、動作と契約を記述する。テストは内部状態ではなく、観測可能な結果(APIレスポンス、UI状態、ユーザーに見える効果)に対してアサーションを行う。良い提案は仕様のように読み、悪い提案はdiffのように読める。
5. GitHub Issueを作成する
以下のテンプレートを使用して、GitHub CLIで gh issue create を実行します。作成前にユーザーにレビューを求めず、作成後にURLを共有します。
問題
バグや問題の明確な説明。以下の内容を含む:
- 何が起きているか(実際の動作)
- 何が起きるべきか(期待される動作)
- 再現方法(該当する場合)
根本原因分析
調査中に見つけた内容を記述:
- 関係するコードパス
- 現在のコードが失敗する理由
- 寄与する要因
現在のコードレイアウトに依存する具体的なファイルパス、行番号、実装の詳細は含めない。代わりにモジュール、動作、契約を記述する。Issueは大規模なリファクタリング後も有用であるべき。
TDD修正計画
番号付きのRED-GREENサイクルのリスト:
-
RED: [期待される動作を記述するテストを書く] GREEN: [テストをパスさせるための最小限の変更]
-
RED: [次の動作を記述するテストを書く] GREEN: [テストをパスさせるための最小限の変更]
...
REFACTOR: [すべてのテストがパスした後の後片付け]
受け入れ基準
- 基準1
- 基準2
- すべての新しいテストがパスする
- 既存のテストがパスする
Issueを作成したら、IssueのURLと根本原因の1行サマリーを出力します。