SuperAPI AI 工具集

atelier-dispatch

智能体与模型

查看项目

更新于 10-15 09:28

技能介绍

atelier-dispatch — 写 JSONL、派发、验证(精简架构)

这是基于 speed-run / local_code_gen 底层重建的 atelier:LLM 编写规格说明,确定性脚本执行每个冲刺的模型调用。它之所以存在,是因为子代理版本被编排器成本主导——每个子代理携带 40k 的 harness 上下文,其报告又回到编排器上下文中,之后每轮都会被重新读取(实测:3 冲刺任务产生 1.2M 缓存读取,花费 $1.86)。本架构同时避免了这两点:裸调用(每次 $0.02–0.05),输出写入磁盘而非进入你的上下文。

为什么便宜(两项修正)

裸调用。每个冲刺运行 claude -p "<prompt>" --model {haiku|sonnet} --bare —— --bare 会剥离 hooks/plugins/system-prompt,因此一次 Haiku 冲刺调用约为 $0.002–0.05,而不是约 $0.05 加 40k harness。使用你的订阅 OAuth——无需 API key。

你从不摄取输出。脚本将文件写入磁盘并返回 manifest.json。你读取 manifest(很小),而不是生成的代码。没有上下文累积,没有重读税。

你的流程(你是架构师;保持你自己的轮次和上下文精简)

框定——阅读规格 / 探索上下文。选择一个 <slug>;在干净目录中工作。

编写 contract.md——仅跨冲刺表面(共享接口/接缝、约定、所有权、依赖图)。精简——只固定跨越边界的内容,内部实现信任执行器(Haiku 很强;这不是为本地模型做逐字节固定)。

编写 sprints.jsonl——每行一个 JSON 对象:

{"id":"SPRINT-001","tier":"haiku","kind":"generate","deps":[],"brief":"...简洁简报 + 验收标准..."}

tier:generate 冲刺始终在 Haiku 上运行(脚本强制)——代码生成从不升级。如果某个单元对 Haiku 来说太难,就把它拆成更小的冲刺;不要寻求更强的执行器。Sonnet 仅用于规划和修复循环。

kind:generate(模型输出 <FILE path="...">...</FILE> 块 → 脚本写入它们)或 brief(模型输出 markdown → 保存到 briefs/<id>.md)。

deps:必须先完成的冲刺 id(脚本按依赖波次运行,同一波次内并行)。

对于拆分规划阶段,先输出 kind:"brief" 冲刺(tier sonnet)来编写简报,然后输出消费它们的 kind:"generate" 冲刺(tier haiku)。对于小任务,直接在此内联编写简报并跳过简报阶段。

派发——通过 Bash 运行脚本一次:

python3 <this-skill-dir>/dispatch.py

它循环冲刺,进行裸调用(依赖波次内并行),将文件写入磁盘,并输出 manifest.json 和一行成本。不要将生成的文件读入你的上下文——读取 manifest.json。

验证(门禁)——自己用 Bash 运行任务的门禁(node --test、pytest、CLI 冒烟测试)。这是独立检查;便宜,无需模型。

外科手术式修复循环——对于每个失败,只读取失败的测试 + 相关代码,诊断(代码 bug 还是执行器自己的坏测试),并就地修复——或者重新派发那一个冲刺,在其简报后附加纠正说明。重新运行门禁。限制它:几次修复后,上报给人类。

报告——构建了什么、门禁结果和总成本(你的编排器会话 /status + manifest.json 的 dispatch_cost_usd)。

已验证(任务 01,wordfreq,3 冲刺)

派发层成本 $0.078(3 次 Haiku 裸调用),一次性 18/19 测试通过,一次外科手术式修复后 19/19——而子代理 atelier 同一任务花费 $1.86。那一次失败是执行器编写的测试与 contract 的分词器相矛盾(在“按非字母分割”下 word0 折叠为 word)——被门禁捕获,一次编辑修复。这就是循环按设计工作。

规则 / 注意事项

执行器输出文本,而非工具使用。--bare 剥离工具;模型输出 <FILE> 块,脚本写入它们。不要期望冲刺调用运行测试或读取文件——那是编排器在门禁处的职责。

在新环境中确认一次模型路由:claude -p "hi" --model haiku --bare --output-format json 应花费约 $0.002(Haiku 费率),而不是约 $0.05+(回退到更大模型)。截至撰写时已验证可用。

保持 contract 精简且你自己的轮次少——编排器的上下文 × 轮次正是本架构旨在最小化的成本。编写两个文件,调用脚本,读取 manifest,门禁,修复。不要重读产物。