SuperAPI AI 工具集

adding-skills

智能体与模型

查看项目

更新于 10-15 16:51

技能介绍

用途:本资料给出在 pre-commit-terraform 项目中新增 agent skill 的编写规范,帮助维护者让技能可被 agent 正确发现与加载。

主要能力与要求: 一、注册。每个新技能都必须在 AGENTS.md 的 ## Skill routing 下添加路由条目,格式为 | <trigger description> | skill-name |。触发描述应匹配用户或 agent 在相关场景下会使用的自然语言短语,可参考已有条目的风格。添加技能文件后需确认该条目存在,未注册前技能不可被发现。 二、脚本与 SKILL.md 的取舍。当被记录的任务是确定性且可重复的(相同输入得到相同输出、无歧义、可验证)时,优先使用脚本而非纯 SKILL.md。判断依据:需要判断或上下文的工作流(如设计 hook 行为、选择参数解析策略)用 SKILL.md;固定顺序的 CLI 调用且输出可预测的工作流用脚本加单元测试;纯 AI 元任务(如如何添加技能、如何创建 PR)用 SKILL.md。 三、创建脚本时:为纯函数编写单元测试(test_<name>.py 或等价形式);保持 SKILL.md 精简,指向脚本并记录用法,而不是把逻辑写进文档。

适用场景:为该项目贡献或维护 agent skill 的开发者。

限制:资料未提供具体安装命令、依赖版本、运行环境要求及示例代码细节,暂未提供。