用途:为跨多个仓库的功能变更创建与跟踪实施计划。当单仓库的 create-plan 不足以覆盖需求时使用,例如共享库更新后需适配各消费方、迁移跨多个服务,或用户明确表示改动涉及多个仓库。若改动可限于单一仓库,应改用 create-plan。
主要能力:在当前仓库生成协调计划(含跨仓库阶段依赖);生成引用协调计划的各仓库阶段文档;排出尊重仓库间依赖的执行顺序;跨所有涉及仓库的全局进度跟踪;提供依赖图与跨仓库验收标准。
使用方式:先确定涉及的仓库、相互关系、作为中心(hub)的仓库及执行顺序;再梳理各仓库对外提供与消费的内容,构建依赖图;按上游提供方、直接消费方、下游消费方、跨仓库集成测试设计阶段,每阶段标注目标仓库并对应一个仓库;将协调计划写入 hub 仓库的 plans/<name>/plan.md,使用协调计划模板;各阶段文档加上 repo、coordinator 等元数据头,便于 resume-plan 检索;在 todo.md 增加跨仓库执行清单,逐阶段切换仓库执行,并确认上游产物已可用(发布包、合并 PR、部署服务);最后向用户确认依赖、顺序、发布门槛与通知对象。
限制:OpenCode 一次只操作一个仓库,跨仓库阶段必须串行、切换仓库执行,不支持并行多仓库执行;协调计划是规划文档而非实时看板,状态需在各仓库运行 update-plan 时更新;跨仓库验收需人工验证;协调计划只存于一个 hub 仓库,若未打开该仓库需记得更新;不要使用内置 explore 子代理。
规则:一个协调者对应多个目标,各仓库阶段回引协调计划;阶段不得早于其上游依赖完成且可用;单阶段不跨多个仓库;沿用既有计划、阶段与实施计划模板,跨仓库仅新增元数据;不仅跟踪完成,还要跟踪产物对其他仓库的可用性。