第 4 章 · 01 技能的本质与渐进式披露
文档摘要
第 4 章 · 01 技能的本质与渐进式披露 本节摘要:技能(Skills)是可复用、可自动触发的能力包,包含 SKILL.md + 脚本/模板/参考文件;放在 (项目)或 (用户),目录结构正确即自动发现。它与斜杠命令同源(自定义命令已合并进 Skills),但有两个关键区别:自动触发与渐进式披露——三层加载:①只看 description 判断相关性 → ②加载 SKILL.md → ③按需加载支持文件。这是技能区别于"全文塞上下文"的核心机制:描述几十个字、正文几百行、支持文件上千行,实际进入上下文的只有被触发的那一层。 学习目标 阅读完本节,你应当能够: 说出技能与斜杠命令的同源关系与两个关键区别。 解释渐进式披露的三层加载机制及其上下文价值。
第 4 章 · 01 技能的本质与渐进式披露
本节摘要:技能(Skills)是可复用、可自动触发的能力包,包含 SKILL.md + 脚本/模板/参考文件;放在
.claude/skills/(项目)或~/.claude/skills/(用户),目录结构正确即自动发现。它与斜杠命令同源(自定义命令已合并进 Skills),但有两个关键区别:自动触发与渐进式披露——三层加载:①只看 description 判断相关性 → ②加载 SKILL.md → ③按需加载支持文件。这是技能区别于"全文塞上下文"的核心机制:描述几十个字、正文几百行、支持文件上千行,实际进入上下文的只有被触发的那一层。
学习目标
阅读完本节,你应当能够:
- 说出技能与斜杠命令的同源关系与两个关键区别。
- 解释渐进式披露的三层加载机制及其上下文价值。
- 用对比表说明技能与子代理、Hooks 的定位差异。
一、技能是什么
技能 = 一个 SKILL.md(带 frontmatter 的 Markdown)+ 脚本/模板/参考文件。放对目录(项目级 .claude/skills/ 或用户级 ~/.claude/skills/)即自动发现,无需注册。它既是可手动调用的命令(/skill-name),也是可自动触发的能力包——Claude 根据任务描述自动判断并调用相关技能。
定位对比:
| 机制 | 调用方式 | 适用 |
|---|---|---|
| 技能 Skills | 自动/半自动 | 自动化工作流(如审查、写作、重构) |
| 斜杠命令 | 手动 | 快捷操作 |
| 子代理 Subagents | 自动委派 | 任务分发(隔离上下文) |
| Hooks | 事件触发 | 自动化与验证(无 AI 决策) |
二、渐进式披露:三层加载
- 第一层:description——几十个字,Claude 据此判断"这个技能与当前任务是否相关";
- 第二层:SKILL.md 正文——被判定相关后加载,包含完整操作步骤;
- 第三层:支持文件——按需加载 scripts/references/templates 等。
这套机制的价值:技能可以写得非常完整(支持文件上千行),但平时不占上下文,只在被触发时按需进入。对比"把所有文档塞进 CLAUDE.md"的做法,渐进式披露是上下文经济学的核心实践。
内置技能 10 个(含
/simplify、/batch、/debug、/loop、/claude-api、/code-review等),其中部分(v2.1.215 起)仅显式调用才触发。
小结
技能 = 命令的同源扩展 + 自动触发 + 渐进式披露。理解"三层加载"就理解了技能与一切"全文塞入"方案的本质区别:它让能力包完整,但让上下文精简。下一节看 SKILL.md 的具体结构。