skill-creator

技能创建器

目的

一种元技能，用于指导创建高质量、高效的技能。提供模板、最佳实践和结构指南，帮助构建能够通过专业知识、工作流或工具集成增强 Claude 能力的技能。

适用场景

• 用户想要创建新技能
• 用户想要更新或改进现有技能
• 用户询问如何组织技能文档
• 需要为特定领域或工作流设计技能
• 希望确保技能遵循最佳实践

技能核心结构

必需组件

每个技能都必须包含以下元素：

1. Frontmatter

   ---
   name: skill-name
   description: One-line description when to use this skill
   ---
   

2. 标题与目的

   # Skill Name
   
   ## Purpose
   Clear, concise statement of what this skill does
   

3. 适用场景

   ## When to Use
   - Specific trigger 1
   - Specific trigger 2
   - Context where this helps
   

4. 核心能力

   ## Core Capabilities
   
   ### Domain Expertise
   - Key knowledge area 1
   - Key knowledge area 2
   
   ### Tools & Methods
   - Specific techniques
   - Frameworks used
   

可选但推荐的组件

5. 工作流

   ## Workflow
   
   1. Step 1: What to do first
   2. Step 2: Next action
   3. Step 3: Final deliverable
   

6. 最佳实践

   ## Best Practices
   
   - Do this
   - Avoid that
   - Remember this
   

7. 示例

   ## Examples
   
   ### Example 1: Common Use Case
   **Input**: User request
   **Approach**: How to handle
   **Output**: Expected result
   

8. 反模式

   ## Anti-Patterns
   
   ❌ **Don't**: Bad practice
   ✅ **Do**: Good alternative
   

技能创建工作流

步骤 1：定义范围

问问自己：

• 这个技能解决什么问题？
• 谁会使用它？
• 什么情况会触发它？
• 预期结果是什么？

步骤 2：确定核心知识

记录：

• 领域专用术语
• 关键概念和原则
• 该领域的常见模式
• 涉及的工具和技术

步骤 3：组织工作流

梳理：

• 进入条件
• 逐步流程
• 决策点
• 退出标准和交付物

步骤 4：添加实用内容

包括：

• 真实示例
• 需要避免的常见陷阱
• 该领域的最佳实践
• 质量标准

步骤 5：编写明确的触发条件

让“适用场景”具体明确：

• ✅“用户需要针对 PostgreSQL 数据库优化 SQL 查询”

• ❌“用户需要数据库方面的帮助”

• ✅“调试分布式系统中的生产故障”

• ❌“修复 Bug”

技能质量标准

清晰度

• 名称一目了然
• 描述清楚说明适用场景
• 用 1-2 句话说明目的
• 不使用未经解释的行话

完整性

• 包含所有必需章节
• 工作流可实际执行
• 示例涵盖常见情况
• 已考虑边缘情况

具体性

• 触发条件具体明确
• 步骤足够详细，便于遵循
• 明确列出工具和方法
• 定义成功标准

易用性

• 易于浏览和查找
• 格式一致
• 章节顺序合理
• 在有帮助时添加交叉引用

技能模板

技术领域技能模板

---
name: domain-expert
description: Use when user needs [specific technical task] in [technology/domain]
---

# Domain Expert

## Purpose

Expert in [domain] specializing in [specific areas]. Helps with [key problems solved].

## When to Use

- User needs [specific task 1]
- Working with [technology] and needs [help type]
- Troubleshooting [specific problem type]
- Designing [architectural element]

## Core Capabilities

### [Domain] Expertise
- [Technology 1] - [version/specifics]
- [Technology 2] - [what aspects]
- [Pattern/practice] - [when/how]

### Key Techniques
- **[Technique 1]**: [What it solves]
- **[Technique 2]**: [When to use]
- **[Technique 3]**: [How it helps]

## Workflow

1. **Understand Requirements**
   - Clarify [specific aspects]
   - Identify [constraints]

2. **Apply [Domain] Patterns**
   - Use [pattern 1] for [scenario]
   - Consider [trade-off]

3. **Implement Solution**
   - Follow [best practice]
   - Ensure [quality criteria]

4. **Validate**
   - Test [aspects]
   - Verify [requirements met]

## Best Practices

- **[Practice 1]**: [Reasoning]
- **[Practice 2]**: [Benefit]
- **[Practice 3]**: [Why important]

## Common Patterns

### [Pattern 1]
**When**: [Scenario]
**How**: [Implementation approach]
**Why**: [Benefits]

### [Pattern 2]
**When**: [Scenario]
**How**: [Implementation approach]
**Why**: [Benefits]

## Anti-Patterns

❌ **Don't**: [Bad practice]
   - Why it fails: [Reason]
   - Better approach: [Alternative]

❌ **Avoid**: [Common mistake]
   - Problem: [What goes wrong]
   - Instead: [Correct way]

## Examples

### Example 1: [Common Scenario]
**Context**: [Situation]
**Approach**: [Solution steps]
**Result**: [Outcome]

## Tools & Technologies

- **[Tool 1]**: [Version] - [Use for what]
- **[Tool 2]**: [Version] - [Use for what]
- **[Framework]**: [Version] - [Key features used]

流程/工作流技能模板

---
name: process-specialist
description: Use when user needs [specific process/workflow] for [outcome]
---

# Process Specialist

## Purpose

Guides [specific process] to achieve [specific outcome]. Ensures [quality aspects] through [methodology].

## When to Use

- Need to [execute process]
- Want to ensure [quality outcome]
- Working on [scenario requiring this process]

## Core Process

### Phase 1: [Name]
**Goal**: [What to achieve]

Steps:
1. [Action 1]: [Details]
2. [Action 2]: [Details]
3. [Action 3]: [Details]

**Outputs**: [What you have after this phase]

### Phase 2: [Name]
**Goal**: [What to achieve]

Steps:
1. [Action 1]: [Details]
2. [Action 2]: [Details]

**Outputs**: [What you have after this phase]

### Phase 3: [Name]
**Goal**: [What to achieve]

Steps:
1. [Action 1]: [Details]
2. [Action 2]: [Details]

**Deliverable**: [Final output]

## Decision Points

### When to [Decision]
- If [condition], then [choice A]
- If [condition], then [choice B]

## Quality Gates

After each phase, verify:
- [ ] [Criterion 1]
- [ ] [Criterion 2]
- [ ] [Criterion 3]

## Best Practices

- **[Practice]**: [Why it matters]
- **[Practice]**: [Impact on quality]

## Common Pitfalls

- **Pitfall**: [What people do wrong]
  - **Impact**: [What happens]
  - **Solution**: [How to avoid]

写作提示

明确具体

❌“在处理数据库时使用” ✅“在优化 PostgreSQL 14+ 生产数据库的 SQL 查询时使用”

具备可操作性

❌“考虑安全性” ✅“运行 OWASP ZAP 扫描，并检查所有高危级别的发现”

结构清晰

使用一致的标题层级：

• ## 用于主要章节
• ### 用于子章节
• #### 用于详细分类

使用视觉标记

• ✅ 表示良好实践
• ❌ 表示反模式
• 🔍 表示调查步骤
• ⚠️ 表示警告
• 💡 表示提示

补充背景

不要只列出要做什么，还要解释原因：

## Instead of:
- Use connection pooling

## Write:
- **Use connection pooling** (pg-pool for PostgreSQL)
  - Reduces connection overhead by 80%
  - Critical for applications with >100 concurrent users
  - Configure pool size = (core count × 2) + effective_spindle_count

技能维护

更新时机

• 核心技术发布新版本
• 该领域出现更好的实践
• 用户反馈暴露出不足
• 创建了相关技能（进行交叉引用）

版本控制

考虑在 frontmatter 中添加：

---
name: skill-name
description: One-line description
---

技能集成

交叉引用

链接到相关技能：

## Related Skills
- Use [[debugger-skill]] when issues arise
- Combine with [[performance-engineer-skill]] for optimization
- Precede with [[architect-reviewer-skill]] for design validation

技能组合

复杂工作流可以串联多个技能：

## Workflow
1. Use [[requirement-analyst]] to gather needs
2. Apply this skill for implementation
3. Use [[code-reviewer]] for quality assurance
4. Use [[deployment-engineer]] to ship

示例

示例 1：创建 Python Pro 技能

背景：需要一项用于高级 Python 开发的技能

流程：

1. 定义范围：Python 3.11+，重点关注 FastAPI 和类型安全
2. 确定触发条件：“modern Python”、“type hints”、“FastAPI”
3. 规划核心能力：
   • Python 3.11+ 功能（match 语句、typing 改进）
   • FastAPI 框架模式
   • 类型注解最佳实践
4. 添加工作流：设计 API → 定义类型模型 → 实现路由 → 测试
5. 添加示例：包含完整类型注解的 FastAPI 路由

结果：一项专注且可操作的现代 Python 开发技能

示例 2：创建 Git 工作流技能

背景：需要将团队的 Git 分支策略规范化

流程：

1. 定义范围：用于功能开发的 Git 工作流
2. 确定触发条件：“create branch”、“make PR”、“git workflow”
3. 按阶段组织：
   • 创建分支
   • 开发周期
   • PR 流程
   • 合并策略
4. 添加决策点：何时使用 rebase，何时使用 merge
5. 添加示例：标准功能开发流程

结果：清晰的流程指南，帮助一致地使用 Git

验证清单

完成技能前，请检查：

结构

• Frontmatter 完整（name、description）
• 标题和用途清晰
• “使用时机”部分包含具体触发条件
• 核心能力定义明确

内容

• 信息准确且最新
• 示例贴近实际且有帮助
• 最佳实践有充分依据
• 反模式展示了替代方案

易用性

• 能快速浏览并找到信息
• 各部分逻辑连贯
• 格式一致
• 交叉引用正确

质量

• 没有拼写或语法错误
• 技术术语均有定义
• 代码示例（如有）正确
• 符合上述所有质量标准

补充：关于此技能

此技能本身展示了其所传授的原则：

• 清晰的 Frontmatter 和结构
• 具体的“使用时机”触发条件
• 可操作的工作流
• 具体示例
• 质量标准

创建技能时，可将此内容同时用作指南和模板。