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

入力

• $ARGUMENTS : 対象のバグIssue番号
  • 例: #123 または 123

🎯 目的

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

GitHub連携の前提

必要な権限

以下の gh コマンドが実行可能であること：

• gh issue view / gh issue comment
• gh pr create / gh pr view

前提ポリシー（安全運用）

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

実行手順

1. Issue内容を取得

gh issue view {ISSUE_NUMBER} --json title,body,labels

以下を抽出：

• 問題の概要 / 再現手順 / 期待する動作（理想状態） / ギャップ
• 修正策（候補一覧）（仮説ごとの案）
• 参考資料（出典）

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

通常モード（単一修正）:

git checkout -b fix/{ISSUE_NUMBER}-{short-description}

並行モード（git worktree）: 複数のバグ修正を同時に進める場合は worktree を使用:

# 親ディレクトリにworktreeを作成
git worktree add ../$(basename $(pwd))-fix-{ISSUE_NUMBER} -b 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に）

gh issue comment {ISSUE_NUMBER} --body "🚀 修正着手

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

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

4. 修正案の逐次実行ループ

各案ごとに以下を行う：

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

b. 検証

pnpm lint --fix && pnpm type-check
pnpm test

再現手順・自動テスト・メトリクスで効果判定

UI関連のバグの場合（Agent Browser利用可能時）:

# 再現手順を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作成

gh pr create \
  --title "fix: {問題の要約}" \
  --body "$(cat <<'EOF'
## Summary
- {修正内容の要約}

## Related Issue
Fixes #{ISSUE_NUMBER}

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

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

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

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

6. Issueに完了コメント

gh issue comment {ISSUE_NUMBER} --body "✅ 修正完了

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

## Pull Request
{PR_URL}

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

出力（GitHub）

• Pull Request: Fixes #{ISSUE_NUMBER} でIssueに紐づけ
• Issueコメント: 修正完了報告とPRリンク
• Issue: PRマージ時に自動close

効果判定ガイド

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

品質チェックリスト

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

自己評価

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