技能创建框架

技能文档

---
name: skill-create-framework
description: 技能创建与规范化框架。提供三类技能原型（最小型/标准型/复杂型）、路由式 SKILL.md 结构模板、八类激活触发词模式与四道质量关卡（结构/路由/文档/集成校验），覆盖技能创建、合规审查、更新重构、规范化重建四大操作。当用户要求「创建技能」「按规范建技能」「审查技能结构」「重构技能」「规范化技能」时触发。触发词：创建技能、技能规范、技能审查、技能重构、技能原型、SKILL.md 模板。
title: 技能创建框架
category: 开发工具
---

# 技能创建框架

保证每个新技能结构一致、路由清晰、触发完备的创建与验证框架。核心思想：**结构上从简从众，内容上才发挥创造力**——目录结构与组织模式遵循既有原型，领域工作流与能力设计自由发挥。

## 技能工作流

### 步骤1：明确技能定位

创建前先与需求方澄清四件事：

- **做什么**：技能的核心能力一句话说清
- **何时触发**：用户会说什么话（触发短语）
- **需要几个工作流**：数量与类别
- **依赖什么**：脚本、外部服务、参考资料

### 步骤2：选择技能原型

按工作流数量与复杂度选择：

**最小型（1-3 个工作流）**

```
skill-name/
├── SKILL.md
└── workflows/ 或 assets/
    └── *.md
```

**标准型（3-15 个工作流）**

```
skill-name/
├── SKILL.md
├── workflows/
│   └── *.md（可扁平或分层）
└── [可选：documentation/、tools/、references/]
```

**复杂型（15+ 个工作流）**

```
skill-name/
├── SKILL.md
├── documentation/
├── workflows/（分层嵌套）
├── references/
├── state/
└── tools/
```

### 步骤3：按规范模板写 SKILL.md

结构模板（顺序固定）：

```markdown
---
name: skill-name
description: |
  这个技能做什么、何时使用。

  USE WHEN: user says "触发短语"、其他变体。
---

## Workflow Routing（紧跟 frontmatter，必须第一个章节）

**当用户请求 [动作 1]：**
示例："真实用户说法"、"同义变体"
→ **READ:** workflows/workflow1.md
→ **EXECUTE:** 对该工作流做什么

[每个工作流文件都必须有一条路由]

---

## When to Activate This Skill

[用八类触发模式写全激活条件]

---

## 主体内容

[详细信息、文件链接、示例]
```

**八类激活触发模式**（写触发词时覆盖全部类别）：

1. 直接命令式（「创建一个技能」）
2. 目标描述式（「我需要一个能做 X 的技能」）
3. 审查验证式（「检查这个技能合不合规」）
4. 更新维护式（「给技能加个工作流」）
5. 规范化式（「把技能重构成标准结构」）
6. 质量指标式（提到「规范」「最佳实践」「模板」）
7. 同义变体式（创建/新建/搭建/做一个）
8. 反例边界式（明确何时不触发，避免误触发）

### 步骤4：路由每个工作流文件

硬性规则：

1. **Workflow Routing 章节必须紧跟 frontmatter**，是正文第一个章节
2. **每个工作流文件必须被路由**——不允许存在「孤儿工作流」
3. **每个次要文件必须在 SKILL.md 正文中被链接**——不允许「隐形文件」
4. **渐进式披露**：SKILL.md 概览 → workflows/ 详细流程 → references/ 查阅资料

### 步骤5：过四道质量关卡

创建或更新后逐项校验：

**结构校验**
- [ ] 目录结构符合所选原型
- [ ] 文件命名规范统一
- [ ] 必需文件齐全（SKILL.md 等）

**路由校验**
- [ ] Workflow Routing 章节存在且位于正文首位
- [ ] 所有工作流被显式路由
- [ ] 激活触发词覆盖八类模式

**文档校验**
- [ ] SKILL.md 引用了所有文件
- [ ] 每个文件有清晰用途与使用时机
- [ ] 提供了使用示例

**集成校验**
- [ ] 与既有技能无职责重复
- [ ] 与常见工作流兼容

### 步骤6：验证激活

用 description 中的自然语言触发短语实际测试技能能否被正确触发；触发不到就回头补触发词。

## 四大操作

### 创建新技能

按步骤 1-6 全流程执行：定位 → 选原型 → 写 SKILL.md → 路由 → 过关卡 → 验证。

### 审查既有技能

对已有技能做合规审计：

1. 检查目录结构属于哪种原型，是否符合该原型要求
2. 检查 Workflow Routing 是否存在、是否第一个章节
3. 逐一核对工作流文件是否有路由、次要文件是否被链接
4. 检查触发词是否覆盖八类模式
5. 输出审计报告：「合规」或逐条列出问题与修复建议

### 更新既有技能

在保持合规的前提下修改：

- 新增工作流：文件放入 workflows/ 后**必须同步补路由**
- 调整结构：迁移文件后全量重查链接与路由
- 修改触发词：变更后重新验证激活

### 规范化重建

对结构混乱的既有技能按规范重建，同时保留功能：

1. 盘点现有文件与功能，归类到目标原型
2. 重组目录（工作流进 workflows/、查阅资料进 references/、模板进 assets/）
3. 重写 SKILL.md：路由章节置顶、八类触发词、链接全部文件
4. 跑完四道质量关卡后交付

## 示例

### 示例 1：创建最小型技能

需求：「做一个生成 API 文档的技能」

1. 原型：最小型（单工作流）
2. 结构：`api-docs/` + `SKILL.md` + `workflows/generate-docs.md`
3. SKILL.md 要素：frontmatter 触发词、路由章节置顶、八类激活条件、主体说明
4. 过质量关卡，测试触发「帮我生成 API 文档」

### 示例 2：创建标准型技能

需求：「做一个数据库操作技能——迁移、备份、查询、优化」

1. 原型：标准型（4 个工作流）
2. 结构：`workflows/run-migration.md`、`backup-database.md`、`optimize-queries.md`、`execute-query.md`
3. 语义路由：「跑迁移」→ run-migration，「备库」→ backup-database，等等
4. 每个工作流逐一测试激活

### 示例 3：审查既有技能

需求：「审查 research 技能是否合规」

逐项检查：路由章节位置、12 个工作流是否全被路由、触发词完备性、文件链接完整性，输出「合规」或问题清单。

使用说明

# 技能创建框架

提供三类技能原型（最小型/标准型/复杂型）、路由式 SKILL.md 结构模板、八类激活触发词模式与四道质量关卡，覆盖技能创建、合规审查、更新重构、规范化重建四大操作，保证每个技能结构一致、路由清晰、触发完备。

## 最简用法

```text
用技能创建框架帮我做一个「周报生成」技能
```

```text
审查一下这个技能目录是否合规
```

## 特点

- 三档原型按复杂度对号入座，结构不纠结
- 路由章节置顶 + 工作流零孤儿 + 文件零隐形
- 八类触发词模式，激活覆盖全面
- 四道质量关卡逐项打勾，交付前自动把关
- 支持对混乱存量技能做规范化重建

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。