writing-for-agents 讨论如何写 Skill、AGENTS.md、CLAUDE.md 以及其他会被代理读取的文档。它最重要的提醒是：文档不是越长越可靠，真正关键的是上下文指针是否把代理带到正确的参考资料和分支。
写一个指针时，要说明目标材料是什么，以及哪些分支会触发它；把每次运行都需要的步骤放在主文档，把只有某条路径需要的细节放到单独文件。每个步骤都要有清晰、可检查的完成条件，否则代理很容易提前宣布完成。复杂概念可以用一个稳定的“领头词”反复锚定，但不要用重复段落堆出重要性。
维护时逐句检查：这句话是否真的改变默认行为？是不是环境已经提供的事实？是否把同一含义复制了多处？如果只是缓存了 package.json 或 `--help` 能查到的信息，优先删掉。使用它来写代理文档时，先画清信息层级，再决定哪些内容需要被指针带入。