SuperAPI AI 工具集

atelier-check

智能体与模型

查看项目

更新于 10-15 09:28

技能介绍

atelier-check 是 atelier 运行流程中的检查者(checker)子技能,职责是核验一个单元是否真正满足其验收标准,就地修复小型局部缺陷,并诊断剩余失败,以便编排器决定下一步。它不自行升级、不重做整个单元、不改写计划;这些决策与循环计数由编排器掌握。

用途

该技能被派发时,会被告知工作目录、单元 ID 以及检查原因——要么是某个门禁失败,要么是需要判断的断言性标准。它只在确实需要判断时被派发;可运行的门禁已由编排器执行,因此不应浪费 token 重复验证已通过的内容。

主要能力

1. 核验(仅针对检查原因所需范围)

读取 <working-dir>/briefs/<UNIT-ID>.md(以及 CONTRACT.md 的相关片段),然后按被调用的原因限定阅读范围:

  • 门禁失败:阅读失败测试的输出及其所经过的代码路径进行诊断,无需阅读整个模块,顺着失败追踪即可,并自行重新运行失败命令确认。
  • 断言性标准:阅读产出的工件并判断这些标准(文字质量、引用、规范、设计),引用具体证据。跳过已通过门禁的代码,那不是本次要判断的内容。

不要轻信执行器对正在判断维度的自我报告,要自行核验;但不要重新推导已通过的门禁——运行测试是编排器的低成本工作,不是检查者的。在相关处确认单元遵守了契约的跨单元形状/命名;不要审计不在问题范围内的单元内部细节。

2. 诊断

将单元归入且仅归入以下一类:

  • pass:所有标准均满足且契约得到遵守。
  • local:存在小型、局部缺陷;简报本身合理,少量编辑即可修复。
  • execution:单元实质性错误,但简报本身合理。
  • brief:标准按所写无法达成,或简报/契约错误、含糊或自相矛盾。

3. 外科式修复(仅限 local)

当且仅当诊断为 local 时,自行尝试一次外科式修复:

  1. 记录当前通过的标准(作为回归基线)。
  2. 做最小化的就地编辑以修复失败标准。修复,而不是重新生成单元。
  3. 重新运行该单元的所有标准。
  4. 回归防护:若第 1 步中通过的任何标准现在失败,说明修复引入了回归——撤销编辑并报告 diagnosis: execution(编排器将路由到新的执行器重做)。绝不接受以一个新失败换取另一个失败的修复。
  5. 若所有标准现在通过,报告 diagnosis: pass。

对于 execution 或 brief,不要编辑,只报告。这些层级由编排器派发。

4. 报告结构化裁决(最终消息)

输出格式如下:

unit: <UNIT-ID>
criteria:
  - id: <c1>  pass: true|false   evidence: "<command output / what you checked>"
  - id: <c2>  pass: true|false   evidence: "..."
overall: pass|fail
diagnosis: pass|local|execution|brief
recommended_tier: 0|1|2|3        # 0 none, 1 surgical (done by you), 2 redo, 3 replan
surgical_attempted: true|false
notes: "<for execution: what went wrong, corrective guidance for the redo>
        <for brief: which decision is missing/wrong in the contract or brief>"

notes 字段在升级时至关重要:对 execution,它成为交给新执行器的纠正指导;对 brief,它告诉架构师具体需要修复哪个跨单元决策。要具体并引用证据。

使用方式

该技能由 atelier 编排器在需要判断时派发,调用时会提供工作目录、单元 ID 和检查原因。检查者按上述流程核验、诊断、必要时修复并返回结构化裁决。

适用场景

适用于 atelier 工作流中对单个已完成单元进行验收核验、局部缺陷修复与失败诊断的场景。

限制

  • 不自行升级处理,不重做整个单元,不改写计划。
  • 仅在需要判断时被派发,不重复验证已通过的可运行门禁。
  • 外科式修复仅限诊断为 local 的情况,且只尝试一次。
  • 对 execution 或 brief 不进行编辑,只报告。
  • 若修复引入回归,必须撤销并报告 execution。

关于该技能的收费、价格、平台支持等信息,资料中暂未提供。