别把一整份规格书丢给 agent，按寿命拆文档
Goldziher · reddit · 2026-07-23
核心观点
不要把一整份大规格书丢给 agent，而是按“寿命”拆分文档：把需求放在会频繁变动的工单系统里，把架构决策放进 git 里的 ADR，把实施计划保留为临时笔记，把“完成标准”写成黑盒集成测试。
为什么这对 agent 更有效
作者认为，一份 spec 往往混在一起写了四类信息：为什么做、怎么组织、执行顺序、什么算完成。这些内容的保质期不同，混在同一个文件里会随着最快过期的部分一起变得不可靠。对人类来说还可以靠 Slack 追问补救，但 agent 会把过期 spec 当成事实继续往下做。
推荐做法
- 产品需求：放工单系统，不镜像进仓库。
- 架构决策：用 append-only ADR 记录，靠“追加”而不是“改写”避免语义漂移。
- 实施计划：保持临时化，不要提交到版本库。
- 契约/验收：写成集成测试，让 CI 在偏离时直接报错，agent 也能据此自我修正。
帖子最后在问：大家是怎么给 agent 提供架构上下文的？ADR、别的系统，还是直接让模型从代码里推断？
「编程与Agent」频道最新
- 开源 Agent Skill 2.3k 星:生成 MVP 蓝图并审计重构 agentic harness — tom_doerr · 2026-09-11
- Cognition SWE-2 用 KKT 对偶优化长度惩罚，一次 RL 推移 Pareto 曲线 — YouJiacheng · 2026-09-11
- 首届 Three.js 大会落地巴黎，AI 正缩短从想法到原型的距离 — OdinLovis · 2026-09-11
- 观点：Agent 真正的瓶颈是企业数据工程能力 — dhruv2038 · 2026-09-11
- 实测戳破 RTK 省钱神话:token 省了,账单分文未降 — Bartaseth · 2026-09-11
- GPT-6 Astra 用时 44 小时通关含敌人 Factorio,API 成本约 4500 美元 — liminal_bardo · 2026-09-11