CommandMate: Command for Claude Code

UAT修正ループ

概要

受入テスト（UAT）で不合格となったIssueについて、featureブランチでの修正→再PR→再マージ→再UATのサイクルを自動化します。全テストがPASSするか、最大リトライ回数に達するまでループを繰り返します。

使用方法

• /uat-fix-loop [Issue番号1] [Issue番号2] ...
• /uat-fix-loop [Issue番号] --max-retry 5 （最大リトライ回数を指定）

前提条件

• developブランチ上で実行すること
• 直前に /uat が実行済みで、FAILしたテスト項目があること
• FAILしたIssueのfeatureブランチ worktreeが存在すること
• CommandMateサーバーが稼働していること

実行内容

あなたはQAマネージャーとして、UAT不合格項目の修正サイクルを統括します。

パラメータ

• issue_numbers: 修正対象のIssue番号（スペース区切り）
• --max-retry: 最大リトライ回数（デフォルト: 3）

---

Step 0: 初期設定

TodoWriteツールで作業計画を作成：

- [ ] Step 1: UAT結果の分析
- [ ] Step 2: 修正指示の送信
- [ ] Step 3: 修正完了待ち・品質確認
- [ ] Step 4: 再PR・再マージ
- [ ] Step 5: 再UAT
- [ ] Step 6: 結果判定（→ ループ or 完了）

---

Step 1: UAT結果の分析

1-1. 直前のUATレポートを読み込む

各Issueについて、最新のUATレポートからFAIL項目を抽出：

for issue_num in {issue_numbers}; do
  # UATレポートを確認
  ls dev-reports/issue/${issue_num}/uat/
  cat dev-reports/issue/${issue_num}/uat/test-results.json 2>/dev/null
done

1-2. FAIL項目の整理

各FAIL項目について以下を記録：

• テストID: テスト項目の識別子
• テスト項目名: 何をテストしたか
• 期待結果: 何が期待されていたか
• 実際の結果: 何が起きたか
• エビデンス: テスト出力の関連部分

1-3. 修正対象のworktree特定

for issue_num in {issue_numbers}; do
  WT_ID=$(commandmatedev ls --branch "feature/${issue_num}" --quiet)
  echo "Issue #${issue_num} → Worktree: ${WT_ID}"
done

worktreeが見つからない場合はエラー報告して中断。

---

Step 2: 修正指示の送信

各FAILしたIssueのワーカーに修正指示を送信。

2-1. 修正指示メッセージの構築

FAIL項目の情報を具体的に含めた修正指示を構築する：

受入テスト（UAT）で以下のテスト項目がFAILしました。修正してください。

## FAIL項目

### {テストID}: {テスト項目名}
- 期待結果: {期待されていた動作}
- 実際の結果: {実際に起きた動作}
- エビデンス: {テスト出力の関連部分}
- 推定原因: {ログから推定される原因}

## 修正後の確認事項

修正が完了したら、以下を順に実行してください:
1. npm run lint
2. npx tsc --noEmit
3. npm run test:unit
4. 修正内容をコミット
5. git push

2-2. 送信

for each fail_issue:
  commandmatedev send <worktree-id> "{修正指示メッセージ}" \
    --auto-yes --duration 2h

修正指示が並列送信可能な場合（独立したIssueのFAIL）は並列で送信する。

---

Step 3: 修正完了待ち・品質確認

3-1. 完了待機

for each worktree:
  commandmatedev wait <worktree-id> --timeout 7200
  EXIT=$?
  if [ "$EXIT" -eq 10 ]; then
    # プロンプト検出 → 内容確認して応答
    commandmatedev respond <worktree-id> "yes"
    commandmatedev wait <worktree-id> --timeout 7200
  fi