SuperAPI AI 工具集

write-a-consumer-skill

智能体与模型

查看项目

更新于 10-15 22:12

技能介绍

用途:指导开发者在消费端应用自己的 .pilot/ 文件夹内编写 SKILL.md,让服务端在启动时自动加载这些技能,供模型按自然语言触发调用。

主要能力与结构:.pilot/ 需位于应用根目录(与 package.json、app/ 或 src/ 同级),服务端按 process.cwd() 查找 ./.pilot/,不要放在 public/ 等打包路径下。目录含 RESOLVER.md 与 skills/<name>/SKILL.md。SKILL.md 的 frontmatter 由 --- 包裹,name、description 为必填字符串,tools / allowed-tools / triggers 为字符串列表,mutating 为 true/false;不支持嵌套映射、锚点和流式列表。RESOLVER.md 中解析器只读取 H2 标题、以 | 开头的行(排除分隔行与表头),技能单元格需用反引号包裹路径如 skills/<name>/SKILL.md。

使用方式:优先用 CLI 生成规范格式,npx agentickit init 首次创建文件夹,npx agentickit add-skill <name> 为每个新能力追加解析行。随后在 API 路由中使用 createPilotHandler(无需 system 选项,自动加载 .pilot/),并为模型可调用的每个能力注册匹配的 usePilotAction,其 name 必须与 SKILL.md 中 tools 列表的工具名完全一致。

验证:运行 pnpm dev,服务端应出现 [agentickit] auto-loaded .pilot/ (~N chars);在 createPilotHandler 中开启 debug: true 可查看每步记录并写入 ./debug/agentickit-YYYY-MM-DD.log。

限制与注意:SKILL.md 与 RESOLVER.md 均为纯文本上下文,不被执行,代码绑定放在 usePilotAction;不要手写新技能而绕过 CLI,避免解析静默失败;触发词应贴近用户真实说法;技能名需与工具或动作逐字节匹配,否则模型无工具可调。资料未提供收费、价格与平台信息。