Claude Code 使用手册 · 第 4 章 技能 Skills

Claude Code 使用手册 · 第 4 章 技能 Skills

章节摘要:技能(Skills)是可复用、可自动触发的能力包——一个 SKILL.md + 脚本/模板/参考文件,放对目录即自动发现。它与斜杠命令同源(自定义命令已合并进 Skills),但多了自动触发与渐进式披露两大机制:①只看 description 判断相关性 → ②加载 SKILL.md → ③按需加载支持文件。本章讲 SKILL.md 结构(必填仅 name+description,其余与命令 frontmatter 相同)、六个示例技能精读(code-review-specialist 四维审查/blog-draft 九步流水线/brand-voice 品牌语气/claude-md 最佳实践专家/doc-generator 文档生成/refactor 六阶段重构)、最佳实践(SKILL.md 500 行内/描述含触发词/共享方式)。本章共 4 节。

解剖坐标

一句话主线:技能 = 命令 + 自动触发 + 渐进式披露 → 用六个示例掌握写法 → 按实践清单用好。

学习目标

阅读完本章,你应当能够:

1. 说出技能的定位与三大机制,解释渐进式披露的三层加载。
2. 写出 SKILL.md 的目录结构、必填/可选 frontmatter 字段。
3. 复述至少三个示例技能的核心流程(如 blog-draft 九步、refactor 六阶段、code-review-specialist 四维)。
4. 背出技能最佳实践(500 行内、描述含触发词、一个技能一个问题)与共享方式。

子章节导航

01 技能的本质与渐进式披露

Skills vs 斜杠命令 vs 子代理 vs Hooks 的定位对比;三层加载机制(description→SKILL.md→支持文件);放 .claude/skills/(项目)或 ~/.claude/skills/(用户)自动发现。

02 SKILL.md 结构与配置字段

目录结构(SKILL.md+scripts/references/templates);必填字段仅 name+description;可选字段与命令相同(argument-hint/allowed-tools/model/context/agent/hooks 等);支持 $ARGUMENTS 与 !`cmd` 注入;context: fork 隔离运行。

03 六个示例技能精读

code-review-specialist(安全/性能/质量/可维护性四维+输出模板);blog-draft(9 步流水线+强制引用+版本化草稿);brand-voice(语气一致+推荐/避免词汇表,user-invocable: false);claude-md(三模式+黄金法则);doc-generator(逐端点文档模板);refactor(Fowler 六阶段+异味表+红绿循环)。

04 技能的最佳实践与共享

描述要具体并含触发词、一个技能解决一个问题、SKILL.md 500 行内超出拆支持文件;故障排查(未触发/触发太频繁);共享(项目级入仓库、个人级放用户目录、打包进插件分发)。

前置知识与后续延伸

前置知识:第 2 章命令语法(同源);第 3 章 CLAUDE.md(与 claude-md 技能互为表里)。

后续延伸:第 7 章 Hooks(skill 级 hooks)、第 8 章插件(skills 可作为插件组件打包)。