用途：为任何由智能体消费的文档提供写作参考，包括技能文档、AGENTS.md / CLAUDE.md，以及通过指针触达的文档。资料强调，这些文档的打包形式不同，但写法一致：目标是让智能体每次运行都走同一条流程，而不是产出相同结果。当要写的文档本身是技能时，需阅读 SKILL-MECHANICS.md 了解前置信息、调用方式选择与路由技能。
主要概念：上下文指针。指针是存在于智能体上下文中、指向上下文之外材料并写明触达条件的引用，技能描述和 AGENTS.md 中指向某文档的一行都属于此类。决定何时、多可靠地触达材料的是指针措辞而非目标本身。指针承担两项职责：说明材料是什么，并列出应触发触达的分支。每条指针的每个词都在每一轮付出代价，因此需要更严格地精简：把起触发作用的关键词前置、每个分支只保留一个触发词、删去正文已承载的身份信息。
两种负载：上下文负载指常驻上下文材料对智能体窗口的消耗；认知负载指人需要记住有哪些文档、何时使用各自的开销。资料认为认知负载不应一味最小化，而应花在需要人类判断的地方。
信息层级：文档由步骤（有序动作）和参考（按需查阅的定义、规则、事实）构成，核心决策是每部分放在层级何处：文件内步骤、文件内参考、以及通过指针披露到独立文件的参考。披露太少会让顶层臃肿，披露太多会隐藏智能体真正需要的材料。渐进披露是把内容移出主文件并放到指针之后，以保持顶层清晰；按分支区分是判断是否披露的清晰标准：每个分支都需要的写在内，只有部分分支需要的放到指针后。同置原则要求把概念的定义、规则和注意事项放在同一标题下，而非分散。文档过长（蔓延）是主要失败模式，解法是分层披露并按分支或顺序拆分。
步骤与完成标准：每个步骤都以完成标准收尾，标准需清晰（智能体能否区分完成与未完成）且有要求强度（如“每个被修改的模型都已说明”比“产出变更清单”要求更高）。最强标准既可检查又穷尽。拆分文档只在值得时进行：按顺序拆分可避免后续步骤诱使智能体草率完成当前步骤；仅当完成标准模糊且观察到抢跑时，才通过拆分隐藏后续步骤。
引导词：引导词是模型预训练中已有的紧凑概念，作为词元重复出现可积累分布式定义并以最少词元锚定行为。自造词需清晰定义但无法借用先验，应优先使用已有词。引导词在正文中锚定执行，在指针中锚定调用。否定是相邻的失败模式：用禁止来引导会把被禁行为带入上下文，应改为正面陈述目标行为。
精简：每个含义只保留单一权威来源，避免重复；把含义放在仓库给定的位置；环境（package.json、配置文件、目录结构、--help 输出）本身也是事实来源，文档复述环境即缓存，只应缓存智能体无法直接查到的东西。逐句检查相关性，逐句排查无效指令（模型默认已遵守的指令），无效时整句删除。资料还列出应阅读的文件：AGENTS.md 或 CLAUDE.md（当它是要写的文档或持有指针时），以及共享 AGENTS.md 指定的仓库特定约束文件（如 docs/agents/project.md），缺失时按要求创建。
适用场景：创建或编辑技能文档、维护 AGENTS.md / CLAUDE.md、编写会被智能体按指针查阅的文档。限制：资料未提供具体的安装命令、收费方式、平台支持或效果数据；调用方式为在提示或简报中写明该技能名称。