夜雨聆风学习资料网

ARTICLE · 1141484

AGENTS.md 不是普通文档:一次真实项目里的

AGENTS.md 不是普通文档:一次真实项目里的

AGENTS.md 不是普通文档:一次真实项目里的

你的 AGENTS.md 可能已经被截断了,后面写的规则 Agent 根本没看到。
我项目里的规则文件一度 65KB,而宿主给规则的预算只有 64KB。
超了会怎样?我翻源码看明白了:不是智能摘要,是保留前面的字节,直接截掉后面的内容。

而我的禁止事项、恢复手册,全写在后面。治理前那一个文件占掉预算的 99.3%。

📌 真正有效的治理不是"删短一点",是按"什么时候必须到场"分四层:
1️⃣ 每轮都在场:硬规则、禁止事项、路由表
2️⃣ 作用域被发现后才进:构建约束、测试写法
3️⃣ 做某件事才读:发布剧本、验收清单
4️⃣ 历史取证默认不进

拆完常驻层只占预算 24%,从 99.3% 到 24%,不是靠删字,是靠放对地方。

🔧 然后装三个闸门:
预算闸门(每层设上限,余量低于地板线直接失败)、完整性闸门(版本号、测试数变机器可检查断言,第一次跑就抓到校验器自己的 bug)、发布闸门(641 项测试全绿)。
再给每个来源文件记版本指纹。

📋 抽成七条可以搬走的原则:
①先量预算再谈压缩
②按"何时到场"分层不按主题
③给延迟内容配触发词路由
④把漂移说明变机器断言
⑤建立版本指纹
⑥不为压缩率牺牲可解释性
⑦区分"机制变好"和"行为变好"

💡 最关键的认知:Context 治理不是压缩率竞赛。
可解释性本身就是一种工程能力。我更看重"我读到的 ≈ Agent 实际收到的"这个不变量。

老实说:能证明机制变好了,不能证明"它更听话了"——后者要靠几十个真实会话去统计。

如果你的规则文件已经几十 KB,今晚只做一件事:量一下多少字节,离上限还有多远?

原文AGENTS.md 不是普通文档:一次真实项目里的 Agent Context 治理
广东,1小时前,

相关学习资料