Claude Code Skills 怎么用？

Claude Code Skills 怎么用：先确认有哪些可调用

在 Claude Code 会话中输入 /skills，可以查看当前会话可用的 Skills；官方文档说明，这个列表也支持按名称、描述或来源筛选。你也可以在输入框键入 /，查看命令菜单中的可用命令，再输入名称的一部分进行筛选。菜单和列表能帮你确认技能是否可见，但“出现在列表里”只代表可用，不代表它已经用于某项任务。

Skill 名称就是调用时使用的名称，通常能在 /skills 列表中找到。项目 Skill、个人 Skill 和插件 Skill 的名称形式可能不同；如果列表中出现带命名空间的名称，应按列表里显示的完整名称调用，不要凭文件名猜。Skill 与普通斜杠命令在使用形式上相似，输入名称后都可以附上任务参数；内置命令参考会把捆绑 Skill 标出。

如果预期的 Skill 没有显示，先确认当前会话是否识别它、名称是否输入正确，以及它是否对当前环境可用。Skill 在会话启动后新增或修改时，通常可以在会话中被检测到；但如果是此前不存在、后来才新建的顶层 Skills 目录，官方文档建议运行 /reload-skills 重新扫描。这里讨论的是识别与调用，不是创建 Skill 的文件编写步骤。

Skill 应该手动调用，还是让它自动触发？

任务和 Skill 的用途明确对应时，建议手动调用。例如你已经知道某个 Skill 专门负责检查改动，就在输入框里输入 /技能名称，后面接上要检查的内容。官方文档也支持将 Skill 调用与参数写在一起，例如 /claude-api migrate；命令参考还说明，多个 Skill 可以在一条输入中链接，后续文本会作为参数传递，最多可链接六个。是否需要串联多个 Skill，应以任务确实需要为前提，不必为了使用功能而堆叠调用。

如果任务比较自然地对应某个 Skill 的用途描述，也可以直接用普通语言提出需求，让 Claude Code 判断是否自动使用。Claude Code 会参考 Skill 的描述和适用场景来决定何时加载；因此描述越贴近真实任务，自动选择越有可能发生。不过自动触发不是对每条消息的保证：如果任务说法含糊、Skill 描述过宽或有多个相近候选，模型可能选错或不触发。希望流程确定时，直接点名更稳妥。

有些 Skill 会配置为只能由用户手动调用，Claude 不会自动加载；另一些则可能对用户隐藏，不能通过普通命令菜单手动启动。官方文档将这些行为作为 Skill 的调用控制选项说明。遇到“知道 Skill 存在，却无法按预期自动触发或手动调用”的情况，先检查 /skills 中的可见状态和对应配置，不要直接断定功能失效。

怎样把 Skill 用在一次编码任务里？

假设当前会话中有一个用于检查 API 代码约定的 Skill。与其只输入 Skill 名称，不如把具体任务一起交代清楚，例如：

/api-check 检查 src/routes/profile.ts 的接口改动。重点核对参数校验、错误响应和现有项目约定。先报告问题与依据，不要直接修改文件；如果没有发现问题，也请说明检查范围。

这个示例假设 /api-check 已经存在且名称可用，并不代表 Claude Code 自带该名称。提示中包含了技能调用、文件范围、检查重点和操作边界。Skill 提供的是一套可复用的指令，项目实际情况仍要在当前会话中说明；文件路径、目标分支、不能修改的区域等上下文，不应指望 Skill 自动猜中。

如果希望它直接修复问题，可以把任务拆成检查和修改两段：先让它列出发现及依据，再确认要处理的项目，并要求只修改指定范围。这样便于先判断 Skill 的检查结果是否相关，也能减少一次请求同时包含分析、修改和验证而带来的边界不清。最终是否采用建议，应结合代码上下文自行判断。

怎么确认 Claude Code 确实使用了 Skill？

先区分“技能可用”与“技能已被执行”。/skills 用来查看可用列表，不是调用记录。显式输入 /技能名称 是较明确的调用方式；自动触发则由 Claude Code 根据当前任务判断。本文所依据的官方说明介绍了查看、调用和自动加载机制，但没有把“回复中提到技能名称”规定为可靠的执行凭证，因此不要把这句话当作验证结论。

更实际的核对方式是检查结果是否符合 Skill 应该执行的工作：它是否覆盖了你指定的文件和检查点，是否遵守了“不修改文件”等限制，结论是否能指出代码依据。若任务包含代码改动，再查看实际差异，并按项目已有流程运行适当的检查。Claude Code 官方命令参考提供 /diff 查看工作树更改的入口；具体检查命令仍要按项目配置和任务情况选择。

如果结果不符合要求，指出具体偏差并补充约束，比笼统地说“重新做”更容易纠正。例如：“你漏看了错误响应处理，请只补查这一项；先给出对应代码位置，不要改文件。”如果怀疑自动选择了不合适的流程，则改为显式调用目标 Skill，并把任务范围写清楚。检查结果仍应以代码和实际验证为准，而不是把 Skill 的调用本身当作质量保证。

Skill 没触发或效果不对，先排查什么？

• 列表里找不到：运行 /skills，按名称、描述或来源筛选；核对当前会话是否能看到它，以及输入名称是否与列表一致。
• 自动触发没有发生：把任务说得更具体，点明相关文件和工作目标；如果仍希望明确使用某项 Skill，直接输入其调用名称。
• 刚加了 Skill 但会话不认识：对于会话期间新建的顶层 Skills 目录，可按官方说明运行 /reload-skills 重新扫描。
• 调用了但结果不对：判断偏差来自任务上下文不足、检查范围不清，还是 Skill 的适用流程与目标不符；补充边界后重试，并核对具体产出。
• 有多个相近 Skill：点名希望使用的 Skill，并说明其他流程暂不需要；如果不确定哪个适合，先通过列表查看描述，再选择。

如果 Skill 指令与当前任务的明确要求不一致，也不一定是调用失败。例如 Skill 的常规流程要求提出修复建议，而你本次只想做只读检查，这时应在任务中明确要求只报告、不修改，并检查结果是否遵守该限制。不要只因 Claude 没有照搬常规流程就认定 Skill 未加载。

核对官方用法与适用范围

Claude Code 的 Skills 和命令行为可能随版本变化。本文依据 Anthropic Claude Code 中文官方文档中的 Skills 与 Commands 页面整理，核查日期为 2026 年 10 月 9 日；界面、可用命令和具体配置若与本机不同，应以当前会话中的 /skills、命令菜单及官方文档为准。关于 Skill 文件如何创建、编写和存放，属于另一个问题；本文聚焦的是识别、调用、自动触发和结果检查。