别把一整份规格书丢给 agent，按寿命拆文档
Goldziher · reddit · 2026-07-23
核心观点
不要把一整份大规格书丢给 agent，而是按“寿命”拆分文档：把需求放在会频繁变动的工单系统里，把架构决策放进 git 里的 ADR，把实施计划保留为临时笔记，把“完成标准”写成黑盒集成测试。
为什么这对 agent 更有效
作者认为，一份 spec 往往混在一起写了四类信息：为什么做、怎么组织、执行顺序、什么算完成。这些内容的保质期不同，混在同一个文件里会随着最快过期的部分一起变得不可靠。对人类来说还可以靠 Slack 追问补救，但 agent 会把过期 spec 当成事实继续往下做。
推荐做法
- 产品需求：放工单系统，不镜像进仓库。
- 架构决策：用 append-only ADR 记录，靠“追加”而不是“改写”避免语义漂移。
- 实施计划：保持临时化，不要提交到版本库。
- 契约/验收：写成集成测试，让 CI 在偏离时直接报错，agent 也能据此自我修正。
帖子最后在问：大家是怎么给 agent 提供架构上下文的？ADR、别的系统，还是直接让模型从代码里推断？
「编程与Agent」频道最新
- SymbolPeek 让 AI 只读符号不读整文件，已省下 161 万 token — Real_Veterinarian851 · 2026-07-23
- 多智能体基准落后 39% 到 70%，AgenC 改用单 agent — tetsuoai · 2026-07-23
- AgenC 读完两篇论文后把 swarm 默认改成单 agent — tetsuoai · 2026-07-23
- AgenC 的 swarm 默认只开一个 agent，并给并行写作者隔离 worktree — tetsuoai · 2026-07-23
- AgenC 升级并发智能体架构：引入 Git Worktree 隔离 — tetsuoai · 2026-07-23
- SymbolPeek 让 AI 只读符号不读整文件，已省下 161 万 token — Real_Veterinarian851 · 2026-07-23