cause-analysis

根本原因分析（Cause Analysis）

概要

Issueに記載されている不具合事象を元に、他のコーディングエージェント（commandmatedev経由）を活用して根本原因を深く分析し、原因と対策案をIssue本文に追記します。

使用方法

/cause-analysis [Issue番号]

例：

/cause-analysis 571
/cause-analysis 576

前提条件

• developブランチ上で実行すること
• CommandMateサーバーが稼働していること
• 対象Issueが存在し、事象が記載されていること
• GitHubリポジトリ（https://github.com/Kewton/CommandMate）にアクセス可能

実行内容

あなたはシニアデバッグエンジニアとして、不具合の根本原因を分析します。

重要: commandmatedev で他のコーディングエージェントに分析を委譲する際は、必ず --agent オプションで claude 以外のエージェント（copilot, codex 等）を指定すること。オーケストレーター自身（claude）に送信してはならない。

Step 1: Issue情報の取得

ISSUE_NUM="$ARGUMENTS"
gh issue view "$ISSUE_NUM" --repo Kewton/CommandMate --json number,title,body,labels,comments

Issue本文から以下を抽出：

• 事象の要約
• 再現手順
• 影響範囲
• 関連するソースコード

Step 2: 事前調査（オーケストレーター側）

Issue本文に記載された関連ソースコードを確認し、分析の初期仮説を立てます。

以下の観点で初期仮説を整理：

観点	内容
直接原因	コードのどの部分が事象を引き起こしているか
根本原因の候補	なぜその状態になるのか（設計問題、仕様漏れ、エッジケース等）
影響パス	データフローのどの経路で問題が発生するか

Step 3: 他エージェントによる深層分析

commandmatedevを使用して、develop worktreeの別エージェントに根本原因分析を依頼します。

WORKTREE_ID="mycodebranchdesk-develop"

ANALYSIS_PROMPT="Issue #${ISSUE_NUM} の根本原因分析を実施してください。

## Issue内容
$(gh issue view ${ISSUE_NUM} --repo Kewton/CommandMate --json body -q '.body')

## 分析要求

### Phase 1: 事象の再現パス特定
1. Issue記載の再現手順に基づき、コード上の実行パスを特定してください
2. 関連するソースファイルを読み取り、処理フローを追跡してください
3. 事象が発生する条件（トリガー条件）を具体的に特定してください

### Phase 2: 根本原因の特定
以下の観点で根本原因を分析してください：
- **直接原因**: どのコードが事象を直接引き起こしているか（ファイル名:行番号）
- **根本原因**: なぜそのコードがその状態になるのか
- **設計上の問題**: アーキテクチャや設計レベルで改善すべき点があるか
- **類似リスク**: 同じパターンが他の箇所にも存在するか

### Phase 3: 対策案の策定
以下の粒度で対策案を提示してください：
- **即座対策（Quick Fix）**: 最小限の変更で事象を解消する方法
- **恒久対策（Permanent Fix）**: 根本原因を解消する方法
- **予防策（Prevention）**: 再発を防ぐための設計改善・テスト追加"

# 必ず --agent copilot 等でclaude以外のエージェントを指定する
commandmatedev send "$WORKTREE_ID" "$ANALYSIS_PROMPT" --agent copilot --model claude-opus-4.6 --auto-yes --duration 1h

Step 4: 分析結果の待機と取得

commandmatedev wait "$WORKTREE_ID" --timeout 3600 --on-prompt agent
commandmatedev capture "$WORKTREE_ID" --agent copilot