1. 引言
Claude Code 是 Anthropic 推出的命令行 AI 编程助手，而Skill（技能）是它最强大的扩展机制之一。它让 Claude 从“只会聊天”进化为“真正会干活”——能按你的项目规范执行任务、调用自定义工具、操作文件、运行命令，甚至编排复杂的开发流程。
本文将从使用和原理两个维度，带你系统理解 Claude Code 的 Skill：先讲清楚它是什么、怎么创建和调用，再深入剖析它背后的运行机制，最后给出设计最佳实践。
2. 什么是 Claude Code Skill
Claude Code Skill 是指赋予 Claude 的一组可复用、可组合、可调用的能力单元。如果说 Claude 是智能体的“大脑”，那么 Skill 就是大脑可以灵活支配的“手脚”。
一个 Skill 通常包含以下要素：
- 触发条件：什么情况下该技能被调用
- 输入参数：技能执行所需的必要信息
- 执行逻辑：技能内部的处理步骤或调用链
- 输出结果：技能执行完成后返回的结构化结果
- 元信息：技能的名称、描述、版本、依赖关系等
在 Claude Code 中，Skill 以SKILL.md 文件为核心载体，存放在.claude/skills/目录下，每个技能一个子目录。
3. 从使用视角看 Claude Code Skill
3.1 一个 Skill 长什么样
以最常见的“代码审查”技能为例，一个 Skill 由SKILL.md描述文件和可选的辅助脚本组成：
# 目录结构 .claude/skills/ └── code-review/ ├── SKILL.md # 技能描述与使用说明 └── review.py # 可选的辅助脚本SKILL.md的核心内容如下：
--- name: code-review description: 对指定代码文件进行系统性审查，检查代码质量、潜在 Bug 与安全隐患。当用户要求“审查代码”“review 代码”时使用。 --- # 代码审查技能 ## 使用步骤 1. 读取目标文件 2. 检查代码质量、潜在 Bug、安全隐患 3. 输出结构化审查报告 ## 注意事项 - 优先关注安全漏洞与性能问题 - 报告使用 Markdown 表格呈现3.2 如何创建与启用 Skill
在 Claude Code 中，创建 Skill 只需三步：
# 1. 创建技能目录mkdir-p.claude/skills/code-review# 2. 编写 SKILL.md 描述文件# 3. 重启 Claude Code，技能自动加载# 查看已加载的技能claude --list-skills创建完成后，你只需在对话中说“帮我 review 一下main.py”，Claude 就会自动匹配并调用该技能，无需手动指定。
3.3 多技能编排
复杂任务往往需要多个 Skill 协作完成。以下是一个“提交 PR 前检查”的流水线示例：
# 示例：组合多个 Skill 完成复杂任务.claude/skills/ ├── lint-check/# 代码规范检查├── test-runner/# 测试执行└── pr-summary/# PR 摘要生成当用户说“帮我准备提交 PR”，Claude 会依次调用lint-check→test-runner→pr-summary，完成从检查到生成摘要的完整流程。
4. 从原理视角看 Claude Code Skill
理解了“怎么用”，我们再深入一层，看看 Claude Code Skill 在系统内部是如何工作的。
4.1 核心运行流程
4.2 技能匹配：Claude 如何“知道”该调用哪个技能
这是 Skill 最核心的机制。Claude Code 启动时会扫描.claude/skills/目录，将每个技能的name和description注入系统提示词。当用户提出任务后，Claude 会结合这些技能清单，判断当前任务是否需要调用技能、调用哪个技能。
这一过程本质上是函数调用（Function Calling）：Claude 输出一个结构化的调用意图，包含技能名称和参数，Claude Code 再据此执行对应的技能逻辑。
4.3 参数提取：从对话中“抠”出输入
Claude 需要从用户对话中提取技能所需的参数。例如用户说“帮我审查一下src/auth.py这个文件”，模型需要推断出：
file_path=src/auth.pyfocus= “安全审查”（根据上下文推断）
SKILL.md中description写得越清晰（触发场景、参数含义），Claude 匹配和提取的准确率越高。
4.4 执行与结果回传
技能执行完成后，返回结果会作为上下文回传给 Claude。Claude 基于技能返回的结构化结果，结合原始任务，生成最终的自然语言回答。整个过程对用户是透明的——用户只看到“Claude 完成了任务”，而背后经历了意图识别、技能匹配、参数提取、执行、结果整合等多个环节。
5. 设计一个好的 Claude Code Skill
5.1 单一职责
每个 Skill 只做一件事，并把这件事做好。职责单一不仅便于维护，也让 Claude 更容易理解“何时该调用它”。
5.2 描述要具体
description要写清楚“在什么场景下、解决什么问题、怎么用”。避免模糊表述，例如“处理代码”就不如“对指定文件进行代码审查，检查潜在 Bug 与安全隐患，适用于提交 PR 前”清晰。
5.3 参数要精简
参数越少越好，能自动推断的就不让调用方传。每个多余参数都会增加 Claude 调用的出错概率。
5.4 输出要结构化
尽量返回结构化的 Markdown 或明确的数据对象，避免返回大段无格式文本，方便 Claude 后续解析与整合。
5.5 做好错误处理
技能内部要处理异常情况，并返回明确的错误信息，帮助 Claude 判断是重试、换方案还是向用户说明。
6. 总结
Claude Code Skill 是连接 Claude 能力与真实开发流程的桥梁。从使用层面看，它让开发者可以用极低的成本为 Claude 扩展能力；从原理层面看，它依赖 Claude 的函数调用机制，通过“意图识别 → 技能匹配 → 读取 SKILL.md → 执行 → 结果整合”的闭环，让 Claude 真正参与到开发流程中。
在实际项目中，建议从高频、重复、边界清晰的任务入手，逐步沉淀技能库，再通过编排组合释放更大的价值。
