SuperAPI AI 工具集

atelier-execute

智能体与模型

查看项目

更新于 10-15 09:28

技能介绍

atelier-execute 是 atelier 运行流程中的一个执行器子技能,用于完成单个工作单元。它的定位是:执行者只做一件工作,并且做得很好,依据是一份已经包含所有必要决策的工作简报。执行者不应重新设计任务,因为架构师已经替其完成了跨单元决策。

使用方式

执行者会被告知工作目录(docs/atelier/<task-slug>/)和单元编号(例如 UNIT-002)。

执行步骤

第一步,按顺序读取输入:

  1. <working-dir>/CONTRACT.md —— 每个单元都必须遵守的共享规则。
  2. <working-dir>/briefs/<UNIT-ID>.md —— 该单元的具体简报。
  3. 简报中指定的任何输入文件或先前单元的输出。

第二步,遵守契约。CONTRACT.md 中的约定、接口、命名和归属具有约束力。使用它固定的确切形状和名称,因为其他单元依赖它们。不要修改其他单元拥有的文件。

第三步,按照分解模式执行简报中的方法。分解模式在契约或简报中说明,包括三种:

  • partition:编写自己的片段或文件,不要触碰其他单元的输出。
  • relay:继续一个共享产物。读取其当前状态(简报会指明),然后追加或扩展自己的段落,匹配已确立的语气,并准确从上次中断处继续。保留已有内容,添加下一段。
  • layered:对整个共享产物应用一遍处理(例如连续性编辑、润色)。仅针对该遍次的职责进行就地修订,不要整体重写或更改该遍次职责之外的内容。

单元内部的普通选择由执行者自行决定,简报有意将这些留给执行者。如果简报确实含糊不清或与契约矛盾,不要对跨单元事项进行猜测,而应在报告中注明,检查器(checker)会进行路由。

第四步,对照验收标准自检。在报告之前,逐条检查简报中的验收标准。运行任何标记为可运行的准则(命令或测试)并观察结果。确认每条断言性准则。

第五步,报告。最终消息即返回值,不是面向人类的。返回一份紧凑报告,包含:

  • unit:单元编号
  • outputs:创建或修改的文件,或所生成产物的位置
  • criteria:每条准则的通过或失败状态及证据(命令输出或验证内容)
  • blocked:无,或描述任何跨单元歧义或缺失输入
  • notes:检查器应知道的任何事项

对失败的准则要诚实,因为检查器会独立验证,隐藏的失败会浪费整个修复周期。报告实际观察到的内容,而不是意图。

适用场景

适用于 atelier 工作流中需要按简报执行单个工作单元的场景,尤其是存在跨单元契约、需要按 partition、relay 或 layered 模式协作产出共享产物的情况。

限制

执行者不应重新设计任务,不应修改其他单元拥有的文件,不应在跨单元事项上猜测。简报含糊或与契约矛盾时,应记录而非自行决定。关于该技能的收费、价格、平台支持等具体信息,资料中暂未提供。