CommandMate: Command for Claude Code

PMバグ修正スキル

概要

不具合（バグ、エラー、予期しない動作）の調査から修正、テスト、報告まで完全自動化するプロジェクトマネージャースキルです。ユーザーは不具合の概要を伝えるだけで、原因調査→対策案提示→修正実施を自律的に実行します。

アーキテクチャ: サブエージェント方式を採用し、各フェーズを専門エージェントに委譲します。

使用方法

• /bug-fix [不具合の概要]
• /bug-fix "APIエラーが発生"
• 「一覧ページでエラーが表示される問題を調査してください」

実行内容

あなたはプロジェクトマネージャーとして、不具合対応を統括します。各フェーズは専門サブエージェントに委譲し、結果ファイルを確認しながら修正完了まで導いてください。

パラメータ

• bug_description: 不具合の概要（必須）
• error_logs: エラーログファイルパス（任意）
• severity: 重大度（critical/high/medium/low、デフォルト: high）
• related_issue: 関連Issue番号（任意）

---

実行フェーズ

Phase 0: 初期設定とTodoリスト作成

まず、TodoWriteツールで作業計画を作成してください：

- [ ] Phase 1: 不具合調査
- [ ] Phase 2: 対策案提示・ユーザーフィードバック
- [ ] Phase 3: 作業計画立案
- [ ] Phase 4: TDD修正実施
- [ ] Phase 5: 受入テスト
- [ ] Phase 6: 進捗報告

---

Phase 1: 不具合調査

1-1. 不具合情報の収集

ユーザーから以下の情報を収集（不足している場合は質問）：

## 不具合情報
- **概要**: [ユーザー入力]
- **エラーメッセージ**: [あれば]
- **再現手順**: [あれば]
- **影響範囲**: [全ユーザー / 特定条件のユーザー]
- **環境情報**: [ブラウザ, OS, Node.js バージョン]

1-1b. bug Issue として起票するとき

不具合を bug Issue として起票するとき（gh issue create --label bug --body … でテンプレートを通らないときも）、本文の末尾に次の「分類」節を置く。 値は決まった語から選ぶ（.github/ISSUE_TEMPLATE/bug_report.md と同じ語。日次メトリクスの bug-flow がこの節を数える）。

## 分類
- 原因の PR: #<番号> / 不明 / なし（以前から）/ 上流（<CLI> <版>）
- 発見経路: uat / review / orchestrate / daily-use / automated
- 影響する経路: chat / terminal / cli / mobile / auto-yes / push / なし（内部）

• 各行は 1 つを選んで書き換える（例: - 原因の PR: #3191、- 原因の PR: 上流（codex 0.50.0）、- 発見経路: uat）。 影響する経路だけは複数を , で区切って書ける（例: - 影響する経路: chat, mobile）。選択肢を残したままの行は「未記入」に数えられる
• 影響する経路は取りこぼしを防ぐ欄。直す人は、挙げた経路すべてを確かめる
• 影響する経路が なし（内部）（テスト・CI・開発用スキル・agent-health・orchestrate）なら、bug に加えて internal ラベルも付ける （gh issue create … --label bug --label internal）

1-2. ディレクトリ構造作成

BUG_ID=$(date +%Y%m%d_%H%M%S)
BASE_DIR="dev-reports/bug-fix/${BUG_ID}"
mkdir -p "$BASE_DIR"

1-3. 調査コンテキストファイル作成

ファイルパス: dev-reports/bug-fix/{bug_id}/investigation-context.json

{
  "issue_description": "不具合の概要",
  "error_logs": ["エラーログ1"],
  "affected_files": ["src/lib/xxx.ts"],
  "reproduction_steps": ["1. xxx", "2. yyy"],
  "environment": {
    "os": "macOS",
    "node_version": "18.x",
    "browser": "Chrome"
  },
  "severity_hint": "high"
}