用途
atelier-orchestrator 是 atelier 技能体系中的入口级编排技能,负责技能路由与工作流编排。它的核心职责是:选择 Inline Plan 或 Spec-backed Plan 两种规划模式,将任务路由到正确的工作流技能,并管理各阶段之间的转换。
该技能确立了一条核心规则:当存在实现选择时,在人类审阅并批准书面计划之前,绝不编写代码。唯一的例外是精确的机械性改动(如拼写错误或单行替换),且前提是不存在需要审阅的实现选择。
主要能力
规划模式选择
Inline Plan(默认):适用于边界清晰、理解充分的工作,包括普通功能、缺陷修复、重构、配置变更和多文件改动。它通过 spec-plan 并显式选择 Inline 模式,在对话中呈现简洁计划,不创建规划产物或跟踪条目,然后停下等待批准。批准即结束 spec-plan 调用。后续显式的实现请求可直接实现该计划,不应为 Inline 工作调用 spec-implement、spec-finish 或 code-subagents。
直接 Inline 实现必须:避免在未获人类明确许可时使用 main/master 分支;保持在已批准的范围和文件内;运行已批准计划中的每一项验证;审查最终 diff 是否有意外改动;未经人类明确指示不得提交、推送或开启 PR。
Spec-backed Plan:当至少存在一个具体信号时使用,例如:人类明确要求规格或持久化规划产物;需求或边界需要在规划前进行探索;工作实质性改变架构、公共契约、数据模型或跨系统行为;多个相互依赖的子系统需要分解和依赖跟踪;计划必须跨对话存续以支持交接、审计或多人协作。该模式经由 spec-brainstorm 路由,产出 design.md(来自 spec-brainstorm,含需求、研究与架构)和 plan.json(来自 spec-plan,含任务与依赖)。每个技能只产出其声明的输出并停止,人类通过单独请求启动下一阶段。
技能路由
- atelier-orchestrator → 选择并宣布规划模式
- spec-brainstorm → Spec-backed 探索 + 设计 → 仅 design.md → 停止
- spec-plan → Inline 对话或仅 plan.json → 停止
- spec-implement → 执行已批准的 Spec-backed 计划;跟踪任务
- spec-finish → Spec-backed 计划的实现后验证
- code-subagents → Spec-backed 计划任务的并行分派
硬性转换
- spec-brainstorm 完成后:停止,等待单独的 spec-plan 请求
- 已批准的 Inline Plan 后:停止,等待单独的实现请求
- 已批准的 Spec-backed Plan 后:停止,等待单独的 spec-implement 请求
- spec-implement 后:进入 spec-finish
spec-brainstorm 和 spec-plan 在其调用内是终态的,不得链入下一个工作流技能,即使原始请求要求一次完成多个阶段。
迭代回退模式
工作流并非纯线性,预期会出现回退:研究→研究(发现循环);计划→研究(设计缺陷);实现→计划(实质性变更);实现→研究(根本性问题);完成→实现(发现缺陷)。若同一问题循环 2 次以上,应停下询问人类是否重新考虑方案。
委派
当只读工作会淹没主上下文时,可委派给子代理,例如广泛的代码库研究、查找可比代码或独立审查。要求提供简洁、带 file:line 引用的摘要,并在决策前自行阅读关键引用文件。不得指定具体代理名称,由 harness 根据代理描述选择。不得委派与人类的访谈或设计对话、少量文件查找、有状态调试与实现循环。
技能类型
- 流程技能(spec-brainstorm、spec-plan、spec-implement、spec-finish):严格遵循,不得为规避纪律而改编。
- 知识技能(oracle-grill-me、oracle-domain-modelling):根据上下文调整原则,在工作流内为决策提供信息。
- 纪律技能(oracle-debug):必须严格遵循的方法论,不得绕过根因调查。
流程技能优先。知识技能在需要时由流程技能调用。
使用方式
该技能作为编排入口,在任务开始时调用以选择规划模式并宣布选择(附一句简短理由,允许人类覆盖)。随后按路由表进入相应工作流技能。用户指令如“添加 X”或“修复 Y”不意味着跳过工作流——指令说明做什么(WHAT),技能定义怎么做(HOW)。
适用场景
适用于需要规范化 AI 辅助开发流程的场景,尤其是希望强制“先计划、后批准、再实现”纪律的团队或个人。既覆盖普通有界工作(Inline Plan),也覆盖需要持久化规格、跨系统变更或多人协作的实质性工作(Spec-backed Plan)。
限制
该技能本身不实现代码,只做路由与编排。它依赖 atelier 技能集中的其他技能(spec-brainstorm、spec-plan、spec-implement、spec-finish、code-subagents 等)协同工作。具体安装命令、平台支持、收费与价格信息在提供的资料中暂未提供。