用 /retro 与 /writing-for-agent 治理 Agent 上下文文档
组合 /retro 与 /writing-for-agent，以渐进式披露清理 AGENT.md，保持 Agent 上下文清爽并节省 token。
原始内容
我非常建议大家在每个阶段完成后调用/writing-for-agent和/retro 可能有人从没有管过自己的AGENT.md，里面塞了一大堆中间状态都不知道…这些玩意每轮都会进入AI的上下文，不但耗token还会误导它的工作 或者是文档之间各说各的，有的还没有引用跳转，整个文档系统让AI用得很难受 /retro搭配/writing-for-agent使用可以有奇效！ 它们会用渐进式披露原则检查你的README.md和AGENT.md文件，把详细信息用导航的形式放到专用的文档里，把无用的中间过程全部删掉，保持AI的上下文文件清爽
Prompt of the day: /retro read my last 10 coding agent sessions and find ways to make my repo easier to navigate. Find where agents take too long to find relevant information, or rely on out-of-date docs. Improving navigability is such an underrated way to save tokens.
中文译文
机器翻译，保留原文供核对。
今日提示词： /retro 读取我最近 10 次编码智能体会话，找出能让我的仓库更易导航的方法。找出智能体花费太长时间才找到相关信息，或依赖过时文档的地方。 提升可导航性是一种被严重低估的节省 token 的方式。
深度解析
是什么：Erwin 转评 Matt Pocock 的“每日 Prompt”，推荐在每个开发阶段结束后组合调用 /writing-for-agent 与 /retro 两个技能；被引用推文给出一条可直接复制的提示词，让 Agent 回读最近 10 次编码会话，找出仓库难导航、检索信息慢、依赖过时文档的问题。
核心方法论：二者组合遵循渐进式披露原则——README.md、AGENT.md 等主文件只保留索引与导航，细节下沉到专用文档，无用中间过程全部删除。这样每轮进入模型上下文的是“干净目录”，而非冗长流水账。
关键洞察：作者把文档可导航性视为被低估的省 token 手段。AGENT.md 常被当成日志堆积中间状态，既烧 token 又误导模型；文档互相矛盾、缺少跳转，则让 Agent 检索成本陡增。把上下文文件当作“给 AI 使用的产品界面”持续维护，是 Agent 工程中比模型选择更基础的杠杆。
边界与风险：效果依赖模型忠实总结与技能本身的质量；自动化清理可能误删仍有价值的记录；回顾窗口仅最近 10 次会话，长周期演进问题可能被遗漏；这套技能与特定 Agent 工具绑定，跨平台使用需自行适配。
精选追评与案例
给出把 AGENT.md 当缓存、定期重写而非追加的可操作原则，直击上下文污染。
@ErwinWu000 深有体会。AGENT.md 塞满中间状态太常见了，每个 stale 状态每轮都进上下文，又贵又误导。我的原则是把它当缓存：定期整体重写而不是往上追加，每条都问一句下一轮还用不用得上。留给 agent 的该是结论和约束，不是流水账
强调清理过期中间状态并保留当前约束与文档入口，简洁点明省 token 的关键。
@ErwinWu000 AGENT.md 只进不出，最后每轮都在付费请 AI 考古。留下当前约束和文档入口，把过期的中间状态清掉，省 token 还少闹鬼。
补充了用 /writing-for-agents 编写 skills 来替代重复工作的实际用法。
@ErwinWu000 哦哦，我忘了使用/writing-for-agents去更新AGENT.md文件了， 我一直都是使用它去编写skills代替一些重复工作的。感谢分享这个技巧!
提供 Claude 在重构中途主动建议整理配置文件的真实案例，可作旁证。
@ErwinWu000 其实 claude 自己会建议的，我的一个重构项目，到一半 Claude 就建议整理 Claude.md 文件了