用途:把 GitHub issue 从实现一路推进到 PR 合并,适合“complete issue #N”“端到端完成该 issue”或全自动 issue-to-merge 请求。
主要能力:串联 $start-issue → codex review → $e2e-verify fix-and-ship 三个阶段。Phase 1 调用 $start-issue 完成取 issue、建 worktree、识别类型、探索、设计、TDD、验证、覆盖率、安全审查、提交推送建 PR、监听 CI;Phase 2 用 codex 对 PR diff 做 LLM 审查并修复有效问题后提交推送;Phase 3 调用 $e2e-verify $PR_NUM fix-and-ship 完成 rebase、构建、处理评审、E2E 浏览器测试、回帖、加 run-full-ci 标签、监听 CI 并调用 $ship 合并。
使用方式:命令为 $complete-issue <issue-number> [--skip-coverage] [--coverage-threshold <n>] [--no-agents]。子代理模型分层由 $start-issue 的 agent prompt frontmatter 控制:Explore 用 Haiku,Spec Review 与 Quality Review 用 Sonnet,Implementer 继承父会话模型;可用 CLAUDE_CODE_SUBAGENT_MODEL=<model> 覆盖全部子代理模型,--no-agents 让 start 阶段不启用子代理。状态写入 .local/state/complete-issue-<N>.loop.local.json,支持按 loop-state.md 的 bootstrap 与 re-entry 恢复阶段。若创建了 worktree,后续阶段必须在 $WORKTREE_PATH 下操作,Bash 命令需加 cd "$WORKTREE_PATH" && 前缀。
限制:codex 不可用或运行失败时不会静默回退,而是按 codex-fallback.md 的 AskUserQuestion 流程让用户选择;完成需同时满足 issue 实现含测试、PR 创建推送、codex 审查完成并处理、E2E 验证完成、结果回帖、CI 通过、PR 合并,全部满足才输出 <done>COMPLETE</done>;15 次以上迭代未成功需记录阻塞并询问用户。