SuperAPI AI 工具集

agent-skills-best-practices

智能体与模型

查看项目

更新于 10-16 05:00

技能介绍

用途:该技能用于约束以 agentskills.io 格式编写的智能体技能(Agent Skill)的编写纪律。当在宿主项目的技能根目录(如 .agents/skills/)下创建、优化、拆分、合并、重命名或审计任何技能时适用。项目实际的技能清单与主题到技能的路由,应遵循项目的主技能索引和技能根目录的目录列表。

主要能力按主题拆分到多个参考文件:

  • scoping-and-mece.md:选择连贯的技能边界、名称、拆并或事实来源位置;新增内容前检查与相邻技能的重叠;以章节长度和主题增长作为重构信号。
  • frontmatter-and-naming.md:创建或编辑影响发现的 SKILL.md frontmatter;选择技能目录名并与 name 字段保持一致;移植或保留宿主项目的 harness 字段。
  • description-writing.md:起草、精简或审计 description 字段;让发现元数据同时说明技能覆盖什么与何时适用;在不使技能过宽的前提下加入用户可能使用的措辞和基于症状的触发词。
  • body-content-style.md:撰写或修订技能正文及参考文件的实质章节;平衡简洁的主题说明、示例与准则条目;把 RFC-2119 规范化要求条目放在详细参考内容中,而非父级路由章节。
  • progressive-disclosure.md:判断技能应保持单文件还是拆分为 references/;使用父路由章节格式:“## Topic,See file.md for:”,后接描述性情境条目;保持父路由条目不含 RFC-2119 式要求关键词,使其作为路由线索而非重复规则。
  • cross-referencing.md:新增、重命名、移动、删除或链接技能与参考文件;选择单一事实来源而非跨技能复制详细规则;校验相对链接并保持宿主项目主技能索引同步。
  • audit-checklist.md:审计多个技能或报告技能树质量;检查清单、索引同步、章节结构、RFC-2119 条目与相对链接;识别重叠、过时假设、孤立引用和缺失的事实来源链接。

使用方式:依据上述各参考文件对应场景触发相应章节;具体命令、安装步骤及官方文本暂未提供。

限制:资料未提供具体收费、价格、平台与效果信息;技能的实际清单与路由需参考宿主项目的主技能索引与技能根目录列表。