skill-generator

用途

skill-generator 是一个专用技能，用于生成 Claude Code 技能文件（SKILL.md）。它按照 Babysitter SDK 的约定，产出结构完整、frontmatter 规范、文档齐全的技能定义文件，帮助开发者快速创建标准化的技能。

主要能力

Frontmatter 生成：生成合法的 YAML frontmatter，包含 name、description、allowed-tools 以及 metadata（author、version、category、backlog-id）等字段。
能力文档编写：为每项能力提供清晰描述，并附带示例用法与预期输出。
工具权限选择：根据用途选择合适的工具，包括 Read（读取现有文件）、Write（创建新文件）、Edit（修改现有文件）、Glob（按模式查找文件）、Grep（搜索文件内容）、Bash（运行 shell 命令）、WebFetch（获取网页内容）、WebSearch（搜索网络）。
示例生成：生成基础用法与进阶用法示例，采用 JavaScript 代码块形式展示任务与参数结构。

生成的 SKILL.md 结构

必需 frontmatter 字段：

---
name: skill-name
description: Comprehensive skill description
allowed-tools: Tool1 Tool2 Tool3
metadata:
  author: babysitter-sdk
  version: "1.0.0"
  category: category-name
  backlog-id: SK-XX-NNN
---

必需章节包括：标题（# skill-name）、简介（"You are skill-name - a specialized skill for..."）、概述（技能功能）、能力（带示例的编号能力）、用法（如何使用）、输出格式（预期输出结构）、流程集成（哪些流程使用该技能）、最佳实践（有效使用指南）、约束（限制与要求）。

使用方式

该技能通过任务调用方式使用，输入包含任务描述与参数。基础用法示例：

{
  task: 'Do something',
  input: { key: 'value' }
}

进阶用法示例：

{
  task: 'Do something complex',
  input: { key: 'value' },
  options: { advanced: true }
}

输出格式

输出为结构化 JSON，包含技能路径、frontmatter、章节列表和产物信息：

{
  "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 definition"
    }
  ]
}

流程集成

该技能可与以下流程集成：

skill-creation.js：主要技能生成
phase6-create-skills-agents.js：批量技能创建
specialization-creation.js：完整专项工作流

最佳实践

描述清晰：使 description 全面完整
工具适当：仅包含必要的工具
示例实用：包含真实场景示例
流程链接：记录流程集成关系
约束明确：清楚说明限制

约束

name 必须为 kebab-case 格式
description 应为 1-2 句话
allowed-tools 必须为有效工具名
metadata 中需包含 backlog-id
遵循 Markdown 格式标准