决策表（Agent 文档）

定义

在 AGENTS 中用于解决架构歧义的工具：当代码库里有几种都说得通的方案时，决策表让 Agent 在写第一行代码前就做出选择，不用边写边猜。是 AuggieBench 评测中提升效果最显著的模式之一。

要点

• 适用场景：状态管理选型（React Query vs Zustand）、HTTP 客户端选型、数据获取方式选型等"几种都对"的歧义
• 结构：列出选项 + 各自适用条件 + 推荐默认 + 反例
• 测试效果：相关 PR 中 best_practices 分数提升 25%
• 在功能任务中要小心——决策表里引用的参考资料容易把 Agent 带进 Context Rot
• 替代了把"架构总览"写成长段落的传统做法（长段落容易引发过度探索）

示例

## 状态管理选型

| 场景 | 选什么 | 为什么 |
|------|-------|--------|
| 服务端缓存数据 | React Query | 内置缓存、失效、重试 |
| 客户端 UI 状态 | Zustand | 轻量、无 Provider |
| 表单状态 | React Hook Form | 性能与未受控字段 |

相关概念

• AGENTS
• 禁止配替代模式
• Context Rot
• 渐进式披露

参考资料

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