name: skill-creator description: 用于创建有效技能的指南。当用户想要创建新技能(或更新现有技能)以扩展Claude在专业知识、工作流程或工具集成方面的能力时,应使用此技能。
技能创建器
目的
一个元技能,用于指导创建高质量、有效的技能。提供模板、最佳实践和结构指南,用于构建能够通过专业知识、工作流程或工具集成来增强Claude能力的技能。
使用时机
- 用户想要创建新技能
- 用户想要更新或改进现有技能
- 用户询问如何构建技能文档
- 需要为特定领域或工作流程设计技能
- 希望确保技能遵循最佳实践
核心技能结构
必需组件
每个技能必须包含以下元素:
-
前言
--- name: 技能名称 description: 一行描述,说明何时使用此技能 --- -
标题与目的
# 技能名称 ## 目的 清晰、简洁地说明此技能的作用 -
使用时机
## 使用时机 - 特定触发条件 1 - 特定触发条件 2 - 此技能有帮助的上下文场景 -
核心能力
## 核心能力 ### 领域专业知识 - 关键知识领域 1 - 关键知识领域 2 ### 工具与方法 - 具体技术 - 使用的框架
可选但推荐的组件
-
工作流程
## 工作流程 1. 步骤 1:首先做什么 2. 步骤 2:下一步行动 3. 步骤 3:最终交付物 -
最佳实践
## 最佳实践 - 应该这样做 - 避免那样做 - 记住这一点 -
示例
## 示例 ### 示例 1:常见用例 **输入**:用户请求 **方法**:如何处理 **输出**:预期结果 -
反模式
## 反模式 ❌ **不要**:不良实践 ✅ **要**:好的替代方案
技能创建工作流程
步骤 1:定义范围
问自己:
- 这个技能解决什么问题?
- 谁会使用它?
- 什么会触发它的使用?
- 预期结果是什么?
步骤 2:识别核心知识
记录:
- 领域特定术语
- 关键概念和原则
- 该领域的常见模式
- 涉及的工具和技术
步骤 3:构建工作流程
规划:
- 进入条件
- 分步流程
- 决策点
- 退出标准和交付物
步骤 4:添加实用元素
包括:
- 真实世界示例
- 需要避免的常见陷阱
- 该领域的最佳实践
- 质量标准
步骤 5:编写清晰的触发器
使“使用时机”具体化:
-
✅ “用户需要为PostgreSQL数据库进行SQL查询优化”
-
❌ “用户需要数据库帮助”
-
✅ “调试分布式系统中的生产中断”
-
❌ “修复错误”
技能质量标准
清晰度
- [ ] 名称不言自明
- [ ] 描述清楚地说明了何时使用
- [ ] 目的在1-2句话内说明
- [ ] 没有未经解释的行话
完整性
- [ ] 所有必需部分都存在
- [ ] 工作流程可操作
- [ ] 示例涵盖常见情况
- [ ] 边缘情况已处理
具体性
- [ ] 触发器是具体的
- [ ] 步骤足够详细以便遵循
- [ ] 工具/方法被明确命名
- [ ] 成功标准已定义
可用性
- [ ] 易于扫描和导航
- [ ] 格式一致
- [ ] 章节顺序合乎逻辑
- [ ] 在有用处提供交叉引用
技能模板
技术领域技能模板
---
name: 领域专家
description: 当用户需要在[技术/领域]中进行[具体技术任务]时使用
---
# 领域专家
## 目的
[领域]专家,专长于[具体领域]。帮助解决[关键问题]。
## 使用时机
- 用户需要[具体任务 1]
- 使用[技术]并需要[帮助类型]
- 故障排除[具体问题类型]
- 设计[架构元素]
## 核心能力
### [领域]专业知识
- [技术 1] - [版本/细节]
- [技术 2] - [哪些方面]
- [模式/实践] - [何时/如何使用]
### 关键技术
- **[技术 1]**:[它解决什么问题]
- **[技术 2]**:[何时使用]
- **[技术 3]**:[它如何帮助]
## 工作流程
1. **理解需求**
- 澄清[具体方面]
- 识别[约束]
2. **应用[领域]模式**
- 为[场景]使用[模式 1]
- 考虑[权衡]
3. **实施解决方案**
- 遵循[最佳实践]
- 确保[质量标准]
4. **验证**
- 测试[方面]
- 验证[需求满足]
## 最佳实践
- **[实践 1]**:[理由]
- **[实践 2]**:[好处]
- **[实践 3]**:[为何重要]
## 常见模式
### [模式 1]
**何时**:[场景]
**如何**:[实施方法]
**为何**:[好处]
### [模式 2]
**何时**:[场景]
**如何**:[实施方法]
**为何**:[好处]
## 反模式
❌ **不要**:[不良实践]
- 失败原因:[原因]
- 更好的方法:[替代方案]
❌ **避免**:[常见错误]
- 问题:[哪里出错]
- 替代:[正确方式]
## 示例
### 示例 1:[常见场景]
**上下文**:[情况]
**方法**:[解决步骤]
**结果**:[结果]
## 工具与技术
- **[工具 1]**:[版本] - [用于什么]
- **[工具 2]**:[版本] - [用于什么]
- **[框架]**:[版本] - [使用的关键功能]
流程/工作流程技能模板
---
name: 流程专家
description: 当用户需要[具体流程/工作流程]以实现[结果]时使用
---
# 流程专家
## 目的
指导[具体流程]以实现[具体结果]。通过[方法论]确保[质量方面]。
## 使用时机
- 需要[执行流程]
- 希望确保[质量结果]
- 正在处理[需要此流程的场景]
## 核心流程
### 阶段 1:[名称]
**目标**:[要实现什么]
步骤:
1. [行动 1]:[细节]
2. [行动 2]:[细节]
3. [行动 3]:[细节]
**输出**:[此阶段后拥有的内容]
### 阶段 2:[名称]
**目标**:[要实现什么]
步骤:
1. [行动 1]:[细节]
2. [行动 2]:[细节]
**输出**:[此阶段后拥有的内容]
### 阶段 3:[名称]
**目标**:[要实现什么]
步骤:
1. [行动 1]:[细节]
2. [行动 2]:[细节]
**交付物**:[最终输出]
## 决策点
### 何时[决策]
- 如果[条件],则[选择 A]
- 如果[条件],则[选择 B]
## 质量门
每个阶段后,验证:
- [ ] [标准 1]
- [ ] [标准 2]
- [ ] [标准 3]
## 最佳实践
- **[实践]**:[为何重要]
- **[实践]**:[对质量的影响]
## 常见陷阱
- **陷阱**:[人们做错什么]
- **影响**:[发生什么]
- **解决方案**:[如何避免]
写作技巧
要具体
❌ “在使用数据库时使用” ✅ “在为PostgreSQL 14+生产数据库优化SQL查询时使用”
要可操作
❌ “考虑安全性” ✅ “运行OWASP ZAP扫描并审查所有HIGH严重性发现”
要有结构
使用一致的标题级别:
##用于主要章节###用于子章节####用于详细分解
使用视觉指示器
- ✅ 表示良好实践
- ❌ 表示反模式
- 🔍 表示调查步骤
- ⚠️ 表示警告
- 💡 表示提示
包含上下文
不要只列出要做什么——解释原因:
## 而不是:
- 使用连接池
## 写成:
- **使用连接池**(PostgreSQL使用pg-pool)
- 将连接开销减少80%
- 对于具有>100并发用户的应用程序至关重要
- 配置池大小 = (核心数 × 2) + effective_spindle_count
技能维护
何时更新
- 核心技术发布新版本
- 该领域出现更好的实践
- 用户反馈揭示差距
- 创建了相关技能(交叉引用)
版本控制
考虑添加到前言中:
---
name: 技能名称
description: 一行描述
---
技能集成
交叉引用
链接到相关技能:
## 相关技能
- 当问题出现时使用[[调试器技能]]
- 与[[性能工程师技能]]结合进行优化
- 设计验证前使用[[架构评审员技能]]
技能组合
复杂工作流程可以链接技能:
## 工作流程
1. 使用[[需求分析师]]收集需求
2. 应用此技能进行实施
3. 使用[[代码审查员]]进行质量保证
4. 使用[[部署工程师]]进行部署
示例
示例 1:创建Python专家技能
上下文:需要用于高级Python开发的技能
流程:
- 定义范围:Python 3.11+,专注于FastAPI和类型安全
- 识别触发器:“现代Python”、“类型提示”、“FastAPI”
- 构建核心能力:
- Python 3.11+ 功能(match语句、类型改进)
- FastAPI框架模式
- 类型注解最佳实践
- 添加工作流程:设计API → 类型模型 → 实现路由 → 测试
- 包含示例:具有完整类型注解的FastAPI路由
结果:一个专注、可操作的现代Python开发技能
示例 2:创建Git工作流程技能
上下文:需要编码团队的git分支策略
流程:
- 定义范围:用于功能开发的Git工作流程
- 识别触发器:“创建分支”、“创建PR”、“git工作流程”
- 构建为阶段:
- 分支创建
- 开发周期
- PR流程
- 合并策略
- 添加决策点:何时变基 vs 合并
- 包含示例:标准功能开发流程
结果:清晰的程序指南,用于一致的git使用
验证清单
在最终确定技能之前,检查:
结构
- [ ] 前言完整(名称、描述)
- [ ] 标题和目的清晰
- [ ] “使用时机”部分有具体触发器
- [ ] 核心能力定义良好
内容
- [ ] 信息准确且最新
- [ ] 示例真实且有用
- [ ] 最佳实践有理由
- [ ] 反模式显示替代方案
可用性
- [ ] 可以快速扫描和查找信息
- [ ] 章节流程合乎逻辑
- [ ] 格式一致
- [ ] 交叉引用正确
质量
- [ ] 没有拼写/语法错误
- [ ] 技术术语已定义
- [ ] 代码示例(如果有)正确
- [ ] 满足以上所有质量标准
元:关于此技能
此技能本身展示了它所教授的原则:
- 清晰的前言和结构
- 具体的“使用时机”触发器
- 可操作的工作流程
- 具体示例
- 质量标准
创建技能时,将此既作为指南又作为模板使用。