SuperAPI AI 工具集

write-template-playbooks

智能体与模型

查看项目

更新于 10-15 16:42

技能介绍

用途:为 build-an-agent 技能编写模板剧本。剧本是 references/agent-templates/<key>.md 下的一个 Markdown 文件;构建智能体读取与用户请求匹配的那份,并按它配置特定智能体。任务是把用例思考编码成 Sonnet 级模型可执行的规格。输入为一条清单行:名称、一句话卖点、集成、触发器。

能力与结构:每个剧本保持 1–2 KB。骨架含 Match(何时适用,含不匹配任何卡片的自由文本请求)、Required context(通过一个 request_input 表单询问,1–4 个字段,密钥绝不放入)、Researchable context(默认“figure it out”)、Explore first(先读后提议,用 discover_tools 接入读工具,用 test_run 在 delta.set.parameters.agent.tools 中传入完整工具列表以查看真实仓库或工作区)、Defaults/priors 表、Connections(缺失则 request_connection 并停止;列出与工具无关的替代方案)、Instructions template(提交到 instructions.agents_md 的编号流程,含输出格式)、Verify(先用直白测试消息的 test_run 读判定与工具行,不只看 200;有触发器时先发人工测试消息,再请用户跑真实触发器测试)、Closing report。

关键平台事实:request_input 有真实 default 字段,可预填表单;默认值须匹配字段类型,空默认被剥离,date/date-time 忽略默认。可研究选项应含“Figure it out, use your best judgment”枚举并设为 default;枚举选项只是建议,会渲染内置 Other… 自由文本;多选问题用 {type: "array", items: {type: "string", enum: [...]}};需解释的选项用 oneOf: [{const, title, description}];多问题表单可在 requestedSchema 设 "x-ag-stepper": true。test_run 通过内存 delta 演练未提交工具,参数中 tools 列表整体替换,因此探索无需先提交再停轮,提交并停止仅作后备。触发器测试入口是 Lightning 的 Test event(事件订阅)或 Play 的 Run(计划),不是烧瓶图标,烧瓶用于 Evaluations。

限制:剧本不得包含通用构建循环、配置 schema(工具条目、固定 llm/harness/runner 块)、工具接线形状或 cron 规则,这些位于技能主体或其他引用中。需要提示规则时读 references/prompting-checklist.md,需要完整合规示例时读 references/worked-example.md;权威文件格式与 index.md 匹配表见项目规格 docs/design/agent-workflows/projects/agent-templates/playbook-spec.md。