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」,而不必内联脚本内容」。