Claude Code 技能

Claude Code 是技能最能发挥的地方，因为 CLI 给了技能真实的作用面：文件系统、shell、git 历史。写 changelog 的技能可以真的跑 git log；生成截图的技能可以真的存 PNG。同一个 SKILL.md 在 claude.ai 上只有指令，没有执行层。

两个磁盘位置要分清。~/.claude/skills/ 是用户级：每个会话、每个项目都可用——想到处都用的技能放这里。仓库内的 .claude/skills/ 是项目级：只对那个代码库生效，随团队偏好决定提交还是忽略。团队工作流技能放项目级；个人效率技能放用户级。

加载是渐进式的，和其他运行时一样：name 和 description 常驻上下文，SKILL.md 正文在触发时加载，附带脚本和 references 按需加载。装几十个技能也不用为每个会话付全量 token 成本。

Claude Code 有几个容易混淆的扩展点：

• 技能（Skills）——任务匹配时 Agent 主动应用的专业能力。你自然语言提需求，技能自己判断是否相关。
• 斜杠命令（Slash commands）——你显式输入的调用。/review 在你敲它时才运行，而不是 Agent 觉得有用时。
• Hooks——生命周期事件上触发的 shell 命令（工具调用前、文件写入后）。确定性自动化，不是判断。
• Subagents——拥有独立上下文窗口和工具白名单的单独 Agent，用来承接委派的子任务。
• 插件（Plugins）——打包层。一个插件可以把技能、命令、hooks 和 MCP server 打成一个可安装单元，通过市场分发。

口诀：是知识就是技能，是按键就是命令，是事件反应就是 hook，需要独立上下文就是 subagent。插件负责把以上任何一种打包分发。

三条路径，最快的在前：

# 1. skills CLI —— 从 GitHub 拷贝，跨运行时通用
npx skills add owner/repo

# 2. 手动 —— 把技能文件夹克隆到对应目录
cp -r path/to/skill-folder ~/.claude/skills/

# 3. 插件市场 —— 适用于打包成插件的技能
/plugin marketplace add owner/repo
/plugin install plugin-name@repo

装完任何一条都要开新会话——Claude Code 在会话启动时发现技能，会话中途装的技能要重启后才触发。npx skills CLI 是 GitHub 来源技能最不易出错的路径；自己在写技能、要就地迭代 SKILL.md 时手动拷贝更合适。

装到项目级（.claude/skills/）可以把技能随仓库提交，让团队共享同一套 Agent 行为——适合 changelog 格式、评审清单、发版流程这类应该人人一致的规范。

从项目级开始：在要用技能的仓库里建 .claude/skills/your-skill/SKILL.md。frontmatter 需要两个字段——与文件夹一致的连字符 name，以及写成触发条件的 description（「用户要 changelog 时，从已合并 PR 标题生成发版说明」），而不是定义。正文是 description 命中时 Agent 照做的编号步骤。

先迭代 description，再打磨步骤——误触发和不触发几乎都是 description 的问题。在新会话里用自然请求触发：在错误任务上触发就收紧 when 从句；从不触发就补上用户真正会说的词。能用之后，把文件夹提升到 ~/.claude/skills/ 跨项目使用，或保持提交状态让团队共享。

想深入了解格式——frontmatter 字段、渐进式披露、references 与脚本——什么是 Claude 技能有端到端的讲解。