Claude Code Skills 技能扩展机制 Skill 技能

技能简介

Claude Code Skills（Agent Skills）是 Anthropic 为 Claude Code 打造的技能扩展机制。它用一份 SKILL.md 文件把"一段反复粘贴的指令、清单或多步骤流程"固化成可复用的能力包，Claude 在相关场景会自动加载，也可以由你用 /技能名 直接调用。它解决的是"同一个流程每次都要重新讲一遍"的痛点：以往这些内容只能塞进 CLAUDE.md 或对话历史里，而技能正文只在被使用的那一刻才加载，因此再长的参考资料平时几乎不占上下文成本。技能遵循 Agent Skills 开放标准，同一份技能可以跨多个 AI 工具使用，Claude Code 在此之上补充了调用控制、子代理执行和动态上下文注入等能力。

核心能力

• 按需加载：技能正文只在被触发时进入上下文，长文档不再挤占日常对话的窗口。
• 自动或手动调用：Claude 依据 frontmatter 中的 description 判断何时自动加载，你也能用 /技能名 精确唤起。
• 自定义命令合一：原有 .claude/commands/deploy.md 写法与 .claude/skills/deploy/SKILL.md 等价，旧命令文件继续可用。
• 支持配套文件：技能目录除 SKILL.md 外可放脚本、模板、参考资料，由技能按需读取。
• 调用权限可控：通过 frontmatter 决定某个技能只能由你手动触发，还是允许 Claude 自主加载。
• 子代理执行：可以让技能在独立子代理上下文中运行，避免污染主会话。
• 动态上下文注入：SKILL.md 里可以写 !命令，Claude Code 会先执行命令并把输出替换进去，让指令带着实时数据到达。
• 内置技能开箱可用：/doctor、/code-review、/batch、/debug、/loop、/run、/verify 等随客户端提供。

安装配置

• 确认版本：动态注入上下文等能力需要较新的 Claude Code 版本，建议先升级到当前稳定版。
• 选择放置位置：个人技能放 ~/.claude/skills//SKILL.md，仅本机所有项目可用；项目技能放仓库内 .claude/skills//SKILL.md 并提交到版本库，团队共享。
• 组织级分发：企业可将技能放在受管设置目录，统一推送到组织内所有机器。
• 插件方式分发：打包为插件时技能位于 /skills//SKILL.md，可随插件安装。
• 关闭内置技能：不需要内置技能时，在设置里通过 disableBundledSkills 关闭。

使用步骤

1. 建目录：例如 mkdir -p ~/.claude/skills/summarize-changes，目录名就是将来输入的命令名。
2. 写 SKILL.md：文件由两部分组成，--- 包裹的 YAML frontmatter 告诉 Claude 何时该用这个技能，下面的 Markdown 正文是执行时要遵循的指令。
3. 填 description：把"什么场景下该加载"写清楚，Claude 靠它做自动判断。
4. 注入实时数据：在正文里写 !git diff HEAD 这类语句，命令输出会在 Claude 阅读前内联到技能内容中。
5. 验证：打开一个 git 项目改一行代码，先直接问"我改了什么"验证自动加载，再用 /summarize-changes 验证手动调用。

适用场景

• 代码审查：把团队的检查清单固化成技能，提交前统一跑一遍风险项。
• 变更总结与提交信息：自动读取当前工作区 diff，生成规范的提交说明。
• 部署流程：把构建、发布、回滚步骤写成技能，避免每次凭记忆操作。
• 项目启动与验证：用 /run-skill-generator 记录本项目的安装命令、环境变量和启动脚本，之后 /run、/verify 直接照方执行。
• 长文档检索：把接口文档、内部规范放进技能目录，需要时再加载，平时不占上下文。
• 团队规范落地：技能随仓库提交，新人拉下代码即获得同样的操作手册。

适用人群

• 每天使用 Claude Code 的开发者，尤其是需要反复执行同一套流程的人。
• 需要统一工程规范的研发团队与技术负责人。
• 为企业内部搭建 AI 编码工作流、希望集中分发指令的工程效能团队。
• 编写和维护 AI 工具链插件的工具作者。

工作原理

技能本质是一份放在约定目录下的 Markdown 文件。Claude Code 启动时只读取各技能的元信息，正文留在磁盘上；当你的请求与某个技能的 description 匹配，或你显式输入 /技能名，客户端才把该 SKILL.md 的内容加载进上下文。动态上下文注入发生在加载阶段：! 反引号包裹的命令先被执行，输出替换掉原语句，因此 Claude 看到的是已经填好实时数据（比如当前 diff、当前分支）的指令。插件、受管设置和企业目录都只是不同的分发渠道，最终都归入同一套发现与加载逻辑，因此同一技能可以在个人、项目和组织层面复用而无需改写。

官方链接

• 官方文档：https://code.claude.com/docs/en/skills
• 开放标准：https://agentskills.io