Skill Generator

Meta-skill for creating new Claude Code skills with configurable execution modes.

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐
│  Skill Generator Architecture                                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ⚠️ Phase 0: Specification  → 阅读并理解设计规范 (强制前置)      │
│              Study              SKILL-DESIGN-SPEC.md + 模板     │
│           ↓                                                      │
│  Phase 1: Requirements    → skill-config.json                   │
│           Discovery           (name, type, mode, agents)        │
│           ↓                                                      │
│  Phase 2: Structure       → 目录结构 + 核心文件骨架              │
│           Generation                                             │
│           ↓                                                      │
│  Phase 3: Phase           → phases/*.md (根据 mode 生成)         │
│           Generation          Sequential | Autonomous            │
│           ↓                                                      │
│  Phase 4: Specs &         → specs/*.md + templates/*.md         │
│           Templates                                              │
│           ↓                                                      │
│  Phase 5: Validation      → 验证完整性 + 生成使用说明            │
│           & Documentation                                        │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Execution Modes

Mode 1: Sequential (固定顺序)

传统线性执行模式，阶段按数字前缀顺序执行。

Phase 01 → Phase 02 → Phase 03 → ... → Phase N

适用场景:

流水线式任务（收集 → 分析 → 生成）
阶段间有强依赖关系
输出结构固定

示例: software-manual, copyright-docs

Mode 2: Autonomous (无状态自主选择)

智能路由模式，根据上下文动态选择执行路径。

┌─────────────────────────────────────────┐
│           Orchestrator Agent            │
│  (读取状态 → 选择 Phase → 执行 → 更新)  │
└───────────────┬─────────────────────────┘
                │
    ┌───────────┼───────────┐
    ↓           ↓           ↓
┌───────┐  ┌───────┐  ┌───────┐
│Phase A│  │Phase B│  │Phase C│
│(独立) │  │(独立) │  │(独立) │
└───────┘  └───────┘  └───────┘

适用场景:

交互式任务（对话、问答）
阶段间无强依赖
需要动态响应用户意图

示例: issue-manage, workflow-debug

Key Design Principles

模式感知: 根据任务特性自动推荐执行模式
骨架生成: 生成完整目录结构和文件骨架
规范遵循: 严格遵循 _shared/SKILL-DESIGN-SPEC.md
可扩展性: 生成的 Skill 易于扩展和修改

⚠️ Mandatory Prerequisites (强制前置条件)

⛔ 禁止跳过: 在执行任何生成操作之前，必须完整阅读以下文档。未阅读规范直接生成将导致输出不符合质量标准。

核心规范 (必读)

Document	Purpose	Priority
../_shared/SKILL-DESIGN-SPEC.md	通用设计规范 - 定义所有 Skill 的结构、命名、质量标准	P0 - 最高

模板文件 (生成前必读)

Document	Purpose
templates/skill-md.md	SKILL.md 入口文件模板
templates/sequential-phase.md	Sequential Phase 模板
templates/autonomous-orchestrator.md	Autonomous 编排器模板
templates/autonomous-action.md	Autonomous Action 模板
templates/code-analysis-action.md	代码分析 Action 模板
templates/llm-action.md	LLM Action 模板
templates/script-bash.md	Bash 脚本模板
templates/script-python.md	Python 脚本模板

规范文档 (按需阅读)

Document	Purpose
specs/execution-modes.md	执行模式规范
specs/skill-requirements.md	Skill 需求规范
specs/cli-integration.md	CLI 集成规范
specs/scripting-integration.md	脚本集成规范

Phase 执行指南 (执行时参考)

Document	Purpose
phases/01-requirements-discovery.md	收集 Skill 需求
phases/02-structure-generation.md	生成目录结构
phases/03-phase-generation.md	生成 Phase 文件
phases/04-specs-templates.md	生成规范和模板
phases/05-validation.md	验证和文档

Execution Flow

┌─────────────────────────────────────────────────────────────────┐
│  ⚠️ Phase 0: Specification Study (强制前置 - 禁止跳过)           │
│  → Read: ../_shared/SKILL-DESIGN-SPEC.md (通用设计规范)         │
│  → Read: templates/*.md (所有相关模板文件)                       │
│  → 理解: Skill 结构规范、命名约定、质量标准                      │
│  → Output: 内化规范要求，确保后续生成符合标准                    │
│  ⛔ 未完成 Phase 0 禁止进入 Phase 1                              │
├─────────────────────────────────────────────────────────────────┤
│  Phase 1: Requirements Discovery                                 │
│  → AskUserQuestion: Skill 名称、目标、执行模式                   │
│  → Output: skill-config.json                                    │
├─────────────────────────────────────────────────────────────────┤
│  Phase 2: Structure Generation                                   │
│  → 创建目录结构: phases/, specs/, templates/, scripts/          │
│  → 生成 SKILL.md 入口文件                                        │
│  → Output: 完整目录结构                                          │
├─────────────────────────────────────────────────────────────────┤
│  Phase 3: Phase Generation                                       │
│  → Sequential: 生成 01-xx.md, 02-xx.md, ...                     │
│  → Autonomous: 生成 orchestrator.md + actions/*.md              │
│  → Output: phases/*.md                                          │
├─────────────────────────────────────────────────────────────────┤
│  Phase 4: Specs & Templates                                      │
│  → 生成领域规范: specs/{domain}-requirements.md                  │
│  → 生成质量标准: specs/quality-standards.md                      │
│  → 生成模板: templates/agent-base.md                             │
│  → Output: specs/*.md, templates/*.md                           │
├─────────────────────────────────────────────────────────────────┤
│  Phase 5: Validation & Documentation                             │
│  → 验证文件完整性                                                 │
│  → 生成 README.md 使用说明                                       │
│  → Output: 验证报告 + README.md                                  │
└─────────────────────────────────────────────────────────────────┘

Directory Setup

const skillName = config.skill_name;
const skillDir = `.claude/skills/${skillName}`;

// 创建目录结构
Bash(`mkdir -p "${skillDir}/phases"`);
Bash(`mkdir -p "${skillDir}/specs"`);
Bash(`mkdir -p "${skillDir}/templates"`);

// Autonomous 模式额外目录
if (config.execution_mode === 'autonomous') {
  Bash(`mkdir -p "${skillDir}/phases/actions"`);
}

Output Structure

Sequential Mode

.claude/skills/{skill-name}/
├── SKILL.md
├── phases/
│   ├── 01-{step-one}.md
│   ├── 02-{step-two}.md
│   └── 03-{step-three}.md
├── specs/
│   ├── {domain}-requirements.md
│   └── quality-standards.md
└── templates/
    └── agent-base.md

Autonomous Mode

.claude/skills/{skill-name}/
├── SKILL.md
├── phases/
│   ├── orchestrator.md          # 编排器：读取状态 → 选择动作
│   ├── state-schema.md          # 状态结构定义
│   └── actions/                 # 独立动作（无顺序）
│       ├── action-{a}.md
│       ├── action-{b}.md
│       └── action-{c}.md
├── specs/
│   ├── {domain}-requirements.md
│   ├── action-catalog.md        # 动作目录（描述、前置条件、效果）
│   └── quality-standards.md
└── templates/
    ├── orchestrator-base.md     # 编排器模板
    └── action-base.md           # 动作模板

skill-generator