# Bug Fix

> バグ修正をブランチ作成からPR作成まで実行する。恒久対応を段階的に実施し、無効時のロールバック手順も含める。修正の実装とPR化で使う。

- Skill: `mae616/bug-fix` (Agent Skill)
- Install (CLI): `npx get-skill add mae616/bug-fix`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mae616/bug-fix/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: mae616 (https://skillmd.com/u/mae616)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/mae616/bug-fix

---


# [バグ対応] 4. 修正実行を恒久対応・段階実施＋無効時ロールバックでする (引数:Issue番号)

## 入力
- `$ARGUMENTS` : 対象のバグIssue番号
  - 例: `#123` または `123`

---

## 🎯 目的
- `$ARGUMENTS` のIssueに記載された **「修正策（候補一覧）」** を上から順に実行する
- **恒久対応のみ** を実施（暫定対応はスキップ、または恒久案に置換）
- 各修正の効果を検証し、**効果なしの場合は修正前の状態へロールバック**
- 修正完了後は **Pull Request** を作成し、`Closes #{ISSUE_NUMBER}` でIssueに紐づける
- マージ時にIssueが自動closeされる

---

## GitHub連携の前提

### 必要な権限
以下の `gh` コマンドが実行可能であること：
- `gh issue view` / `gh issue comment`
- `gh pr create` / `gh pr view`

---

## 前提ポリシー（安全運用）
- **安全第一**：本番影響のある操作は別環境で実施、シークレット露出禁止、最小権限
- **検証必須**：修正ごとに再現テスト／自動テスト／メトリクスで効果判定
- **可逆性**：修正ごとにコミットを分離、**無効時は即 `git revert`**
- **恒久性**：一時ファイル削除やタイミング依存などの **暫定策は採用しない**

---

## 実行手順

### 1. Issue内容を取得
```bash
gh issue view {ISSUE_NUMBER} --json title,body,labels
```
以下を抽出：
- 問題の概要 / 再現手順 / 期待する動作（理想状態） / ギャップ
- **修正策（候補一覧）**（仮説ごとの案）
- 参考資料（出典）

### 2. 作業ブランチ作成（通常 or worktree）

> **ブランチ命名**: `.claude/rules/git.md` に従う。
> - Sprint統合後のバグ → `feature_fix/{short-description}`（base: sprint/*）
> - 本番緊急バグ → `hotfix/{short-description}`（base: main）
> - Sprint外のバグ → `feature_fix/{ISSUE_NUMBER}-{short-description}`（base: sprint/* or main）

**ベースブランチの決定:**
```bash
# sprint/* ブランチの存在を確認
SPRINT_BRANCH=$(git branch -r --list 'origin/sprint/*' --sort=-committerdate | head -1 | xargs)
if [ -z "$SPRINT_BRANCH" ]; then
  BASE_BRANCH="main"
else
  BASE_BRANCH="${SPRINT_BRANCH#origin/}"
fi
git switch "$BASE_BRANCH" && git pull
```

**通常モード（単一修正）:**
```bash
git checkout -b feature_fix/{ISSUE_NUMBER}-{short-description}
```

**並行モード（git worktree）:**
複数のバグ修正を同時に進める場合は worktree を使用:
```bash
# 親ディレクトリにworktreeを作成
git worktree add ../$(basename $(pwd))-fix-{ISSUE_NUMBER} -b feature_fix/{ISSUE_NUMBER}-{short-description}

# worktreeに移動して作業
cd ../$(basename $(pwd))-fix-{ISSUE_NUMBER}
```

> **Tips**: 別ターミナルで別のClaude Codeセッションを起動し、異なるworktreeで並行作業が可能。
> 完了後は `git worktree remove ../project-fix-{ISSUE_NUMBER}` で削除。

### 3. 着手コメント（Issueに）
```bash
gh issue comment {ISSUE_NUMBER} --body "🚀 修正着手

ブランチ: \`feature_fix/{ISSUE_NUMBER}-{short-description}\`

## 実行計画
- [ ] 修正案1を適用
- [ ] 検証（テスト実行）
- [ ] 効果確認
"
```

### 4. 修正案の逐次実行ループ
各案ごとに以下を行う：

a. **変更を最小コミットで適用**（1案＝1コミット）

b. **検証**
```bash
pnpm lint --fix && pnpm type-check
pnpm test
```
再現手順・自動テスト・メトリクスで効果判定

**UI関連のバグの場合（Agent Browser利用可能時）:**
```bash
# 再現手順をAgent Browserで実行して修正確認
agent-browser open http://localhost:3000/{再現パス}
agent-browser snapshot -i
# 問題が発生していた操作を再現
agent-browser click @{ref}
agent-browser fill @{ref} "{入力値}"
# 修正後の期待動作を確認
```

c. **判定**
- **効果あり** → コミットを保持、次のステップへ
- **効果なし** → `git revert` でロールバック、次の修正案へ

### 5. PR作成

> **base先**: `.claude/rules/git.md` に従う。sprint/* があれば sprint/* へ、なければ main へ。

```bash
# base先を動的に決定（ステップ2で取得済みの $BASE_BRANCH を使用）
gh pr create \
  --base "$BASE_BRANCH" \
  --title "fix: {問題の要約}" \
  --body "$(cat <<'EOF'
## Summary
- {修正内容の要約}

## Related Issue
Closes #{ISSUE_NUMBER}

## Changes
- {変更点1}
- {変更点2}

## Test Plan
- [ ] 再現手順で問題が解消されることを確認
- [ ] 既存テストがパスすることを確認
- [ ] {追加の検証項目}

## Rollback
問題があれば `git revert` で戻せます

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"
```

### 6. Issueに完了コメント
```bash
gh issue comment {ISSUE_NUMBER} --body "✅ 修正完了

## 結果サマリ
- **採用した修正案**: {修正案名}
- **検証結果**: lint/type/test すべてPASS

## Pull Request
{PR_URL}

マージ後、このIssueは自動でcloseされます。
"
```

---

## 出力（GitHub）
- **Pull Request**: `Closes #{ISSUE_NUMBER}` でIssueに紐づけ
- **Issueコメント**: 修正完了報告とPRリンク
- **Issue**: PRマージ時に自動close

---

## 効果判定ガイド
- **成功基準**（例）：
  - 再現手順で **失敗が再現しない**／エラーログが消失
  - 該当ユニット/E2Eテストが **安定合格**（n回連続）
  - 関連メトリクス（エラーレート/レイテンシ/メモリ等）が **閾値内**
- **失敗基準**：
  - 事象が継続／別の回帰を誘発／メトリクス悪化／副作用が許容外

---

## 品質チェックリスト
- [ ] 各修正案を **個別コミット** で適用し、可逆性を担保している
- [ ] **検証条件**（再現ケース・成功基準・メトリクス）が明確
- [ ] 効果なしの修正は **即ロールバック**
- [ ] 暫定対応を避け、**恒久対応のみ** 実施している
- [ ] **PRが作成され、Issueに紐づいている**（`Closes #...`）
- [ ] Issueに完了コメントを投稿済み

---

## 自己評価
- **成功自信度**: (1-10)
- **一言理由**: {短く理由を記載。例: 「再現テストで5回連続合格・関連メトリクスも安定」}

