用途:当某个模式被反复使用且需要 AI 指导、项目特定约定与通用最佳实践不同、复杂工作流需要分步指令,或需要用决策树帮助 AI 选择做法时,创建新技能。文档已存在、模式过于简单、一次性任务则不宜创建技能,应改用参考资料。
结构:技能目录为 skills/{skill-name}/,含必需的 SKILL.md,可选 assets/(模板、schema、示例)与 references/(指向本地文档的链接)。SKILL.md 需包含 frontmatter:name、description(含 What 与 Trigger)、license(Apache-2.0)、metadata.author 与 metadata.version。正文建议包含 When to Use、Critical Patterns、Code Examples、Commands 等部分,并附资源指引。
命名约定:通用技能用 {technology},项目专用用 {project}-{component},测试技能用 {project}-test-{component},工作流技能用 {action}-{target}。assets/ 用于代码模板、JSON schema、示例配置;references/ 只指向本地文件,不用网页 URL。
内容准则:开头写最关键模式,用表格做决策树,代码示例保持精简,包含可复制的 Commands 段;不写 Keywords 段,不重复已有文档,不加冗长解释与故障排查段。创建后需将技能注册到 AGENTS.md 表格中,并逐项核对清单(技能是否已存在、模式是否可复用、命名是否合规、frontmatter 是否完整、关键模式是否清晰、示例是否精简、是否有 Commands 段、是否已加入 AGENTS.md)。
限制:资料未提供具体安装命令、收费或平台信息,暂未提供。