用途:/burndown 把有限目标集内的所有 in-scope bead 驱动到已合并状态后主动停止,是有终点(finish line)的 orchestrator-merge 循环,与无终点的 /evolve、一次性并行的 /crank 相对。
主要能力:每轮循环只做三件事之一——合并一个在途 PR、判定完成、或推进一个 bead。它先对在途工作进行对账(git worktree list / git status),若有未完成编辑则跳过本次触发;若有目标 PR 打开且检查全绿,则更新分支并 gh pr merge <N> --squash --admin,随后停止本次触发(每轮至多一次合并)。完成检查会重新解析目标集,全部关闭/合并即写完成报告并停止。
使用方式: /burndown <epic-id> /burndown <epic-id> --max-cycles=20 /burndown <epic-a> <epic-b> ... /burndown --beads ag-x.1,ag-x.2,ag-x.3 /burndown <epic-id> --dry-run /burndown <epic-id> --hold-merges 目标集为参数对应 epic 子项的传递闭包中尚未关闭的 bead,启动时固定,作为“完成”的定义。无人值守时可借助 CronCreate 会话循环或 ScheduleWakeup 周期性重发同一提示,因每次触发幂等而不会堆叠 PR。
限制与停止条件:目标合并完毕、达到 --max-cycles、操作者覆盖(~/.config/burndown/STOP 或 .agents/burndown/STOP,或 --hold-merges)、或所有剩余 bead 均被依赖/决策阻塞时停止;不得扩大范围或空转。硬约束包括:无 bead 不建 PR、每个 PR 一个纵向切片且先写失败测试、必须用 worktree、绿色 CI 是唯一合并门槛、不得合并红色。相关命令还有 /evolve、/crank、/rpi、/autodev。