评审模型RFC 负责在决策前组织上下文、方案与未知,ADR 负责在决策后固定选择、原因、后果和反转条件,运行证据负责检验当初假设。三者缺一,架构就容易变成一次性演示。

评审先对齐要解决的决策

开头先写需要批准或否决的具体选择,以及不决策的代价。例如“是否让退款 Agent 在指定金额和原因码内自动执行”比“建设智能客服架构”更能约束讨论。随后给出业务目标、用户任务、当前基线、范围、非目标和不可变约束。

事实、假设、工程判断与待实验项必须可辨认。现网日任务量是事实,采用率是待验证假设,选择事件驱动是工程判断,监管要求是约束。把四者混成陈述会让评审者无法判断应该反驳数据、验证假设,还是比较设计。

RFC 中四类陈述的处理方式
状态示例评审动作
事实现有人工流程的周期分布核对来源、口径和时间
约束资金动作必须保留审批证据确认 Owner 与不可变范围
判断领域执行留在业务数据面与替代方案比较后决策
未知复杂任务的重试成本转成实验、阈值和停止条件

架构叙事围绕运行与责任

一张组件图不足以证明架构。RFC 要从入口开始说明身份如何建立,Context 与数据经过哪些信任边界,模型在哪些节点做开放式决定,Tool 如何授权和对账,状态由谁持久化,人工何时接管,最终业务终态如何验证。

正常链之外,还要描述异步长任务、取消、超时、重试、版本固定和回放。失败分析沿传播路径展开:模型选错 Tool,策略是否拦截;Tool 超时,是否能判断副作用;控制面不可用,数据面能否使用已验证快照;恢复后,Trace 和账本是否能对齐。

评审应沿“责任与证据”阅读运行链
入口与身份谁提出目标,携带何种租户与权限。
决定与上下文证据版本、模型选择和策略原因。
行动与状态Tool 参数、审批、幂等与回执。
终态与运营业务后置条件、SLO、恢复和审计。

替代方案必须可比且包含 Why Not

替代方案来自真实决策空间:保持人工、确定性 Workflow、检索助手、单 Agent、多 Agent、购买产品、复用平台或自研。每个方案都用相同任务和约束比较质量、延迟、成本、可靠性、安全、迁移与组织复杂度,不能拿完整推荐方案与一句话稻草人比较。

默认推荐应写适用条件和例外。例如单 Agent 是低到中等复杂任务的默认选择,多 Agent 只有在职责隔离、独立扩缩或上下文边界带来明确收益时采用;若只是为了角色名称更形象,多 Agent 会增加协调、Trace 和失败面。Why Not 记录当前不选的证据,不宣称方案永远错误。

同一客服处置任务的方案对比
方案优势主要代价采用条件
确定性 Workflow可预测、易审计长尾规则维护高路径可枚举且政策稳定
单 Agent 加审批处理开放式输入,链路较短需要评测与状态控制动作可回读,高风险受控
多 Agent责任或资源可隔离协调、延迟和归因更复杂独立边界收益可测量
购买产品较快获得成熟能力锁定与扩展边界数据、SLO、导出均满足

把未知变成验证计划

每个关键未知都映射到实验方法、样本、指标、阈值、数据 Owner 和决策影响。模型质量用代表性 Golden Dataset 与分层评测,检索用权限与引用验证,Tool 用契约和故障注入,容量用生产形状负载,恢复用 GameDay,用户工作流用 Pilot。

阈值必须在看结果前定义,并包含停止或收缩条件。Google SRE 的可靠发布实践强调轻量、可重复、适应风险的检查;Agent RFC 可据风险分层,低风险变更走快路径,高风险自治、身份或数据边界变化必须补齐安全、恢复与运营证据。

未知:Tool 超时后是否会重复退款
方法:在提交前、提交中、回执后注入超时并重放
证据:幂等账本、外部订单终态、Trace、补偿记录
通过:任何重试不产生重复副作用,未知结果进入对账
停止:无法取得稳定幂等键或外部回读能力

评审是风险发现,不是权威表态

评审前异步发送 RFC,标出需要决定的章节和未关闭问题。会议从分歧与高风险未知开始,不逐页朗读。邀请业务、应用、平台、数据、安全、SRE 和前端体验角色的标准,是他们是否拥有约束、运行责任或反证,而不是组织层级。

评论分类为阻塞、需实验、建议和未来优化;每项有 Owner 与期限。主持人要主动询问反方方案和失败传播,防止职级最高者先表态造成从众。无限共识同样有成本,应提前确定 Decision Owner、截止时间以及无法达成一致时的升级路径。

评审退出标准决策已作出或明确延期,阻塞项有关闭证据,剩余未知有 Owner、阈值和期限,反对意见与风险接受者已记录。会议结束但这些产物为空,不算完成评审。

决策之后继续验证

AWS 的 ADR 指南将 ADR 定义为架构重要选择的上下文、决定和后果,并建议接受后保持不可变,由新 ADR 取代旧决定。对 Agent 系统还应记录假设、影响范围、配置版本、残余风险和反转触发器,使未来团队知道为什么当时合理。

上线后按 RFC 的业务、质量、SLO、成本与风险指标复盘。若采用率低、单位成本高、失败超出上限或平台依赖改变,应触发缩小自治、回滚或新 ADR,而不是修改旧文档掩盖偏差。未达到反转门槛但出现新风险时,也要显式接受并指定复审时间。

主动提取:为什么“所有评审者都同意”不是高质量评审的充分证据?
一致可能来自问题太模糊、反方未参与或权威先表态。高质量证据是关键风险被提出,替代方案按同一约束比较,未知转成验证计划,决定与责任可追踪。
复审判断:上线结果偏离 RFC 假设,能直接改原 ADR 吗?
不应覆盖已接受的历史。创建新 ADR,引用真实指标,说明旧决定为何不再成立以及迁移、回滚和残余风险,使决策链保持可追溯。

资料与事实边界

以下以官方文档、标准、论文和原始工程资料为主。厂商 API、价格、限额与模型能力会变化,落地时仍需按目标版本做能力探测和回归。

  1. AWS Prescriptive Guidance:Architectural decision record process — ADR 的上下文、决定、后果、状态与取代流程
  2. Google SRE:Reliable Product Launches at Scale — 轻量、稳健、可扩展、按风险适配的发布评审方法
  3. NIST:AI RMF Core — 多角色、持续风险管理、测量与治理责任的官方框架
  4. Google Cloud:Well-Architected Framework — 围绕安全、可靠性、成本与运营约束进行设计和复审