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/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（只引用直接子文件）

相关资源