用途:当需要同时推进多个 forge 形态的任务(多个 issue、里程碑、实现计划等)时,先分析任务之间的文件冲突与依赖,再决定顺序与并行方式,最后为每个任务派发一次 forge 运行。
主要能力:分九步执行,由一道审批闸门分隔。第一部分(1—5)为规划:解析调用、将工作来源归一为任务列表、实体化 refs、分析每个任务要改的文件、构建冲突图与分诊矩阵、生成工作树分组与调度波次,并汇总为一份作战计划。第二部分(6—9)为执行:准备工作树、按波次派发(每个任务一个 agent,使用指定的模型层级与 forge 深度)、中继(先证明阻塞任务的改动已在依赖任务基线上再 rebase 并释放)、收尾汇总报告与 PR 列表。
使用方式:以 /blacksmith-orchestrate <work-source> [orchestrator-flags] [forge-flags] 形式调用。工作来源支持 issue ref、里程碑/史诗/标签等容器、plan <path>、引号包裹的自由目标或 resume,可组合。编排器自有标志包括 afk、resume、budget <n>、strict、stack、rescout、max <n>、dry、unified/split、plan <path>;其余 forge 标志原样透传给每次派发。建议在两个以上 issue 引用或大型计划落地时使用。
限制:第 5 步“yes, forge them”批准前不会创建任何工作树、不派发任何运行;automode 可跳过该闸门但不会自动提交、推送或回写 tracker;afk 是唯一允许无人值守提交、PR 与阻塞 PR 合并的例外;终端 PR 与工作树清理始终由用户负责。未识别的标志词会停止并回问用户,不会默默透传。若运行时不支持并行,则退化为按依赖顺序串行执行。单一 issue 或未提供工作来源时不适用。