禁止配替代模式

定义

写 AGENTS 最稳定的规律之一：每一条"别做"都要配一条"做这个"。Augment AuggieBench 测试中，只有禁止项的文档表现系统性地差于禁止+替代方案配对的文档。

要点

• 只有禁止项 → Agent 谨慎但不知道下一步是什么 → 停下来反复核查方案是否违反每条规定 → 引发 Context Rot
• 配上替代 → Agent 知道下一步是什么 → 直接做
• 一条最简单的实操建议：把 AGENTS.md 里所有"别做"找出来，挨个配上"做这个"——光这一步就能明显改善 Agent 行为
• 与人类管理学中"批评要配建议"同源

示例

只有禁止（差）	禁止+替代（好）
不要直接实例化 HTTP 客户端	不要直接实例化 HTTP 客户端 → 用 lib/http 里的 apiClient，它已带重试中间件
不要在组件里写业务逻辑	不要在组件里写业务逻辑 → 把它移到 hooks/ 或 services/，参考 useUserProfile.ts

相关概念

• AGENTS
• 决策表（Agent文档）
• Context Rot
• Agent-CLI设计

参考资料

• AGENTS.md 写作六规律〔待补〕