Prorise-cool Resource Map
基准路径:
.claude/skills/operations-specialist/references/domains/skill-lifecycle/generator/
generator/
├── phases/
│ ├── 01-requirements-discovery.md
│ ├── 02-structure-generation.md
│ ├── 03-phase-generation.md
│ ├── 04-specs-templates.md
│ └── 05-validation.md
├── specs/
│ ├── cli-integration.md
│ ├── execution-modes.md
│ ├── scripting-integration.md
│ └── skill-requirements.md
├── templates/
│ ├── autonomous-action.md
│ ├── autonomous-orchestrator.md
│ ├── code-analysis-action.md
│ ├── llm-action.md
│ ├── script-bash.md
│ ├── script-python.md
│ ├── sequential-phase.md
│ └── skill-md.md
└── SKILL.md
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 # 动作模板