开发向专区 · 协同里的闭环 · 总纲

评审

我们这套工作流,用一个词说完,就是评审(code review):任何一次改动,交出去之前有人对着它看过;看出来的问题改完了,才算数。

一、它解决的问题:人传人的损耗

人和人之间传信息,本来就是残缺的、不精准的、留不下来的。

  • 口头说一遍,听的人只接住一部分。
  • 转述一次,就变一次形。
  • 说完就散了,回头找不到原话。
  • 做到哪一步说不清,你永远不知道现在走到了哪。

评审这一套,是把传递从「靠嘴」换成「靠一份留得下来的作业」。

「以为做完了」那一组讲了两种没做完:改了,但没改透;合了,但没合上。

读完的人常会追问一句:改的是什么?合的是什么?这一页就是回答。

答案是同一件东西:一次改动,也就是下面说的那份作业。评审就是围着它转的一整圈。没有这个词,那两篇像两条孤立的提醒;有了它,它们是同一圈里的前后两段。

二、这个词从哪来

写代码的行业里,任何人都可以提出改动,但改动要先给别人看过、点了头,才能进到大家共用的那一份里。Google 公开发表过一份针对自家代码评审的研究,样本是约九百万次改动,结论是:

评审首先是在传递知识:让这份东西能被下一个接手的人读懂。抓错是副产品。

所以评审不是不信任谁,是让每一次改动都能被另一个人接得住。来路和九个环节各自在买什么,见《为什么要多这几道手续》。

用四象限看,评审最值钱的地方,是另一双眼睛替你照到了「未知的已知」:没人提,但按同一个道理本该想到的那一格。

三、一份作业,从交上去到收进库里

界面上的词大多是英文。换成白话,就是这几步:交作业、批改、机器批改、收进库里。

一份可审的作业PR
把脑子里的想法变成版本清晰、记录完整、可以对比的成果:红的是删掉的,绿的是新增的,一眼看清改了什么、为什么改。它装的不只是代码,也可以是文件、方法论总结、新概念的定义、规划方案,任何需要共识的成果。
从私人经验变成可交接的资产提交
有版本、有记录,能被评审、被修改、被复用;进度走到哪一步,一看就知道。
对这份作业的批改Review
评审的人确认内容对不对、能不能落地。意见留在作业上,谁说了什么、怎么改的,整个共识过程都能追溯。
机器批改CI
作业一交上来就自动跑检查,批改时自动验证。人只看结论,把关的标准不靠哪个人记得。
外部视野AI
工作流接上 AI 之后,不只是人传人,还能借外部的判断力帮着定义、帮着评审。信息的传递从「人到人」扩展到「人到人,加机器」。
共识完成,正式入库合入
这份成果成为团队共享的、可以反复用的资产。

四、拆开一份作业:一次改动的五格

点任一格,看它是什么。朱红线标出两篇讲义各管哪一格。

改了什么

前后对照的差异:删掉的、加上的,一行一行摆出来。评审人看的就是这一份,不是改的人口头说的「我改了某某」。

界面上叫 diff(差异)。

五、一圈评审长什么样

  1. 1提出改动:写清改了什么、为什么改
  2. 2自己先看一遍:按说明对一次差异
  3. 3评审人看:给出编号的意见
  4. 4逐条回执:第几条、改在哪、凭什么算改好改了,但没改透
  5. 5拍板:拍板的人说清批准到哪一步
  6. 6合入:看到合入编号才算合了,但没合上
  7. 7上线核对:线上真的是新的

六、为什么这套机制更适合沉淀知识

传统的文档协作靠人盯人:谁改了、改了什么,全靠口头同步和事后对账。知识散在个人电脑和聊天记录里,人一走就丢了。

作业、批改、机器批改连起来,把沉淀变成了流程本身:每一次合入,都是一次带版本、带评审记录的知识入库。知识天生有出处、有过程、可以追溯。

成果又是结构化的、可以对比的,AI 能读、能复用,后面的工作里能直接调出来。知识沉淀不再是「写完文档就结束」,而是「入库就开始被用」。

  1. 问题:人传人的损耗
  2. 机制:作业、批改、机器批改
  3. 结果:可追溯的知识资产
  4. 为什么更好:入库即被使用

七、我们自己怎么用

我们是一家小团队,每一份改动都走这一圈。改的人和看的人,常常一边是人、一边是 AI:一个 AI 写改动,另一个 AI 先审读,人最后拍板;上线之前再核一次线上。

评审的对象也不只是代码。这一页的讲义、问答助手的提示词、团队的配置和规矩,都是这样一次一次改出来的。

我们也被它教育过:改过一句提示词,自己以为更稳了,评审前先拿真实问题试了一轮,才发现有一句该拒答的被放了出去。没有这一圈,那一句会直接上线。

八、放到企业里:评审不挑东西

企业主大多不写代码,但每天都在改东西。只要「改」这件事有人做、有人用,就值得有人看。

改动对象谁改谁来看怎么算过
客服话术客服主管一线客服,AI 先过一遍合规用词拿三个真实问题试答,对得上
智能中枢里的一条资料业务骨干另一个岗位的同事原来答错的那个问题,现在答对了
一张工序单流程负责人跑这道工序的人照新工序单跑一遍,结果一致
服务器或系统配置外包或 IT企业自己指定的一个人改前留了退路,改后核过线上

企业里评审的难点不在工具,在三件事有没有人认:这次改动有没有说明,看的人是谁,算过的证据是什么。

九、配好工作流之后:四轮进阶

工作流配上之后,评审不是一次做到位的。沿着它往下走,一般是这四轮;上一轮的信号出现了,再进下一轮。

轮做到什么进入下一轮的信号对应讲义
第一轮 · 看得见改动每一次改都留下前后对照和一段说明随手翻一份旧改动,能看懂当时改了什么、为什么本页第四节
第二轮 · 意见一次改透意见编号逐条,回执逐条对账一份改动来回不超过一轮《改了,但没改透》
第三轮 · 合上、上线可核点头、合入、上线各有一个能核的凭据再没有「以为上线了」《合了,但没合上》
第四轮 · AI 当第一位评审人先让 AI 对着规矩过一遍,人只看 AI 拿不准的,再拍板人花在评审上的时间降了,漏的没有变多筹备中

这一篇讲的,是我们每天在用的方法。

看我们怎么交付