SOLA AI Agent 共学营 · 补充材料

Agent 如何加载技能

四个关键认知点：

装在哪：全局（~/.claude/skills/）对所有项目生效，项目级（.claude/skills/）只在当前项目生效。项目级覆盖全局。就像 CLAUDE.md 的层级一样——越具体的优先。

在 context 里的位置：技能元数据在第三层（紧跟 CLAUDE.md 之后），始终在线。技能全文在"动态层"，只有被触发时才加载。这两层位置不同，成本也不同。

渐进式加载是核心设计：100 个技能只加载 100 条"封面"（name + description），大约 3000 token。你说一句话触发了其中 1 个，才把那 1 个的全文（3000-5000 token）载入。其他 99 个纹丝不动。这就是为什么可以放心装很多技能而不担心 context 爆炸。

description 是触发器：技能能不能被用上，全靠 description 里的关键词和 Agent 的语义匹配。如果 description 写得太笼统或者缺少用户常用的表述方式，技能就是"装了但白装"。把用户可能说的所有关键词（中文、英文、口语、斜杠命令）都写进 description，是最高杠杆的动作。

从 agent-depth.html 主课件正文抽取生成，用于替代缺失的嵌入材料页面。