#技能创建与复用

#理解技能用途

技能用于保存一套可反复执行的工作方法，适合文档检查、变更摘要、接口说明整理和代码审查等流程。用户可直接调用技能，也可由 Claude 根据技能描述判断是否适用。

例如，检查项目说明时，若每次都需要核对安装步骤、运行命令、配置项和接口示例，可将这些步骤整理为技能。之后只需指定待检查的文档，即可沿用同一套处理标准。

技能与普通提示词的区别主要在于保存与复用方式。普通提示词通常服务于当前任务；技能保存在固定位置，可持续维护，并可附带参考资料或脚本。技能正文在调用时加载，有助于将详细流程与长期项目约定分开管理。

#创建首个技能

每项技能至少需要一个 SKILL.md 文件。个人技能保存在 ~/.claude/skills/ ，项目技能保存在项目内的 .claude/skills/。下面以项目文档检查为例。

1. 建立技能目录：在项目中创建 .claude/skills/review-docs/。
2. 填写技能文件：在该目录内创建 SKILL.md，写入技能说明与处理步骤。
3. 准备检查材料：确认项目中已有需要检查的文档及对应代码。
4. 执行小范围测试：先检查一份文档，确认结果符合预期后再扩大范围。

以下是可用于修改的最小示例：

---
name: review-docs
description: 检查项目文档与当前代码是否一致，并列出需要修订的位置。
disable-model-invocation: true
---

请检查 $ARGUMENTS 指定的项目文档。

## 检查步骤
1. 阅读指定文档，并定位直接相关的项目文件。
2. 核对安装步骤、运行命令、配置名称和接口示例。
3. 区分已经确认的差异与暂时缺少依据的内容。
4. 每项问题说明文档位置、核对依据和修改建议。

## 输出要求
先列出影响使用的问题，再列一般表述问题。
没有发现差异时，说明已检查的范围。
本次仅提供检查结果，不修改文件，不执行安装或发布操作。

示例中的 name 是调用名称，description 说明用途，正文规定执行步骤。$ARGUMENTS 接收调用时附加的内容。保存后，在 Claude Code 会话中输入：

/review-docs README.md

该示例预期得到文档差异清单，而非自动修订后的文件。此处仅演示设计方式，具体发现取决于实际文档与代码，并非实测结果。

#设置调用方式

默认情况下，用户与 Claude 均可调用技能。对于需要主动控制执行时机的流程，可使用 disable-model-invocation: true，使其由用户手动触发。

另一个字段 user-invocable: false 用于不需要直接显示为用户命令的背景知识技能；它不等同于禁止模型使用。两项设置解决的问题不同，不宜混用。

现有 .claude/commands/ 自定义命令仍可使用，但自定义命令已并入技能体系。新建可复用流程时，采用技能目录更便于同时维护指令与辅助材料。

#检查复用效果

技能应从实际重复任务中提炼。首次编写后，可分别选择正常材料、缺少信息的材料，以及包含明显问题的材料进行检查，观察它是否能够正确说明依据与边界。

若结果过于宽泛，应补充判断标准；若经常读取无关文件，应明确资料范围；若输出包含大量重复建议，应调整报告结构。修改技能时，应优先处理影响结果的步骤，避免持续增加无关说明。

请检查 {review-docs} 技能的执行结果。

当前问题：{建议较为笼统，未指出文档中的具体位置}。
调整目标：{每项问题均包含文件名、章节或行号，以及对应代码依据}。

请先修改技能说明，再使用{同一份测试文档}检查效果。
如果无法找到代码依据，应标注“待核实”，不得补写推测性结论。