技能生成器Skill skill-generator

---

name: 技能生成器 description: 元技能，用于生成具有正确格式和结构的新技能。在创建群系统的新技能或代理需要生成技能脚手架时使用。确保技能遵循约定（frontmatter格式、目录结构、捆绑资源）。

技能生成器

生成具有正确格式、结构和约定的新技能。这个元技能帮助代理创建技能，而不会在格式上产生幻觉。

快速开始

要生成一个新技能：

bash scripts/generate-skill.sh <技能名称> [目标目录]

这将创建一个完整的技能脚手架，包括：

• 具有正确frontmatter的SKILL.md
• scripts/ 目录，用于可执行助手
• references/ 目录，用于文档
• 遵循约定的占位符内容

技能格式约定

每个技能必须包括：

1. SKILL.md（必需） - 主技能文件，包含：

   • YAML frontmatter（名称、描述）
   • Markdown正文，带有指令

2. 捆绑资源（可选）：

   • scripts/ - 可执行代码（bash/python等）
   • references/ - 按需加载的文档
   • assets/ - 输出中使用的文件（模板等）

Frontmatter要求

---
name: 技能名称
description: 技能的功能以及何时使用它。包括触发场景。
---

描述字段对技能发现和触发至关重要。包括：

• 技能的功能
• 何时使用它（具体触发条件）
• 激活它的上下文

目录结构

技能名称/
├── SKILL.md（必需）
├── scripts/（可选）
│   └── 示例脚本.sh
├── references/（可选）
│   └── 约定.md
└── assets/（可选）
    └── 模板文件

编写有效技能

保持SKILL.md简洁

目标在500行以内。将详细内容移至references/：

• 核心工作流程 → SKILL.md
• 详细示例 → references/
• API文档 → references/
• 长解释 → references/

使用命令式形式

以命令形式编写指令：

• “首先读取文件” ✓
• “你应该读取文件” ✗
• “检查模式” ✓
• “考虑检查模式” ✗

渐进式披露

技能使用三级加载：

1. 元数据（约100词） - 始终在上下文中
2. SKILL.md正文（<5k词） - 当技能触发时
3. 捆绑资源（无限） - 按需加载

捆绑资源

scripts/

用于确定性任务的可执行代码：

• 当相同代码被重复重写时
• 当可靠性至关重要时
• 通过bash/python运行，不加载到上下文

使脚本可执行：

chmod +x scripts/我的脚本.sh

references/

按需加载的文档：

• 数据库模式
• API文档
• 详细工作流程指南
• 领域知识

保持参考文件聚焦。对于超过100行的文件，包括目录。

从SKILL.md中引用，并明确指导何时阅读：

参见references/api文档.md获取完整API参考。

assets/

输出中使用的文件（不加载到上下文）：

• 模板
• 图像/图标
• 样板代码
• 字体/排版

不应包括的内容

不要创建这些文件：

• README.md
• INSTALLATION_GUIDE.md
• QUICK_REFERENCE.md
• CHANGELOG.md

技能应仅包含AI代理执行任务所需的内容。无辅助文档。

验证

在最终确定前，验证技能：

bun scripts/validate-skill.ts 路径/到/技能

检查：

• YAML frontmatter格式
• 必需字段存在
• 无TODO占位符
• 无额外文件
• 命名约定

参考

参见references/约定.md获取完整技能格式规范。