skill-creator

用途

Skill Creator 是一个“元技能”，用于指导创建高质量、有效的技能（skill）。当用户希望创建新技能，或更新、改进已有技能以扩展 Claude 的能力时，可借助它获得模板、最佳实践与结构规范。这些技能用于为 Claude 补充专门的知识、工作流或工具集成。

使用时机

资料列出的典型触发场景包括：用户想要创建新技能；用户想要更新或改进已有技能；用户询问如何组织技能文档结构；需要为特定领域或工作流设计技能；希望确保技能符合最佳实践。

核心技能结构

必需组件

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

Frontmatter：

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

标题与用途：

# Skill Name

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

使用时机（When to Use）：包含具体触发条件与适用上下文。
核心能力（Core Capabilities）：包含领域专长（关键知识领域）以及工具与方法（具体技术、所用框架）。

可选但推荐的组件

工作流（Workflow）：按步骤描述先做什么、下一步动作、最终交付物。
最佳实践（Best Practices）：建议做什么、避免什么、需要记住什么。
示例（Examples）：包含常见用例的输入、处理方式与预期结果。
反模式（Anti-Patterns）：用 ❌ 标注不良做法，用 ✅ 标注良好替代方案。

技能创建流程

定义范围：这个技能解决什么问题、谁会用、什么触发它、预期结果是什么。
梳理核心知识：领域专有术语、关键概念与原则、该领域常见模式、涉及的工具与技术。
组织工作流：入口条件、逐步流程、决策点、退出条件与交付物。
加入实践要素：真实示例、常见陷阱、领域最佳实践、质量标准。
编写明确的触发条件：把“使用时机”写具体。资料给出的示例是：✅ “User needs SQL query optimization for PostgreSQL databases”，❌ “User needs database help”；✅ “Debugging production outages in distributed systems”，❌ “Fixing bugs”。

技能质量标准

资料列出四类标准：

清晰性：名称可自解释、描述明确说明何时使用、用途用 1—2 句表述、无未解释的行话。
完整性：包含所有必需部分、工作流可执行、示例覆盖常见情况、涉及边界情况。
具体性：触发条件具体、步骤足够详细可跟随、明确指出工具/方法、定义成功标准。
可用性：易于浏览和查找、格式一致、章节顺序合理、在有用处提供交叉引用。

技能模板

资料提供两类模板。

技术领域技能模板

Frontmatter 后依次包含：Purpose、When to Use、Core Capabilities（领域专长与关键技术）、Workflow（理解需求 → 应用领域模式 → 实现方案 → 验证）、Best Practices、Common Patterns（每种模式说明 When / How / Why）、Anti-Patterns、Examples、Tools & Technologies。

流程/工作流技能模板

Frontmatter 后依次包含：Purpose、When to Use、Core Process（分阶段，每个阶段含 Goal、Steps、Outputs/Deliverable）、Decision Points（在什么条件下选择 A 或 B）、Quality Gates（每阶段后用清单验证）、Best Practices、Common Pitfalls（陷阱、影响、解决方案）。

写作技巧

具体化：❌ “Use when working with databases”，✅ “Use when optimizing SQL queries for PostgreSQL 14+ production databases”。
可执行：❌ “Think about security”，✅ “Run OWASP ZAP scan and review all HIGH severity findings”。
结构化：用一致标题层级，## 表示主要章节、### 表示子章节、#### 表示更细拆分。
使用视觉标识：✅ 良好实践、❌ 反模式、🔍 调查步骤、⚠️ 警告、💡 提示。
包含上下文：不只列做什么，还解释为什么。资料示例为：写“Use connection pooling (pg-pool for PostgreSQL)”，并说明可减少连接开销、适合并发用户多的应用、池大小配置为 (core count × 2) + effective_spindle_count。

技能维护

资料给出的更新时机包括：核心技术发布新版本、领域出现更好实践、用户反馈暴露缺口、创建了相关技能需要交叉引用。关于版本控制，资料仅提到可考虑在 frontmatter 中补充相关字段，未给出具体字段内容。

技能集成

交叉引用：可链接相关技能，例如用 [[debugger-skill]] 处理出现的问题、与 [[performance-engineer-skill]] 组合做优化、在前面接 [[architect-reviewer-skill]] 做设计验证。
技能组合：复杂工作流可串联技能，例如先用 [[requirement-analyst]] 收集需求、再用本技能实现、然后用 [[code-reviewer]] 做质量保障、最后由 [[deployment-engineer]] 发布。

示例

资料给出两个示例。

示例一：创建一个 Python Pro 技能。上下文是需要一个面向高级 Python 开发的技能。过程：定义范围为 Python 3.11+，聚焦 FastAPI 与类型安全；识别触发词“modern Python”“type hints”“FastAPI”；组织核心能力为 Python 3.11+ 特性（match 语句、类型改进）、FastAPI 框架模式、类型注解最佳实践；加入工作流：设计 API → 类型建模 → 实现路由 → 测试；加入示例：带完整类型注解的 FastAPI 路由。结果是形成聚焦、可执行的现代 Python 开发技能。

示例二：创建一个 Git 工作流技能。上下文是需要固化团队的 git 分支策略。过程：定义范围为功能开发的 Git 工作流；识别触发词“create branch”“make PR”“git workflow”；按阶段组织为分支创建、开发循环、PR 流程、合并策略；加入决策点：何时 rebase、何时 merge；加入示例：标准功能开发流程。结果是形成清晰、一致使用 git 的流程指南。

验证清单

最终确定技能前需要检查：

结构：frontmatter 完整（name、description）、标题与用途清晰、“When to Use”有具体触发条件、核心能力定义明确。
内容：信息准确且最新、示例真实有帮助、最佳实践有理由、反模式给出替代方案。
可用性：能快速扫描并找到信息、章节顺序合理、格式一致、交叉引用正确。
质量：无拼写/语法错误、技术术语有定义、代码示例（如有）正确、满足上述全部质量标准。

关于该技能本身

资料称，该技能本身演示了它所教授的原则：清晰的 frontmatter 与结构、具体的“When to Use”触发条件、可执行的工作流、具体示例、质量标准。创建技能时，可将其同时作为指南和模板使用。

限制

资料未提供安装命令、运行环境要求、支持的平台、收费与价格信息，也未提供官方文档之外的更多使用步骤。