用途
orchestrate 用于推进 Ticket 存储中已就绪的 Ticket,或围绕明确指派的项目成果开展调查与交付。一次队列调用始终是有限的队列任务;常设委托与 --autonomous 不会把它变成项目运营。Ticket 是项目存储中自足的工作包;effort 是一组有名字的 Ticket,具有一个目的地和一个前端条目(effort 的前端文件:跟踪条目的正文,或文件存储中的 effort README)。每次运行是某个 Ticket 上的一次 run-ticket 尝试,在自己的会话中进行。该技能负责规划、启动、落地,并通过定期汇报保持相关人员知情。
主要能力
- 解析存储并读取前端条目:目的地、优先级覆盖、暂停行(Paused:)与状态页链接(Status page:)。
- 读取项目 North Star 中每个策略路标及其指定来源;路标已满足只是重新考虑选择的证据,不是修改选择的授权。
- 对范围内每个 Ticket 完整读取并分类:单独搁置、运行中、待落地、已回答、待恢复、就绪;每个 Ticket 只落入第一个满足条件的分组。
- 规划冲突:可能触及同一代码的 Ticket 依次运行,后一个在前一个落地后开始;与运行中 Ticket 冲突的候选需等待其落地。
- 按延迟损失规则排序(先恢复,再就绪工作),并跨 effort 依据 North Star 的目标与衡量标准进行权衡。
- 启动运行:重新读取 Ticket、认领并写入启动事实(新 run ID、开始时间、会话、启动次数),然后以独立会话调用 run-ticket。
- 处理失败:主机无法启动会话,或会话在写入结果前结束/超时;连续三次启动失败或落地修复使启动次数超过三次时,升级给人员。
- 接管其他编排器超时后的运行。
- 汇报检查:运行或落地轮次结束时,或每十分钟;重新读取 Ticket、遵守暂停行、授予落地轮次、收集债务、重建并发布状态页。
- 债务收集:将已完成落地但完成记录未标明债务已收集的债务项,对照当前代码核查、按领域分组,并通过 ticket-up 写成 Ticket。
- 债务热点:某领域债务来自三个或更多运行时,向人员提议结构性重构(除非当前指派与委托已覆盖该方向)。
使用方式
参数:
<effort>:要处理的 effort;未指定时为整个存储,即所有含未关闭 Ticket 的 effort。- 成果指派:调用方指派的项目成果,两种交互模式下均可,由 references/OUTCOME.md 管辖。
--autonomous:在指派的范围内继续规划与执行,不逐次请求批准计划;保留的决策仍会等待。未加此参数时,提出每个计划并等待批准。--max-batch <n>:同时可运行的数量;未设置时为 10,设为 none 则取消限制。--type <type>[,<type>...]:仅处理携带指定 Ticket 类型的 Ticket;无类型的 Ticket 永不匹配。
加载的参考文档:始终在读取存储前加载 TICKET_CONVENTION.md(场地参考)与 AUTOMATED_EXECUTION.md;调用方指派项目成果时加载 OUTCOME.md;默认加载 PROPOSE_AND_WAIT.md;使用 --autonomous 时加载 AUTONOMOUS.md;每次检查时加载 STATUS_PAGE.md。
启动流程:解析存储(读取 tickets/store-config.md 或项目上下文文件指定的位置),解析自动化身份与人工升级接收者;若本会话无法以该身份写入,说明存储配置所需的账号并在任何启动前停止。读取前端条目与策略路标,读取场地限制(文件存储不支持并行运行,一次一个 Ticket;代码托管需读取目标分支是否要求最新分支或合并队列)。获取编排器 ID(如开始时间加短随机后缀)。完整读取范围内每个 Ticket 并分类。随后按冲突规则写计划,再按模式参考执行启动。
适用场景
- 需要并行推进多个就绪 Ticket,且各 Ticket 在独立会话中运行。
- 需要围绕指派的项目成果进行调查与交付,并保持持久协调记录。
- 需要定期汇报、状态页发布、落地合并轮次与债务收集的编排工作流。
限制
- 文件存储不支持并行运行,一次一个 Ticket。
- 队列调用不授权策略修订;常设委托和 --autonomous 不会把队列调用变成项目运营。
- 非 Ticket 的场地条目不会被当作可执行工作处理;指定来源消息仅作为观察读取。
- 目标分支既不要求最新分支也不要求合并队列时,两个编排器在其上落地存在最后检查与合并之间数秒的竞争,要求二者之一可消除该竞争。
- 人员写入的 Paused: 行在该人员移除前一直有效;一旦该处无运行,停止处理该 effort 并说明。
- 启动、落地、恢复等具体失败处理与升级规则以自动化执行参考为准;本介绍未展开的细节以原始参考资料为准。