Lesson 04 · s07 Skill Loading
函数你已经拆清楚了:代码跑,模型填表。Skill 看起来也是「调用」,
但它在第 3 课那张表里坐的是另一格。这课用你天天按的 /ask-matt 拆。
~/.claude/skills/ask-matt/
├── SKILL.md 11 KB,纯文字
├── PHASE-BOUNDARIES.md 4 KB,纯文字
└── agents/
SKILL.md 开头三行:
name: ask-matt
description: Ask which skill or flow fits your situation. A router over the skills in this repo.
disable-model-invocation: true
下面是 11 KB 的正文,讲「你手上的这些 skill 该按什么顺序用」。 整个目录里没有一行会被执行的代码。它是一份说明书,不是一个程序。
| 层 | 放哪儿 | 什么时候进上下文 | 多大 |
|---|---|---|---|
| 目录 | 系统提示词 | 启动时扫一遍 skills/,每轮都带着 | 每个 skill 一行,约 100 token |
| 正文 | tool_result | 模型觉得用得上,调一次 load_skill 才拿 | 几千 token,按需 |
这就是 s07 的全部。没有目录,模型不知道有哪些 skill;全塞正文,几十个 skill 就是几十万 token 每轮白带。目录让它「知道有」,正文让它「知道怎么做」。
我这一侧就是这么收到的。我的系统提示词里有一份目录,
wanghuo-demand-orchestrator 那一行长这样:
wanghuo-demand-orchestrator: 网货需求处理强制流程编排器。用于用户以一句话需求、BRD、截图说明、附件或业务描述提出产品需求时,自动完成需求受理、路由、业务知识补齐、PRD 初稿……
注意写法——又是「什么时候用我」。和 weather.py 的工具描述一个路数。
我只有在调了 Skill 工具之后,才会看到它的正文。
文字那一格。被「加载」的时候,发生的事只有一件:一段文字进了上下文,模型读了,照着做。 没有函数被调用,没有进程被起来。
这和工具是两码事:
| 工具 / 函数 | Skill | |
|---|---|---|
| 模型看到的 | 一份声明(名字 + 描述 + 参数) | 一行目录(名字 + 描述) |
| 模型调它之后 | 你的代码跑,结果回来 | 一段文字回来,模型接着读 |
| 改它 = 改什么 | 改代码(行为确定) | 改文字(行为概率) |
| 能不能干实事 | 能,它就是干实事的 | 不能,除非正文里叫模型去调某个工具 |
ask-matt 还有一处特别:它是一份关于别的 skill 的 skill——路由器。
而 disable-model-invocation: true 这行,让它不出现在我的目录里
(Claude Code 文档)。你可以验:
这次会话开头那份技能列表里有 grill-me、wizard,没有 ask-matt。
只有你能敲 /ask-matt,我自己不会去拿它。目录这一层也是可以按标志过滤的。
分身没有 s07:不扫 skills/,没有 load_skill 工具。
它的系统提示词是固定人格(ADR-0011)+ 群记忆 + 名册,每轮拼一次,不换。
唯一能碰到 skill 的地方是排查子进程(investigation_agent.py)——它起的是编码 CLI,
CLI 自带 s07,而 ~/.claude/skills/ 是用户级目录,wanghuo-* 在任何工作目录下都看得见。
但这条路只能你手动敲 repair 触发,群消息碰不到它
(runtime-configuration.md:37、ADR-0021)。
所以今天:从一条微信消息到任何一个 skill,零条路。 想让业务在群里丢 BRD 就有人接,缺的不是 skill——skill 你已经有一整套——缺的是那条路。 这个在聊天里展开讲。
一个 skill 被「加载」的那一刻,实际发生的是什么?
正文通过 tool_result 回到对话里,模型接着读。它没有能力执行任何东西——
要干实事,正文得叫模型去调某个真正的工具。
ask-matt 为什么不在我(Claude)这次会话的技能目录里?
disable-model-invocation: true。目录这一层不是「有就列」,是 harness 按标志过滤后才注入的。
这是第 2 课「挂点」思路的又一处:过滤规则挂在扫描那一步,不在模型里。
今天,从一条微信群消息到你的任何一个 wanghuo-* skill,有几条路?
对话层没有 s07;子进程那条只能手动 repair 触发。
这是你想接 BRD 交付时要先解决的事,不是 skill 本身。
读这一份:
Claude Code · Skills。看「Frontmatter」那一节就够,
你会看到 disable-model-invocation 和它的几个兄弟——每一个都是目录那一层的过滤开关。