写两套、拆得开：指令文件的正确姿势

多工具的"说明书分裂"是真问题：CLAUDE.md 与 AGENTS.md 各写一份，Claude Code 才加了回退。此前那篇只抛悬念，这条实操把答案给全——三步写法： 一，写两套：范式流程＋项目背景算一套；可引用内容＋引用方式单列——skills、mcp、仓库、本地知识库、docs、CLI 逐项登记，模型一眼知道要什么、去哪拿。二，项目级与系统级划界：沙箱差异写进文件，否则模型拿系统常识套项目的事。三，拆分优先、字数越少越好——"能写文言文"是玩笑，本质是 token 经济学：说明书给模型读，不是给人参观。 口径：单人经验非标准，落地看项目形态（多仓库与单服务拆法不同）；少≠碎——指针层级别超两跳，否则模型到处找更慢；沙箱清单随环境更新，过期说明比没有更糟。 三条：一，先分栏：范式与引用各占一块，多数项目连"要什么"都没写清；二，引用区每项加一句适用场景，别让模型猜哪份 docs 管这次任务；三，每月字数瘦身：能删的解释删掉——你的仓库越像仓库，说明书越该像索引。 先给你的指令文件做个数字体检：现在多少行？能砍一半吗？