SuperAPI AI 工具集

generate-harness-dsl

智能体与模型

查看项目

更新于 10-25 10:17

技能介绍

Generate Harness DSL 是一个用于生成、修订或审查 Harness as Code .harness 文档的技能,目标场景包括编码智能体工作流、智能体角色、技能、工具契约、MCP 连接与运行时配置。

用途与产出:生成一个独立、自包含的 Harness as Code v0.3 文档(除非用户明确要求片段),并证明其执行契约可被包编译器与解析器接受。文档需包含 language 0.3、所有被引用的声明、具体的 runtime 和具名的 deployment;标准工具可以隐式存在。

主要能力:识别宿主、其实际需要暴露的能力以及真实控制方;在单一宿主会话使用 session,仅在所选适配器明确实现时才使用 state-machine 或 program 模式;按需求选择动词与能力匹配的写法,例如 skill、require tool、connect mcp;为自定义工具声明稳定的 contract id,并要求适配器暴露与之匹配;对状态机确保每个路由发射器、结果、目标、入口与停止点都存在且每个 agent 可达;program 工作流只有在适配器 programmaticLanguages 列出相同语言时才可解析。

使用方式:从最小示例起步,在需要可调用工具时参考标准示例;生成后在本技能目录运行 node scripts/validate.mjs /path/to/workflow.harness [harness-id ...],该命令输出 JSON,编译或任一所选具名 deployment 解析失败时以非零状态退出,只有成功退出才能称生成的 DSL 为可执行。修改本技能时需先运行 npm run harness:build 使 dist/ 反映当前编译器。

约束与限制:只陈述可证伪的需求,不添加 v0.3 中不存在的权限、设置、降级、绑定、输入/输出名称或运行时执行语法;只有契约中的标准工具 id 可以不声明;凭据不得写入源码,MCP 端点优先使用 env.VARIABLE,但声明端点并不等于建立连接,连接需由适配器完成;仅编译通过的状态机并不等于可执行的 Qoder 或 Pi 部署;生成或验证时不得调用宿主 SDK、安装集成或声称原生强制执行。返回结果应包含 DSL 或已保存文件,以及 harness id、deployment id、runtime、解析状态和所选适配器无法满足的执行边界。