用途：编写智能体要消费的文档，包括技能、AGENTS.md / CLAUDE.md，以及通过指针引用的文档。核心观点是：包装形式不同，写作方法相同，因为它让每次运行取相同过程，而非产出相同结果。
主要能力与要点：
- 上下文指针：命名上下文之外的材料并编码触发条件；指针措辞而非目标决定何时、多可靠地取用材料。指针需前载关键词、每个分支一个触发、去掉正文已承载的身份信息。
- 两类负载：上下文负载（始终加载材料占用的 token 与注意力）与认知负载（人需要记住哪些文档存在、何时取用）。
- 信息层级：文件内步骤、文件内参考、披露式参考（放入单独文件，经指针加载）。渐进式披露用于保护层级，判断依据是分支：每个分支都需要的内联，只有部分分支到达的放指针后。
- 就近放置：概念的定义、规则、注意事项放同一标题下。
- 蔓延是失败模式：文档过长导致注意力稀薄，用层级拆分解决。
- 步骤与完成标准：每步要有完成标准，要求清晰且穷尽；标准模糊会诱发提前完成，可通过拆分序列并跨真实上下文边界隐藏后续步骤来缓解。
- 何时拆分：按序列（后续步骤引诱抢跑）或按调用方式（技能专属，见 references/SKILL-MECHANICS.md）。
- 引导词：利用模型预训练中已有的紧凑概念（如 lesson、fog of war、tracer bullets）作为 token 重复，锚定行为、聚焦注意、提升指针触发；自制词需额外定义成本，应优先用已有词。
- 否定是失败模式：禁止式表述会把被禁行为拉入上下文，应正面陈述目标行为；禁止仅在无法正面表述时作为硬护栏保留，并配合正面目标。
- 修剪：单一事实来源，避免重复；环境（package.json 脚本、配置文件、目录结构、--help 输出）也是事实来源，文档重复它即缓存，只缓存智能体查不到的约定、理由和坑；逐句检查相关性，删除无效句（默认已遵守的指令）。
使用方式：创建或编辑技能时，阅读 references/SKILL-MECHANICS.md 了解 frontmatter、调用方式与路由技能。先在一个狭窄范围应用，确认输出形状后再扩展。需要仓库或环境中的事实时自行查找，不要问用户。遇到该技能标记为用户的决策点应停下交还控制权。
适用场景：编写或修改被智能体读取的文档、技能、AGENTS.md、CLAUDE.md 时。
限制：该技能从 mattpocock/skills（MIT，commit 3cca18b）导入，上游为模型调用；其他具体平台、收费与使用限制暂未提供。