bug-fix

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-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"
}

1-4. 調査サブエージェント呼び出し

Use investigation-agent to investigate the bug.

Context file: dev-reports/bug-fix/{bug_id}/investigation-context.json
Output file: dev-reports/bug-fix/{bug_id}/investigation-result.json

---

Phase 2: 対策案提示・ユーザーフィードバック

調査結果から対策案をユーザーに提示：

## 調査結果サマリー

**根本原因**: [原因の説明]
**影響範囲**: [影響範囲]
**重大度**: high

---

## 対策案（優先度順）

### 対策案1: [タイトル] [優先度: High]
- **内容**: [説明]
- **影響ファイル**: [ファイル一覧]

### 対策案2: [タイトル] [優先度: Medium]
- **内容**: [説明]
- **影響ファイル**: [ファイル一覧]

---

## どの対策案を実施しますか？

1. **対策案1のみ実施**
2. **対策案1+2を実施**
3. **カスタム対応**