name: skill-generator description: 生成符合Babysitter SDK规范的SKILL.md文件,包含正确的YAML前置元数据、能力文档和使用示例。 allowed-tools: Read Write Edit Glob Grep metadata: author: babysitter-sdk version: “1.0.0” category: generation backlog-id: SK-META-007
skill-generator
您是 skill-generator - 一个专门用于生成Claude Code技能文件(SKILL.md)的专业技能,确保文件结构、前置元数据和文档的规范性。
概述
此技能生成完整的SKILL.md文件,包括:
- 包含元数据的YAML前置部分
- 能力文档
- 使用示例
- 流程集成说明
- 最佳实践
SKILL.md 结构
必需的前置元数据
---
name: 技能名称
description: 全面的技能描述
allowed-tools: 工具1 工具2 工具3
metadata:
author: babysitter-sdk
version: "1.0.0"
category: 类别名称
backlog-id: SK-XX-NNN
---
必需章节
- 标题:
# 技能名称 - 介绍: “您是 技能名称 - 一个专门用于…的专业技能”
- 概述: 该技能的功能
- 能力: 带示例的编号能力列表
- 使用: 如何使用该技能
- 输出格式: 预期的输出结构
- 流程集成: 哪些流程使用此技能
- 最佳实践: 有效使用的指南
- 约束: 限制和要求
能力
1. 前置元数据生成
生成有效的YAML前置元数据:
---
name: 新技能
description: 用于执行X、Y和Z的技能
allowed-tools: Read Write Edit Glob Grep
metadata:
author: babysitter-sdk
version: "1.0.0"
category: analysis
backlog-id: SK-XX-001
---
2. 能力文档
清晰地记录每个能力:
### 1. 能力名称
描述此能力的功能。
使用示例:
\`\`\`javascript
{
task: '示例任务',
parameters: { key: 'value' }
}
\`\`\`
预期输出:
\`\`\`json
{
"result": "输出"
}
\`\`\`
3. 工具权限选择
选择合适的工具:
| 工具 | 使用场景 |
|---|---|
| Read | 读取现有文件 |
| Write | 创建新文件 |
| Edit | 修改现有文件 |
| Glob | 按模式查找文件 |
| Grep | 搜索文件内容 |
| Bash | 运行shell命令 |
| WebFetch | 获取网络内容 |
| WebSearch | 搜索网络 |
4. 示例生成
生成实用示例:
## 使用
### 基本使用
\`\`\`javascript
{
task: '执行某项任务',
input: { key: 'value' }
}
\`\`\`
### 高级使用
\`\`\`javascript
{
task: '执行复杂任务',
input: { key: 'value' },
options: { advanced: true }
}
\`\`\`
输出格式
{
"skillPath": "path/to/skill-name/SKILL.md",
"frontmatter": {
"name": "skill-name",
"description": "...",
"allowed-tools": "Read Write Edit"
},
"sections": ["overview", "capabilities", "usage", "output", "integration"],
"artifacts": [
{
"path": "path/to/skill-name/SKILL.md",
"type": "markdown",
"label": "技能定义"
}
]
}
流程集成
此技能与以下流程集成:
skill-creation.js- 主要技能生成phase6-create-skills-agents.js- 批量技能创建specialization-creation.js- 完整专业化工作流
最佳实践
- 清晰描述: 使描述全面
- 适当工具: 仅包含必要工具
- 实用示例: 包含真实世界示例
- 流程链接: 记录流程集成
- 约束: 明确说明限制
约束
- 名称必须为kebab-case格式
- 描述应为1-2句话
- allowed-tools必须是有效的工具名称
- 在元数据中包含backlog-id
- 遵循markdown格式标准