用途:在 QA 验证通过后,将故事分支的 GitHub PR 以 squash 方式合并到 main,并清理远程分支、本地分支和本地 worktree,适合由 QA 完成流程自动调用。
用法:/wt:merge-pr {STORY_ID} 或 /wt:merge-pr {STORY_ID} {PR_NUMBER}。STORY_ID 必填,PR_NUMBER 可选,缺省时通过 gh 从分支名发现。
主要步骤:查找故事分支的开放 PR(gh pr list --head story/{STORY_ID} --state open --json number);检查可合并性(gh pr view {PR_NUMBER} --json mergeable,state);执行 squash 合并并删除远程分支(gh pr merge {PR_NUMBER} --squash --delete-branch);移除本地 worktree(git worktree remove tree/story/{STORY_ID},失败时用 --force 重试);删除本地分支(git branch -D story/{STORY_ID});清理 worktree 元数据(git worktree prune);同步本地 main(git pull origin main)。
输出:完成后报告 PR MERGED AND CLEANED UP 或 WORKTREE CLEANED UP (NO PR),包含 story_id、pr_number、merge_strategy、branch_deleted、worktree_removed,便于编排器解析。
限制:所有步骤均为非阻塞,任一步失败不影响后续步骤;未找到开放 PR 时跳过合并但仍清理 worktree;gh CLI 未安装或未认证时跳过 PR 合并;本地 main 同步失败不阻塞。需安装并认证 gh CLI 才能执行 PR 操作。