progressive-disclosure

渐进式披露

每一轮都会为冗长的指令文件付费，即使这一轮根本用不到其中的内容。解决办法不是删除——这些内容确实有用——而是调整位置：把每次运行都需要的内容留在入口文件中，把只有部分运行需要的内容移到指针之后，在相关时再读取。这项技能会重组一个产物。要找出哪些产物需要重组，请先进行审计。

步骤

1. 通读整个产物，找出其中的分支——运行可能经历的、真正不同的路径。只有用户要求验证时才会进入的验证部分就是一个分支；每次运行都适用的规则则不是。
2. 把每个部分分成两类：每个分支都需要的，以及只有一个分支需要的。这就是全部的判断，实际划分通常没有看起来那么平均——大多数文件都是简短的通用核心，外加特定分支的细节。
3. 将通用核心保留在入口文件中，并合理排序，让文件本身仍然通顺。若入口文件离开子文件就无法理解，说明拆分位置不对。
4. 将每个分支移到同级文件中，文件名应体现内容，而不是来源，例如 verification.md、glossary.md——只看名称，读者就能知道何时打开它。
5. 谨慎编写指针，因为指针的措辞决定了这些内容是否会被读取。把触发条件和文件名放在一起说明：“当更改涉及迁移时，请在规划前阅读 migrations.md。”文件底部孤零零的链接不是指针。
6. 从头到尾走完每个分支，并确认其仍包含所需的全部内容。然后报告哪些内容已移动、哪些内容保留，以及入口文件的新大小。

防护原则

• 拆分不等于删除。如果某个部分确实已无用，请明确指出并直接删除，不要把它藏进没人会打开的文件里。
• 切勿拆分每个分支都需要的内容。两个总是一起阅读的文件，本质上就是一个多了几个步骤的文件。
• 永远不会触发的指针会让内容变得不可见，这比保留在原处更糟。如果无法清晰地说明触发条件，就保留该部分。
• 在依赖同级文件之前，请确认目标运行环境确实会将它们与 SKILL.md 一同提供；不同安装器的行为各异，指向未随行文件的指针会导致技能失效。
• 入口文件清晰易读后就停止。继续拆分，只会用一种难读取代另一种难读。