skills-create

Skills Create——元技能

一个用于编写和重构技能的技能。有两项用途：

• 创建全新的技能（或基于现有提示词/命令创建）。
• 重构臃肿的技能——将详细内容拆分到 references/，将输出格式移入 templates/，把 SKILL.md 精简为简洁的指引骨架。

**它的构建方式正如它教导的那样：**精简的正文将详细内容交由 references/ 承载。这就是渐进式披露，而这个技能本身就是一个完整的示例。**它完全由可组合的 Markdown 构成：**一个技能由 SKILL.md 和可选文件组成，Agent 只会在需要时加载这些文件。

规定方法，不规定内容

严格规定技能的构建方式，但不限定任何特定技能或其输出应包含什么。

• **明确规定（严格、普适）：**渐进式披露 · 使用第三人称、包含丰富触发条件的 description · 使用祈使语气、保持正文精简 · 不重复 · 每个附带文件都要有明确引用 · 有意控制调用方式 · 验证方式应与技能类型相符。（参见 references/skill-standards.md。）
• **不要规定（由作者决定）：**计划/PRD/报告应包含哪些章节、领域词汇、输出格式、包含哪些阶段。不存在标准输出——应引导作者做出好的决定，而不是给出固定格式。

严格规定方法，让作者能自由决定内容。（引导，而非规定——关于“采用还是自建”：如果你负责该流程，并希望它遵循你的方式，就应该自建技能。）

先对技能分类

应用方法前，先确定技能的类型——指导应与类型相称，而非一刀切：

类型	定义	应用方式
工作流	多步骤流程（计划、审查、发布）	应用完整的方法，包括可验证的验证关卡
产物生成器	生成文档/输出	Context-is-King + 建议但不强制的输出格式
知识 / 参考	Agent 查阅的事实信息	Context-is-King + 信息密集；不设阶段，不设验证循环
工具封装器	驱动脚本 / CLI / API	使用确定性脚本 + 明确的触发条件；验证方式 = 工具自身的退出代码

一个技能可以混合多种类型——应用所有适用的方法。切勿把工作流的机制（阶段、循环、输出框架）强加给知识类技能。完整详情：references/skill-standards.md → Skill types。

第 0 步——选择模式（从 $ARGUMENTS 中解析）

解析 $ARGUMENTS 以选择模式和目标：

• 以 create [<name>] 开头（或明确要求创建新技能）→ 进入创建模式；如果指定了 <name>，就将其用作技能名称 → 遵循 references/creating-skills.md。
• 以 refactor <path/to/SKILL.md> 开头（或指向现有技能）→ 对该路径进入重构模式 → 遵循 references/refactoring-skills.md。
• 为空或不明确 → 询问用户要选择哪种模式，以及技能/目标是什么。不要猜测。

两种模式都遵循相同的方法规则 → 先阅读 references/skill-standards.md。

创建——简要骨架（完整详情：references/creating-skills.md）

1. 收集上下文——应触发技能的具体短语、从开始到结束的任务、注意事项、应参照的模式。询问用户；先不要编写。
2. 规划资源——重复执行的内容 → scripts/；为工作提供参考的内容 → references/；用于塑造输出的内容 → templates/；不由你负责或会在上游变化的内容 → 引用路径/URL；仅在运行时存在的内容 → 收集起来（询问用户、读取 git/代码库）。
3. 搭建框架——将 templates/SKILL.template.md 复制到 .claude/skills/<name>/SKILL.md；仅在计划需要时添加 references/ / templates/。
4. 先编写骨架——使用第三人称、包含丰富触发条件的 description；使用祈使语气并保持正文精简；将详细内容移至参考资料。先确保它能正确触发，再编写参考资料。
5. 验证并迭代——使用 references/validation.md（检查清单 → 触发测试 → 实际运行）。

重构——快速流程（完整详情：references/refactoring-skills.md）

1. 盘点 SKILL.md——将每个区块标记为 核心内容（保留）或 可提取内容（输出模板、架构、长篇示例、详尽的模式／边缘情况列表）。
2. 原样提取到目标技能的 references/（或存放输出格式的 templates/）中——不要改写任何会影响行为的内容。
3. 替换为指针——对于始终需要的内容，添加一行必读说明（“生成输出前，请阅读 templates/<x>.md”）；对于偶尔需要的内容，添加延迟加载指针。
4. 行为保留检查——流程不变，输出与之前相同。不遗漏，不重复。
5. 验证——references/validation.md。

**重构的第一大风险：**将始终需要的输出格式移到延迟加载的参考文档中，导致 Agent 忘记阅读，输出悄然发生变化。提取此类内容时，务必同时添加必读说明。

何时应该构建技能

当你负责某个流程，并希望 Agent 反复遵循你的做法时，就应该构建技能——这就是“自用还是构建”规则。一个粗略的门槛：同一件事你已经提示过约 3 次（“三次规则”）→ 将其沉淀为技能。 不要为一次性需求构建技能，也不要为所有者已经提供了优质技能的工具构建技能。

资源

• references/skill-standards.md — 编写规范：技能类型、结构、上下文来源、frontmatter 规范、渐进式披露、写作语气、避免重复、“结构意味着维护者”、连接方式、可移植性。
• references/creating-skills.md — 完整的创建操作手册（包括移植现有提示词／命令）。
• references/refactoring-skills.md — 完整的拆分与精简操作手册，附带前后对比。
• references/validation.md — 验证关卡（结构 · 描述 · 正文 · 披露 · 行为 · 触发测试）。
• templates/SKILL.template.md — 用于搭建技能的精简 SKILL.md 骨架。