
Claude Code 中的 Skills 是一套可定制化的扩展机制,本质是将专业知识、任务流程、可执行代码等打包成独立模块,供 Claude 根据上下文自动或手动调用,以完成特定专业任务。以下从核心定义、特性、结构、使用方式等方面详细介绍:
核心定义
Skills 是 Claude Code 的"能力单元封装器",以 Markdown 文件(通常为 SKILL.md)为核心载体,可包含指令、脚本、资源等,让 Claude 具备处理特定场景任务的专业能力,类似给 Claude 配备专属"专业工具包"。
核心特性
| 特性 | 说明 |
|---|---|
| 智能触发 | Claude 会根据任务需求和 Skill 的 description 字段自动匹配调用,也可通过斜杠命令手动触发,无需每次冗长描述需求。 |
| 按需加载 | 仅在任务匹配时加载所需信息,避免占用过多上下文资源,适合 token 敏感场景。 |
| 可组合性 | 多个 Skills 可像积木一样组合,形成完整任务流,Claude 自动协调执行顺序,如"读取 Excel→数据处理→生成图表→输出 PDF"。 |
| 跨平台复用 | 格式统一,一次构建可在 Claude Code、Claude 网页版、桌面应用及 API 中使用,支持 Git 版本控制,方便团队共享。 |
| 支持可执行代码 | 可嵌入 Python、Bash 等脚本,处理传统编程更高效的任务,如数据处理、文件操作,扩展 Claude 功能边界。 |
| 渐进式披露 | 启动时仅加载 Skill 名称和简介,调用时才加载详细内容,可装备大量 Skills 却几乎不占用上下文窗口。 |
基本结构
一个标准的 Skill 通常包含头部和正文两部分:
-
头部 :用三个短横线包裹,必须包含
name(技能名称)和description(技能描述,用于触发匹配)字段,示例如下:markdown--- name: code-review-expert description: 按照团队代码规范审查代码,识别潜在问题并给出优化建议 --- -
正文:一般包含技能说明、执行步骤、参考资料、可执行脚本等模块,用于指导 Claude 完成具体任务。
常见使用场景
- 代码审查:按团队规范自动审查代码,生成审查报告。
- 文档处理:创建、编辑、提取 PDF、DOCX、PPTX 等格式文档内容。
- 数据处理:操作 Excel 表格,进行数据分析、可视化与报表生成。
- 开发辅助:智能生成符合规范的 Git 提交信息、解释复杂代码逻辑等。
- 团队协作:封装项目接口规范、数据库设计准则等,供团队成员共享使用。
调用方式
- 自动调用:Claude 分析对话上下文,匹配 Skill 描述后自动加载执行,如输入"生成项目文档",自动调用文档生成 Skill。
- 手动调用 :通过斜杠命令直接触发,如
/commit生成 Git 提交信息、/explain解释代码逻辑。