手写一个 skill 运行时:扫描、frontmatter 解析、注入系统提示、按需读取正文
把三阶段渐进式加载真的写出来:扫描目录发现 skill,宽松解析 frontmatter,把名字与描述拼成目录注入系统提示,激活时才读入完整正文。
今日目标
- 能实现一个 skill 扫描器,处理作用域优先级与同名冲突
- 能宽松解析 SKILL.md 的 frontmatter,对畸形输入降级而不是崩溃
- 能把目录注入系统提示,并实现按需读取正文的激活入口
前四天你一直站在写 skill 的那一侧:怎么选题、描述怎么写、什么时候加脚本。今天换一次身份,去写那个读 skill 的程序。这不是为了让你造一个客户端,而是因为自己实现一遍之后,前四天每一条建议你都能指出它对应运行时的哪一行代码——为什么描述是唯一的触发面、为什么正文要控制在几百行、为什么名字必须等于目录名,全都会从「规范这么要求」变成「不这么做代码就跑不通」。读完正文、做完实验之后,回到页面顶部把三条目标勾掉。
小白版讲解
三阶段落到代码里就是三个函数
第一天讲档案柜时,你是那个来翻柜子的新人。今天你要去当管柜子的人:清点柜子里有哪些文件夹、把每个封面上那句话抄成一张索引卡贴在门口、有人问起某件事时才把对应那本抽出来递过去。
这三件事就是渐进式加载的三个阶段,落到代码里干干净净地对应三个函数。
发现:扫描约定的几个目录,找出所有含 SKILL.md 的文件夹,把每一份的元数据读出来。这一步在会话开始时跑一次。
披露:把所有 skill 的名字与描述拼成一份清单,塞进系统提示。正文一个字都不进来。 这份清单是模型判断「有没有该翻开的东西」的唯一依据。
激活:模型说要用某个 skill 了,才去读那一份完整的 SKILL.md,把正文放进上下文。
真正值钱的洞察藏在第二步和第三步之间:披露的成本是每一轮都要付的,激活的成本只付一次。 系统提示会跟着每一次请求重新发送,所以清单每多一个字,你都要乘以会话轮数。正文只在被激活的那一轮进上下文,之后作为历史消息留着,不会重复计费。这条不对称性解释了规范里几乎所有的硬约束——为什么描述有长度上限而正文没有,为什么描述必须写触发条件而不是使用说明。
面试题库
如果让你自己给一个 Agent 实现 skill 支持,发现阶段和激活阶段各要做什么?为什么要分成两步?If you implemented skill support in your own agent, what happens in the discovery stage versus the activation stage, and why split them?
国内高频海外高频进阶#agent-skills#runtime#progressive-disclosure🔒 解锁本章后查看答题要点。
你的运行时解析到一份不合规范的 SKILL.md,是拒绝加载还是降级加载?另外,两个作用域里有同名 skill 时你怎么处理?When your runtime parses a SKILL.md that violates the spec, do you refuse to load it or degrade gracefully? And how do you handle a name collision across scopes?
国内高频海外高频进阶#agent-skills#runtime#error-handling🔒 解锁本章后查看答题要点。
skill 的正文进了上下文之后,长会话里怎么保证它不失效?激活方式上文件读取和专用工具你会选哪个?Once a skill body is in context, how do you keep it effective across a long session? And would you activate skills by file read or by a dedicated tool?
国内高频海外高频深入#agent-skills#runtime#long-session🔒 解锁本章后查看答题要点。
