←AI 实践笔记

Lesson 04 · s07 Skill Loading

Skill 是换进去的文字,
不是函数

函数你已经拆清楚了:代码跑,模型填表。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 工具之后,才会看到它的正文。

所以它坐在第 3 课的哪一格

文字那一格。被「加载」的时候,发生的事只有一件:一段文字进了上下文,模型读了,照着做。 没有函数被调用,没有进程被起来。

这和工具是两码事:

工具 / 函数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 和它的几个兄弟——每一个都是目录那一层的过滤开关。