SuperAPI AI 工具集

write-a0

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:write-a0 用于编写 A0 程序。A0 是面向自动化智能体的行式脚本语言,程序是产生 JSON 结果的语句序列,每条程序必须以 return <expr> 结尾。

主要能力:支持注释(#)、能力声明 cap、let 绑定、expr -> name 绑定、return;类型包括 int、float、bool、str、null、记录、列表与字符串;支持算术、比较运算符与一元负号;提供 fs.read、fs.write、fs.list、fs.exists、http.get、sh.exec 等工具,只读工具用 call?,有副作用的工具用 do;内置 parse.json、get、put、patch、coalesce、typeof、eq、contains、not、and、or、len、append、concat、sort、filter、find、range、join、map、reduce、unique、pluck、flat、math.max、math.min、str.*、keys、values、merge、entries 等标准库函数;支持 assert 与 check 证据、if、for、map、reduce、filter 块、loop、fn、match、try/catch 控制流,以及 budget 资源限制。

使用方式:在文件顶部声明所需能力,例如 cap { fs.read: true };只读工具调用形如 call? fs.read { path: "data.json" } -> content,有副作用工具形如 do fs.write { path: "out.json", data: result, format: "json" } -> artifact;工具与函数参数始终是记录。可用 budget { timeMs: 30000, maxToolCalls: 10, maxBytesWritten: 1048576, maxIterations: 100 } 声明限制。

适用场景:编写自动化智能体脚本、数据处理与转换、文件读写、HTTP 获取、命令执行及带证据校验的流程。

限制:return 必须存在且为最后一条语句;变量须先绑定;同一作用域不可重复 let;call? 仅用于只读工具,do 仅用于有副作用工具;fn 须先定义后使用;fn、for、match 分支、filter 块与 loop 体均须以 return 结尾;保留字不可作变量名;未声明能力、能力被策略拒绝、超出预算等会报错。E_ASSERT 不可被 try/catch 捕获。具体工具参数与返回结构参见 references/tool-signatures.md。