技能生成器Skill skill-generator

技能生成器是一个AI驱动的文档自动化工具,专门用于创建符合Babysitter SDK规范的技能定义文件。它能够自动生成包含YAML前置元数据、详细能力文档、使用示例和最佳实践的SKILL.md文件,支持Claude Code技能开发流程,提高开发效率和文档一致性。关键词:技能生成,文档自动化,SDK规范,Claude Code,开发工具,元数据生成

DevOps 0 次安装 0 次浏览 更新于 2/25/2026

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. 标题: # 技能名称
  2. 介绍: “您是 技能名称 - 一个专门用于…的专业技能”
  3. 概述: 该技能的功能
  4. 能力: 带示例的编号能力列表
  5. 使用: 如何使用该技能
  6. 输出格式: 预期的输出结构
  7. 流程集成: 哪些流程使用此技能
  8. 最佳实践: 有效使用的指南
  9. 约束: 限制和要求

能力

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 - 完整专业化工作流

最佳实践

  1. 清晰描述: 使描述全面
  2. 适当工具: 仅包含必要工具
  3. 实用示例: 包含真实世界示例
  4. 流程链接: 记录流程集成
  5. 约束: 明确说明限制

约束

  • 名称必须为kebab-case格式
  • 描述应为1-2句话
  • allowed-tools必须是有效的工具名称
  • 在元数据中包含backlog-id
  • 遵循markdown格式标准