SuperAPI AI 工具集

agent-skills

智能体与模型

查看项目

更新于 10-16 03:04

技能介绍

用途:这是一个用于编写与改进 Agent Skills 的技能。Agent Skills 是代理按需发现并加载的指令、脚本与资源文件夹;本技能覆盖创建、修改与审查技能,使其符合规范与最佳实践。适用场景包括从零创建新技能、修改或改进已有技能、共享前审查质量、为更好的渐进式披露重组内容。

主要能力与规范要点:每个 SKILL.md 必须以 YAML frontmatter 开头,包含 name 与 description。name 须为 1-64 字符,仅用小写字母数字与连字符,不得以连字符开头或结尾、不得含连续连字符,且必须与父目录名完全一致;description 须 1-1024 字符,建议第三人称,必须含“Use when...”触发条件并含关键词。可选字段有 license、compatibility(最多 500 字符)、metadata、allowed-tools(实验性)。技能目录必须含 SKILL.md,可选 scripts/、references/、assets/。参考文件须距 SKILL.md 仅一层,不建议嵌套引用链。

最佳实践:SKILL.md 正文建议控制在 500 行以内,采用渐进式披露(元数据约 100 tokens 启动加载、激活时加载完整 SKILL.md、资源按需加载);按任务脆弱程度匹配自由度;多步流程可提供清单,质量关键任务应含验证反馈循环。技能中可使用 RFC 2119 关键词标示要求级别。

编写流程:定义目的、确定触发条件、写 frontmatter、起草正文、抽取参考、对照清单审查、用真实任务测试。同时列出了应避免的反模式:描述含糊、过度解释常识、深层嵌套引用、时效性信息、无默认值的多选项、术语不一致。

限制:资料未提供具体命令、安装方式、收费或价格信息,暂未提供。