别把一整份规格书丢给 agent，按寿命拆文档
Goldziher · reddit · 2026-07-23
核心观点
不要把一整份大规格书丢给 agent，而是按“寿命”拆分文档：把需求放在会频繁变动的工单系统里，把架构决策放进 git 里的 ADR，把实施计划保留为临时笔记，把“完成标准”写成黑盒集成测试。
为什么这对 agent 更有效
作者认为，一份 spec 往往混在一起写了四类信息：为什么做、怎么组织、执行顺序、什么算完成。这些内容的保质期不同，混在同一个文件里会随着最快过期的部分一起变得不可靠。对人类来说还可以靠 Slack 追问补救，但 agent 会把过期 spec 当成事实继续往下做。
推荐做法
- 产品需求：放工单系统，不镜像进仓库。
- 架构决策：用 append-only ADR 记录，靠“追加”而不是“改写”避免语义漂移。
- 实施计划：保持临时化，不要提交到版本库。
- 契约/验收：写成集成测试，让 CI 在偏离时直接报错，agent 也能据此自我修正。
帖子最后在问：大家是怎么给 agent 提供架构上下文的？ADR、别的系统，还是直接让模型从代码里推断？
「编程与Agent」频道最新
- BELL stack 开源：浏览器+Agent 框架+iMessage+支付，一套搭个人智能体 — jeff_weinstein · 2026-10-27
- 法律 AI 公司 Legora 在 Modal 上并行跑 2000 个 agent eval — blelbach · 2026-10-27
- 两名工程师用 AI 3.5 个月重建 FedEx 供应商计费核心,原估 7-8 个月 — alex_verem · 2026-10-27
- AA 实测 GPT-6.1 Terra:编码 Agent 得 48 分,成本仅前代三分之一 — ArtificialAnlys · 2026-10-27
- Shift-1 模型路由器发布：编码 Agent 成本最高降 55% — ypatil125 · 2026-10-27
- 零基础用户用 Claude Code 两周 vibe coding 出一款 Godot JRPG — ADHDavid · 2026-10-27