把 AI 对话固化成架构决策记录，随修复一起提交进 git
Ok_Negotiation_2587 · reddit · 2026-10-14
一位开发者分享了把 AI 编程对话转化为「架构决策记录」（ADR）的实践：git 只保留改了什么，而「为什么这么改、先试过哪些方案又为何放弃」通常埋在无人能再找到的聊天记录里，半年后别人一句「简化」就可能把代码改回曾经出 bug 的版本。
他的做法是在提交前追加一条 prompt，让 AI 从当次对话中生成一份 250 词以内的 Markdown 决策记录，包含：背景（面向新人两三句话讲清问题）、决策（一句话）、备选方案（每个被尝试或讨论过的选项及被否决的具体原因）、后果（带来什么隐患、什么情况需要重新评估）。
两个关键细节：
- 明确要求「不要虚构选项」，否则会得到一份没人真正考虑过的整齐备选清单，比没有记录更糟；
- 记录放进 docs/decisions/，与修复代码同一 commit 提交，commit message 里留一行指针，这样 git blame 就能一路追到「为什么」。
作者还提到自己做的浏览器扩展 AI Toolbox 可把对话导出为带日期和原文链接的 Markdown 文件（导出纯文本免费，Markdown 属付费功能）。
「编程与Agent」频道最新
- Claude Code 会话里冒出同事名字,原是多智能体邮件工具命名撞车 — doodlestein · 2026-10-14
- 阿里等发布 LSCBench:vibe coding 代码功能达标却仅 25% 兼安全 — Qwen · 2026-10-14
- sshexport 2.9 发布:用 ChatGPT 审计加固代码,支持 OpenWRT — esrtweet · 2026-10-14
- 瑞典真人秀整季成片被 AI Agent 删光,首播推迟到明年 — torb · 2026-10-14
- EvalSeal 新进展:RFC 3161 时间戳让 LLM 评测回执可第三方验证 — Fit_Fortune953 · 2026-10-14
- 老程序员把 Herbert 编程挑战改造成 Agent 基准，附完整提示词 — nankezhishi · 2026-10-14