一、为什么需要了解渐进式加载
在快速上手中安装 Skill 时,操作很简单——放进目录,用 / 命令调用。但使用一段时间后,会遇到一些不靠直觉解释的现象:
- 安装了 20 个 Skill,启动速度没有明显变慢
- 写了很长的 SKILL.md,但 Claude 似乎只在调用时才"看到"它的内容
description字段只写了一句话,Claude 却能精准匹配到这个 Skill- 同事说"SKILL.md 不要超过 500 行",但没人能说清为什么
这些现象指向同一个机制:渐进式加载(Progressive Disclosure)——Skill 的内容不是一次性全部注入上下文的,而是分层按需加载。
二、渐进式加载的工作方式
渐进式加载的三层结构
Skill 的内容在 Claude 的上下文中分三层存在,每层有不同的加载时机和成本:
Level 1 是"名片"。Claude 启动时读取所有已安装 Skill 的 name 和 description,用于判断哪个 Skill 与当前请求匹配。
Level 2 是"指令手册"。只有当 Skill 被触发(用户输入 /skill-name 或 Claude 自动匹配)时,SKILL.md 的 Markdown 正文才被加载到上下文。