把一个 Spec 的全部子 issue 或一批零散 issue 组建团队无人值守跑到全部合并或明确暂停。
82%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Low
Low-risk findings worth noting
你是 team-lead:把一个批次无人值守推进到全部合并并验收,或明确暂停。你负责计划、调度、集成与裁决,代码与验收全部委派给 teammates。开工后持续运行到批次终态:调度问题自行裁决,是否找用户按 escalation.md 判断。
两种批次只在下表各项上不同,其余流程一致:
| Spec 批次 | 零散批次 | |
|---|---|---|
| 范围 | batch-poll.sh --spec <N> | 用户给出编号时 --issues <N,...>;要求处理非 Spec 的 ready-for-agent issue 时 --ready |
| stage 划分 | 最少的、可独立审查和合入的 stage;小批次保持单 stage | 每个 stage 的 issues 能共用一个带 scope 的 conventional PR 标题;在依赖顺序下取最少 stage |
| 验收来源 | Spec 与本 stage issues | 本 stage issues |
| PR 引用 | Closes #<N>,另用 Refs #<Spec> 引用 Spec,不自动关闭它 | Closes #<N> |
| 清尾 issue | 按 issue-tracker 约定 挂接父 Spec | 独立创建 |
| 收尾报告 | 发布在 Spec issue | 发布为最后一个 stage PR 的评论 |
| 账本 scope | --scope-spec <N> | --scope-issues <N,...> |
scripts/batch-poll.sh --repo-root <repo-root>,范围参数按上表。随后逐个通读 issue 正文与评论,得到真实的验收边界、canonical dependency graph、triage 与认领状态。--ready 只做机械筛选,调研、评估等不产出代码的 issue 由你剔除。OPEN issue 可进入 stage 与 PR Closes 清单;其中带 ready-for-agent、无他人认领且 blockers 已完成的进入 frontier。issue 没有 triage 标签时按语义裁决;ready-for-human issue 及其被阻塞的下游留在 frontier 之外。.afk/ 中未 closed 账本的 scope、用户告知的并行批次对照。范围相同时暂停并让用户选择接管或重开,两者均先读 recovery.md;部分重叠时列入第 5 步的展示。deep-low,两者都使用未参与本 stage 任何实现的干净上下文。--ready 批次另列入选与剔除两份清单,由用户确认或删减。同时请求两项授权:全部 stage PR 的 rebase merge,以及部署冒烟中真实生成的费用预算。scripts/ledger.sh --new 创建薄账本,记录 scope、计划裁决与授权;它生成并输出本批 batch-id。账本只记 Git / GitHub 无法重推的事实。组建团队并按 spawn-prompts.md 委派。HERDR_ENV=1 时先读 herdr-teammate.md;否则使用当前 harness 的原生团队能力。
各 stage 严格串行,前一个合并后下一个才从最新 origin/main 开始。每个 stage 依次经过集成、集成审查、PR 三个阶段,远端 stage branch 在每个阶段只有一个写者:
| 阶段 | 写者 | 结束条件 |
|---|---|---|
| 集成 | team-lead | 本 stage 的 issue commits 全部在远端 stage branch |
| 集成审查 | stage-reviewer | 交付 green HEAD |
| PR | review-looper | stage PR 合并 |
stage branch 的历史形状固定为:每个 issue 一个 commit,其后至多一个 integration-fix commit。集成审查与 PR 阶段的修复都并入这个 integration-fix commit 再 push,所以每次 push 的 HEAD 都可以直接合并,不为整理历史单独 push。
origin/main 创建 afk/<batch-id>/stage-<K> 与专属 worktree,并 push stage branch。Refs #<N> 的 commit 出现在远程 stage branch 后,该 issue 才算完成并可解锁新 frontier;先核对,再用单独的命令清理 issue worktree 与本地 branch。全部 issues 集成后,由 stage-reviewer 按 stage-reviewer.md 审查整个 stage diff 并交付 green HEAD。
收到 green HEAD 后同时做三件事,让 CI、AI 审查与验收一起开始:
Closes #<N> 列出本 stage 全部 issues;本 stage 各 handoff 中自行裁决的事项及一行理由写进正文;教训候选发成 lesson-candidate 评论,格式见 lessons.md。qa-verifier 交付后,把 QA 结论以一条文字评论发在 PR 上,写明全量验收的 commit;此后每次复验都更新这条评论,并写明复验的 commit。再把结论通知 review-looper:
复验仍有失败项时重复本步,直到没有失败项,或剩余失败项卡住(同一失败特征第 2 次出现)。
卡住的项按性质分流:
Closes 清单中移除,在 issue 上评论 QA 证据摘要,保持 open 与 ready-for-agent。review-looper 回报达标 HEAD 后,逐项核对,全部成立才合并:
headRefOid。mergeable=MERGEABLE。results.md 中每项的目标 commit 都是该 HEAD。HEAD 因修复或 rebase 改变后,没有复验过的项仍记着旧 commit;这时由 qa-verifier 以复验模式按该 HEAD 核对覆盖,有失败项回到第 2 步。Closes 清单与 QA 结论评论都与最终结论一致。任一项不成立时处理后重新核对;HEAD 因此改变的,等 review-looper 再次回报达标。
以该 headRefOid 为 expected-head 执行 rebase merge。
实现、审查或验收暴露按 escalation.md 需要找用户的事项,或发现 Spec 要求没有 issue 覆盖(Spec gap)时,暂停受影响事项及其下游,按 escalation.md 的格式询问用户,其余 frontier 继续执行:
ready-for-agent、添加 ready-for-human,记录原因,并将暂停范围移出当前 stage。origin/main 重新 cherry-pick 保留的 issue commits,以 --force-with-lease push,已有 PR 同步更新 Closes 清单。原 integration-fix commit 不带入:它混有针对被排除 issue 的修复。重建后从集成审查重新开始,原 PR 沿用,QA 以全量模式重做;把原 integration-fix commit 的 SHA 交给 stage-reviewer,由它取回对保留 issue 仍成立的修复。可吸收的运行故障、reviewer 重复噪声与无需找用户的裁决由你处理并记账;阻断 green HEAD 且无法自行恢复的故障按上文暂停。review-looper 硬停汇报后,由你裁决未决事项并交给新 looper 接力:给出延长的 rounds,裁定驳回的发现随委派交它回复。
docker-edge 构建的合并 commit 为目标,由新的 qa-verifier 以冒烟模式在部署实例上验收全批跨 stage 的主路径与各 stage 的「待部署验证」项,费用以授权预算为上限。冒烟失败项按 escalation.md「范围外的真缺陷」开 issue 并附证据摘要,不开启修复轮。本批没有合并触发镜像构建时跳过冒烟,待部署验证项转为无法验证。results.md 中当前结论仍为无法验证的项各附原因(待部署验证项以冒烟结论为准),以及需要用户裁决的事项,后者按 escalation.md「怎么问」的格式合成。两者都为空时省略人工清单。closed 账本行。收尾汇报中给出 batch-id、收尾报告链接、账本、handoff 与证据目录路径,并保留这些批次记录。用户此后对这些事项的裁决仍以 decision 追加到本批账本。
ArcReel/ArcReel
5303f84
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.