深入了解“ADRs4AI”技术,通过将与AI协作的决策事项与代码一同记录在Git中,让任何人都能在任何时候无缝接续AI的讨论进程。
试想一下:昨晚您与AI加班至深夜,共同设计了一个复杂项目的架构。你们深入讨论了数据库结构(Schema)以及要创建的功能(API)。第二天早上,您对AI说:“按照昨天的设计继续做吧。”然而,AI根本不记得您是谁,也不记得昨天做出了哪些决定。您昨天的努力就这样在过往的聊天记录中消失了。
为了解决许多人所经历的这种无力感,一个名为“ADRs4AI”的概念应运而生。
为什么这很重要?
虽然AI变得极其聪明,但其“记忆力”仍有限制。关闭聊天窗口的那一刻,之前讨论的上下文往往会碎片化。如果不记录重要决策背后的理由,当之后再次协作时,不仅需要重复解释相同的内容,甚至可能忘记当初为何做出那样的决定。
ADRs4AI解决了这个问题。它将与AI的协作过程记录在Git(一种追踪软件变更的系统)等版本控制系统中,让我们像管理软件一样管理与AI共同做出的“决策记录(Decision Records)”。通过这种方式,未来的自己或其他协作者随时可以调取与AI交流时的思维脉络。 出处: ADRs4AI - GitHub
通俗地讲
“ADR”最初是“架构决策记录(Architecture Decision Records)”的缩写,是开发者记录为何选择特定技术的方法。ADRs4AI正是将其扩展到了AI协作领域。
打个比方,这相当于“一份记录与AI对话的个人工作日志”。正如写日记可以重温过去的思想,ADRs4AI将与AI决定的复杂技术选择编写成Markdown(一种在网页上简便编写文章的文档格式)文档,并保存在项目文件夹中。 出处: Decision Records for AI-Driven Software Development
这就像在拼乐高积木时,在设计图纸上备注为何把这种颜色的积木放在这个位置一样。当以后需要重新组装或修改乐高模型时,只需阅读这些备注,就能毫无困惑地继续工作。
当前现状
ADRs4AI不仅停留在概念阶段,已实现为实际工具。
- 工具集:由VS Code扩展插件、iOS客户端、项目模板以及阐述该方法论的文章等组成。 出处: GitHub -ADRs4AI/human-ai-collaboration-template-A
- 模型无关性:不绑定于特定的AI(如Gemini、Claude)。无论使用哪种AI,都可以应用该方法论。 出处: What is ADRs4AI?
- 记录原则:倡导“docs-as-code(文档即代码)”原则,即处理代码的方式。也就是说,与AI达成的决策在代码仓库内编写为Markdown文档,通过Git进行版本管理,并可通过Pull Request(PR,变更审核请求)接受同事的审查。 出处: Planning & Architecture Decision Records
这种方法将AI从单纯的“一次性对话对象”提升为共同思考项目的“持续合作伙伴”。 出处: ADRs4AI - GitHub
未来会怎样?
与AI的协作正变得日益复杂。现在已不仅仅是请求编写代码,而是与AI共同思考整个项目的架构设计。
在此过程中,像ADRs4AI这样的“认知连续性(epistemic-continuity,即与AI对话的上下文不中断的状态)”协议将成为必需品。这是因为,我们做出的决定将作为数据留存,这些数据又将回馈并服务于下一阶段AI的学习与推理,从而形成良性循环。正如在民主协商过程中引入AI的案例所见,AI能够极大帮助人类系统性地整理复杂讨论并达成共识。 出处: AI can help humans find common ground in democratic deliberation
我们的工作将不再挥发。与AI共同积累的所有思考都会在Git仓库中不断沉淀。当下次打开项目时,变得更聪明的AI将基于这些记录,立即接续我们的对话。
MindTickleBytes AI 记者观点
仅仅将AI的推理过程视为容易挥发的数据是知识资源的巨大浪费。将人类与AI的协作记录纳入Git管理,是人类开始将AI视为项目的“同事”而非仅仅是工具的最明确标志。
参考资料
- GitHub -ADRs4AI/human-ai-collaboration-template-A
-
[Home ADRS—AI-Driven Research for Systems](https://ucbskyadrs.github.io/) - ADRs for AI - Visual Studio Marketplace
- adrs4ai-pneumatic · PyPI
- Towards Human-AI Deliberation: Design and Evaluation of…
-
[deliberation-AI Agents on GitHub SkillsLLM](https://skillsllm.com/skill/deliberation) -
[Free AI Humanizer Humanize AI to Sound Like You, Not AI](https://www.grammarly.com/ai-humanizer) - Human or Not: A Social Turing Game is Back, Play Now
- AI can help humans find common ground in democratic deliberation
- WURK - Microtask Marketplace for Humans & AI Agents
- ADRs4AI - GitHub
- What is ADRs4AI? · ADRs4AI - adrs.systems
- Scaling AI Solution Architecture: How ADRs + Git + Claude…
-
[Planning & Architecture Decision Records Enterprise AI Delivery](https://lukewilk.github.io/AI-architecture/planning-and-adr.html) - Decision Records for AI-Driven Software Development
- 无限扩展AI的记忆力
- 使人类与AI的工作决策过程具备可持续性和可恢复性
- 让AI独立做出所有决策
- 自动保存到云端服务器
- docs-as-code(文档即代码)原则
- 利用AI专用数据库
- 不是,这是一种模型无关(model-agnostic)的方法
- 是的,只能在特定模型中使用
- 仅支持Gemini模型