name: skill-creator description: 根据参考技能和用户需求,自动生成新的 Agent 技能。分析优秀技能的架构模式,提取可复用的设计逻辑,产出符合规范的技能代码。使用场景:用户想创建一个能解决特定领域问题的新技能,或需要从参考案例中提取模式生成技能。
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"或"生成一个技能"时:
- 询问参考案例:用户是否有参考技能?如果没有,使用
list_skills查看可用技能 - 理解需求:明确技能要解决什么问题,覆盖哪些场景
- 执行生成:按上述工作流产出技能
- 用户验收:展示技能结构,让用户确认
参考案例分析方法
详见 references/ANALYSIS-METHOD.md
核心检查清单:
| 分析维度 | 关键问题 |
|---|---|
| 触发机制 | description 字段如何写得精准?触发词如何设计? |
| 工作流设计 | 主流程是什么?有哪些阶段和节点? |
| 决策树 | 复杂分支如何处理?有无"硬性节点"? |
| 文件组织 | 多个文件如何分工?何时拆分?何时合并? |
| 约束与规范 | 有哪些硬性规则?如何确保执行到位? |
| 自检机制 | 完成后如何验证质量? |
优秀技能的设计模式
详见 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 的技能"
- "生成一个技能"
- "帮我写一个技能"
- "技能设计"
❌ 坏的触发词:
- "帮我"(太模糊)
- "做点什么"(无法识别)
描述字段规范
---
name: skill-name
description: [能力1]。[能力2]。Use when [触发场景关键词1]、[触发场景关键词2]。
---
格式要求:
- 最大 1024 字符
- 使用第三人称
- 第一句:技能提供什么能力
- 第二句:触发场景
自检清单
生成完技能后逐项检查:
- description 包含触发场景("Use when...")
- SKILL.md 主体 ≤100 行
- 无时间敏感信息
- 术语一致
- 有具体示例
- 引用层级 ≤1(只引用直接子文件)
相关资源
| 文件 | 用途 |
|---|---|
references/ANALYSIS-METHOD.md |
如何分析参考技能,提取设计模式 |
references/DESIGN-PATTERNS.md |
优秀技能的设计模式清单 |
references/SKILL-STRUCTURE.md |
技能文件结构规范详解 |
examples/ |
示例技能结构参考 |