Skill 的三层披露结构
目录层常驻名称与一句描述,正文层在命中后加载,资源层在执行时才读。每层体积相差一个数量级。
PROGRESSIVE DISCLOSURE
LAYER 1 · ALWAYS
目录
名称 + 一句描述 + 何时使用
每条约 100–200 字节
LAYER 2 · ON MATCH
正文
流程、判定条件、完成标准
通常 2–8 KB
LAYER 3 · ON DEMAND
资源
脚本、模板、示例
按执行需要读取
COST OF GETTING IT WRONG
目录写得太粗会漏选,写得太细会撑破常驻预算
二十个 Skill、每条 200 字节是 4 KB;每条 500 字节就是 10 KB,且每轮都要付。
正文层的常见问题是膨胀:把整套流程细节写进去,命中一次就吃掉几 KB。
资源层的价值在于「正文可以只说「运行 scripts/check.py」,而不必内联脚本内容」。