AGENTS.md 工程规格标准化与上下文管理
AGENTS.md
应被视为 Agent 每次开始工作前都会读取的一组高优先级上下文,而不是一份持续膨胀的项目说明书。每增加一条内容,都应当追问:它是否真的值得在每一次任务中占用 Agent 的注意力?如果答案是否定的,就应将其交给代码本身、独立文档、Skills、Hooks 或其他按需加载的机制。
应尽量避免使用 /init 自动生成 AGENTS.md。自动生成往往倾向于求全,写入项目结构、命令、技术栈、代码路径、实现方式等大量信息,但其中许多内容 Agent 本就可以从代码和配置文件中自行发现,另一些内容又会随项目演进迅速过时。过期信息若长期保留在文件中,每次任务都会进入上下文,反而可能干扰 Agent 的判断。
不要重复 Agent 可以轻易发现的信息,尤其不要维护容易失效的实现细节。例如某个代码文件位于哪个目录、某个模块当前在哪个文件中、某项功能由哪个 Service 实现。代码持续变化,这类信息极易失效。更值得写入的是那些稳定、重要且难以仅从代码中推断的内容:项目目标、关键约束、特殊工具链,以及几乎所有任务都应遵守的原则。Agent 能够通过搜索代码获得的信息,应让它在真正需要时再去探索。
核心原则是渐进式披露。根目录的
AGENTS.md
只保留为精简的入口和路由器,说明在执行何种任务时应去何处读取相应规则和上下文。测试规范、TypeScript 约定、API 设计、数据库规则、Git 工作流等内容,都可以拆分到独立文档或 Skills 中。这样 Agent 只在真正需要时才加载对应部分,既减少上下文噪音,也降低不同指令互相干扰的概率。在 Monorepo 中,还可以通过不同目录下的
AGENTS.md
让规则随作用域分布。
因此,AGENTS.md
值得认真撰写,也值得定期删减。精简它的意义不仅是节省 Token,更重要的是管理 Agent 的注意力以及有限的指令预算。很多时候,少一点,Agent 反而工作得更好。
.md
关联工程母题系统与实测说明:
本篇「AGENTS.md 工程规格标准化与上下文管理」由 qilai 整理收录于 qilaidav 工程知识库,围绕 企业协同与三库底座 (Spec/Prompt/Memory) 的生产环境架构设计、链路排障与确定性验证展开沉淀。完整系统模块、部署边界与技术规格请查阅方案主页:→ 查看 企业协同与三库底座 (Spec/Prompt/Memory) 详情(架构诊断与定制交流:Telegram @BD8888 · hello@qilaidav.com · GitHub @qilaidev)。
免责声明与评测方法:本文所涉开源工具、模型基准与工程配置均基于实测环境与公开技术资料整理,仅供系统架构研发参考,不构成任何商业背书或投资建议。
— qilai · 摘自 Telegram 频道 @AIKB8