ADRs4AI

人机协作决策记录方法论与工具链

AI编程开发 部分免费

产品简介

ADRs4AI 是一套面向人与 AI 协作的决策记录方法论与配套工具链,官网标语是"你的思考不再蒸发,你的决策开始复利"。它把人机对话中最值钱的那部分——思考过程——固化成带版本、可检索、能被智能体再次读取的记录文件,让今天的决策可以复用到明天。核心动作很简单:把还没整理的想法倒进一个种子文件,AI 把它切成一条条决策记录,开放问题带着选项、推荐理由和证伪条件出现,人只用花一次判断力去接受或推翻。

核心功能

  1. 仓库模板即起点:GitHub 模板仓库 ADRs4AI/human-ai-collaboration-template-A 采用 Apache-2.0 协议,2025 年 12 月建立,到 2026 年 10 月仍在推送更新,内置决策记录与种子模板、协作指令、收件箱协议、任务运行器配方,可整份采用,也可只取其中某个模块。
  2. 种子文件承接原始想法:把项目描述、语音转写的原话直接写进 CLAUDE.md,AI 会切成一条条记录,保留你的原话、备选方案、推理过程与待决问题。
  3. 问题即记录:每个开放问题以 QST 标记开头落在 docs/adr/ 目录,一条检索命令就能全部捞出;每条问题自带选项、推荐结论、理由、置信度,以及"什么情况能证明它错了"。
  4. 编辑器与智能体双通道:Visual Studio Code 扩展提供未决问题树视图、输入即校验的格式诊断、深度跳转,并内置 MCP 服务让智能体直接查询记录,扩展同时上架 Open VSX。
  5. 掌上裁决:官方 iOS 客户端已上架 App Store,登录后导入仓库即可在手机上审阅开放问题,一键接受后直接落成一次提交。
  6. 多席位协作:各 AI 席位跑在 tmux 会话里并按简报唤醒,人不必再充当消息中转站,这是入门文档第七至第九步的进阶章节。
  7. 生态地图:awesome-adrs4ai 把方法论、编辑器与客户端、自动化、实践项目、教学材料整理在同一页,每条都标注类型与语言。

特色优势

  • 记录留在你自己的仓库里,本地优先,不上传第三方服务。官网专门列出它不是什么:不是转录归档,不是向量数据库式的记忆,不是编排平台,也不宣称 AI 拥有持久身份。
  • 决策可审计:官网展示的真实记录里,一个"更正要不要保留过去认知"的问题被拆成三种方案——就地改写、只追加断言、双时间轴混合,最终选择带有效时间与观测时间双轴的方案,并把 Git 作为第三层审计留痕。
  • 人机分工清晰:AI 负责把选项、理由、置信度、证伪条件铺开,人只做一次裁决——接受、推翻,或用任何形状回答。
  • 十分钟冷启动:一条种子、一个问题、一次裁决就能跑通,不要求你先成为资深工程师。
  • 方法论可引用:概念有 DOI,模板每次发布都有可解析的归档版本,学术场景能直接引用。

应用场景

  1. 多项目并行:给每个项目配一个专属颜色,窗口开得再多也能一眼认出门。
  2. 需求与架构决策留痕:把"要不要上双时间轴"这类分歧固化成记录,半年后新同事能读到当时的理由。
  3. AI 生成代码的评审:把模型的推理与人的取舍放在同一份文档里,评审不再依赖散落的聊天记录。
  4. 知识交接:人员变动时,仓库里的决策记录本身就是交接包。
  5. 教学与研究:可引用的方法论与论文,适合在工作坊或课程里复现"人机协作留下记录"的完整流程。

适用人群

同时在跑多个项目的独立开发者;需要为关键决策保留可审计依据的团队与合规场景;刚开始与 AI 结对但不想被提示词工程绑死的新手;以及研究智能体协作协议的教学者与研究者。

出品方

Jérémie Lumbroso 为创始者,Visual Studio Code 扩展发布账号为 jlumbroso。项目与一队有名有姓、署名公开的 AI 协作者共同构建,官方把这一点当作方法本身的一部分,而不是宣传噱头。官网示例记录里,给出推荐的是署名 GPT 5.6 Sol 的模型,最终裁决来自创始人手机上的一次点击。

更新动态

  • 2025 年 12 月 8 日建立模板仓库,Apache-2.0 协议,2026 年 10 月 24 日仍有推送更新。
  • 2026 年 8 月 25 日发布上线前致谢,并发表《Cybernetic and epistemic: Two ways to relate to AI》,提出面向人机关系的认识连续性协议。
  • 论文《Cybernetic and Epistemic: A Missing Vocabulary for Trustworthy Agentic Delegation》被 AAAI 2026 可信智能体系统秋季研讨会录用,arXiv 编号 2610.00961;另有《Deliberative Programming: A Versioned Deliberation Protocol for Human-AI Collectives》,Zenodo DOI 为 10.5281/zenodo.23300579。
  • 官网、编辑器扩展、Open VSX 与 iOS 客户端当前均可正常访问。

官网链接

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论