ai-create-skill

ai-create-skill

创建符合 Agent Skills 格式、并适配此仓库分类结构的新 AI Agent 技能。

适用场景

在以下情况下使用此技能：

• 从头开始创建新技能
• 帮助用户为某种实践、模式或工具定义 Agent 指令
• 检查现有技能是否符合正确格式

指令

1. 选择正确的分类。 将技能放在最具体的匹配分类下：

   • ai/ — 适用于任何项目的跨领域技能
   • common/ — 适用于任何项目的跨领域技能
   • operations/ — DevOps、CI/CD、部署和基础设施技能
   • frontend/ — 通用前端技能
   • frontend/*/ — 特定技术的技能
   • backend/ — 通用后端技能
   • backend/*/ — 特定技术的技能

2. 创建技能目录。 使用能清楚标识该技能的 kebab-case 名称：

   skills/<category>/<skill-name>/
   

3. 创建带有 frontmatter 的 SKILL.md。 每项技能都必须有一个 SKILL.md 文件，其中包含带有 name 和 description 的 YAML frontmatter：

   ---
   name: <category>-<skill-name>
   description: A single sentence describing what this skill does.
   ---
   

   • name 在整个仓库中必须唯一。

   • description 应简洁明了，用于技能发现和匹配。

4. 编写技能正文。 使用以下章节组织 Markdown 正文：

   必需章节：

   • # <name> — 标题须与 frontmatter 中的名称一致，后接一行摘要。
   • ## 适用场景 — 列出此技能应当启动的情形。
   • ## 指令 — 按编号列出 Agent 必须遵循的分步指令。

   可选章节：

   • ## 前置条件 — 应用此技能前需要的其他技能或工具。
   • ## 核心概念 — Agent 正确推理所需的背景知识。
   • ## 示例 — 展示正确行为的具体代码或输出示例。
   • ## 参考资料 — 外部文档或标准的链接。

5. 为 AI Agent 编写指令，而非为人类编写。

   • 明确具体，避免歧义——读者是语言模型，而不是浏览文档的开发者。
   • 使用祈使语气：“执行 X”“绝不执行 Y”“始终执行 Z”。
   • 存在多种路径时提供决策树（如果满足 A，则执行 B，否则执行 C）。
   • 包含可供 Agent 自行评估的验证检查（“询问：不满足 Y 时，X 是否仍然成立？”）。
   • 避免“遵循最佳实践”之类的模糊指引——明确说明具体操作。

6. 聚焦技能范围。 一项技能只处理一个关注点。如果技能超过约 150 行，请考虑将其拆分为多项技能，并在它们之间注明前置依赖。

7. 根据需要添加可选的辅助文件：

   • scripts/ — Agent 可调用的可执行辅助脚本（shell、Node.js、Python）。
   • references/ — 辅助文档、检查清单或查找表。

8. 更新分类 README。 将新技能添加到 skills/<category>/README.md 的项目符号列表中：

   - <skill-name>/SKILL.md
   

9. 验证技能。

   • frontmatter 是否能解析为有效的 YAML？
   • name 在仓库中是否唯一？
   • “适用场景”章节是否提供了足够的信息来匹配技能？
   • 指令是否无需外部上下文即可执行？
   • AI Agent 只阅读此文件后，是否能确切知道该做什么？

模板

使用以下内容作为新技能的起点：

---
name: <category>-<skill-name>
description: A brief description of what this skill does.
---

# <category>-<skill-name>

One-line summary of what this skill accomplishes.

## When to use

Use this skill when:

- Situation A
- Situation B
- Situation C

## Instructions

1. First actionable step.
2. Second actionable step.
3. Additional steps as needed.