# Skill Creator

> 根据参考技能和用户需求，自动生成新的 Agent 技能。分析优秀技能的架构模式，提取可复用的设计逻辑，产出符合规范的技能代码。使用场景：用户想创建一个能解决特定领域问题的新技能，或需要从参考案例中提取模式生成技能。

- Skill: `martin98-afk/skill-creator` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add martin98-afk/skill-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/martin98-afk/skill-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: martin98-afk (https://skillmd.com/u/martin98-afk)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/martin98-afk/skill-creator

---


# Skill Creator

根据**参考技能**和**用户需求**，自动生成新的 Agent 技能。

## 核心设计理念

**元技能设计**：这不是一个普通技能——它是一个能生成技能的技能。通过分析优秀技能的内部结构、决策流程、文件编排，提取出可复制的**设计模式**，然后根据新需求生成符合该模式的高质量技能。

## 工作流程

```
Phase 1   需求理解
   1.1  解析用户需求描述
   1.2  确定技能覆盖的领域和任务类型
   1.3  识别触发场景和关键词
   ▼
Phase 2   参考案例分析
   2.1  读取参考技能的完整结构
   2.2  分析技能架构（文件组织、工作流、决策树）
   2.3  提取通用设计模式
   ▼
Phase 3   模式映射与适配
   3.1  将参考模式适配到新需求
   3.2  设计新技能的架构和文件结构
   3.3  制定技能规范（触发词、工作流、约束）
   ▼
Phase 4   生成技能代码
   4.1  生成 SKILL.md 主入口
   4.2  生成 REFERENCE.md 参考文档（如需）
   4.3  生成示例文件（如需）
   4.4  生成辅助脚本（如需）
   ▼
Phase 5   验证与交付
   5.1  自检产出是否符合规范
   5.2  用户审查与反馈
   5.3  交付完整技能包
```

## 快速开始

当用户说"创建一个技能来做 X"或"生成一个技能"时：

1. **询问参考案例**：用户是否有参考技能？如果没有，使用 `list_skills` 查看可用技能
2. **理解需求**：明确技能要解决什么问题，覆盖哪些场景
3. **执行生成**：按上述工作流产出技能
4. **用户验收**：展示技能结构，让用户确认

## 参考案例分析方法

详见 [`references/ANALYSIS-METHOD.md`](references/ANALYSIS-METHOD.md)

**核心检查清单**：

| 分析维度 | 关键问题 |
|---|---|
| **触发机制** | description 字段如何写得精准？触发词如何设计？ |
| **工作流设计** | 主流程是什么？有哪些阶段和节点？ |
| **决策树** | 复杂分支如何处理？有无"硬性节点"？ |
| **文件组织** | 多个文件如何分工？何时拆分？何时合并？ |
| **约束与规范** | 有哪些硬性规则？如何确保执行到位？ |
| **自检机制** | 完成后如何验证质量？ |

## 优秀技能的设计模式

详见 [`references/DESIGN-PATTERNS.md`](references/DESIGN-PATTERNS.md)

### 模式 1：阶段 + 硬性节点

```
Phase 1 → [Checkpoint] → Phase 2 → [Checkpoint] → Phase 3
```

在关键转折点强制用户对齐，防止走偏。

### 模式 2：分层文档架构

```
SKILL.md (主入口，≤100行)
├── REFERENCE/*.md (详细参考，按需读取)
├── EXAMPLES/ (示例结构)
└── scripts/ (工具脚本)
```

### 模式 3：单一真相源

关键数据只存储在一个地方，其他地方引用。不允许数据漂移。

### 模式 4：口述检查清单

完成产出后必须走自检 → 修复 → 再汇报。不能跳过验证环节。

### 模式 5：按需渐进披露

不同阶段读取不同文件，避免一次性信息过载。

## 生成规范

### SKILL.md 规范

- **description**：1024字符内，三段式——能力描述 / 触发场景 / 关键词
- **主入口**：≤100行，结构清晰，包含 Quick Start
- **引用路径**：只引用一级深度的文件

### 触发词设计

触发词必须具体、可识别：

**✅ 好的触发词**：
- "创建一个能做 X 的技能"
- "生成一个技能"
- "帮我写一个技能"
- "技能设计"

**❌ 坏的触发词**：
- "帮我"（太模糊）
- "做点什么"（无法识别）

### 描述字段规范

```markdown
---
name: skill-name
description: [能力1]。[能力2]。Use when [触发场景关键词1]、[触发场景关键词2]。
---
```

**格式要求**：
- 最大 1024 字符
- 使用第三人称
- 第一句：技能提供什么能力
- 第二句：触发场景

## 自检清单

生成完技能后逐项检查：

- [ ] description 包含触发场景（"Use when..."）
- [ ] SKILL.md 主体 ≤100 行
- [ ] 无时间敏感信息
- [ ] 术语一致
- [ ] 有具体示例
- [ ] 引用层级 ≤1（只引用直接子文件）

## 相关资源

| 文件 | 用途 |
|---|---|
| [`references/ANALYSIS-METHOD.md`](references/ANALYSIS-METHOD.md) | 如何分析参考技能，提取设计模式 |
| [`references/DESIGN-PATTERNS.md`](references/DESIGN-PATTERNS.md) | 优秀技能的设计模式清单 |
| [`references/SKILL-STRUCTURE.md`](references/SKILL-STRUCTURE.md) | 技能文件结构规范详解 |
| [`examples/`](examples/) | 示例技能结构参考 |