开发向专区 · 协同里的闭环 · 总纲
评审
我们这套工作流,用一个词说完,就是评审(code review):任何一次改动,交出去之前有人对着它看过;看出来的问题改完了,才算数。
一、它解决的问题:人传人的损耗
人和人之间传信息,本来就是残缺的、不精准的、留不下来的。
- 口头说一遍,听的人只接住一部分。
- 转述一次,就变一次形。
- 说完就散了,回头找不到原话。
- 做到哪一步说不清,你永远不知道现在走到了哪。
评审这一套,是把传递从「靠嘴」换成「靠一份留得下来的作业」。
「以为做完了」那一组讲了两种没做完:改了,但没改透;合了,但没合上。
读完的人常会追问一句:改的是什么?合的是什么?这一页就是回答。
答案是同一件东西:一次改动,也就是下面说的那份作业。评审就是围着它转的一整圈。没有这个词,那两篇像两条孤立的提醒;有了它,它们是同一圈里的前后两段。
二、这个词从哪来
写代码的行业里,任何人都可以提出改动,但改动要先给别人看过、点了头,才能进到大家共用的那一份里。Google 公开发表过一份针对自家代码评审的研究,样本是约九百万次改动,结论是:
所以评审不是不信任谁,是让每一次改动都能被另一个人接得住。来路和九个环节各自在买什么,见《为什么要多这几道手续》。
用四象限看,评审最值钱的地方,是另一双眼睛替你照到了「未知的已知」:没人提,但按同一个道理本该想到的那一格。
三、一份作业,从交上去到收进库里
界面上的词大多是英文。换成白话,就是这几步:交作业、批改、机器批改、收进库里。
- 一份可审的作业PR
- 把脑子里的想法变成版本清晰、记录完整、可以对比的成果:红的是删掉的,绿的是新增的,一眼看清改了什么、为什么改。它装的不只是代码,也可以是文件、方法论总结、新概念的定义、规划方案,任何需要共识的成果。
- 从私人经验变成可交接的资产提交
- 有版本、有记录,能被评审、被修改、被复用;进度走到哪一步,一看就知道。
- 对这份作业的批改Review
- 评审的人确认内容对不对、能不能落地。意见留在作业上,谁说了什么、怎么改的,整个共识过程都能追溯。
- 机器批改CI
- 作业一交上来就自动跑检查,批改时自动验证。人只看结论,把关的标准不靠哪个人记得。
- 外部视野AI
- 工作流接上 AI 之后,不只是人传人,还能借外部的判断力帮着定义、帮着评审。信息的传递从「人到人」扩展到「人到人,加机器」。
- 共识完成,正式入库合入
- 这份成果成为团队共享的、可以反复用的资产。
四、拆开一份作业:一次改动的五格
点任一格,看它是什么。朱红线标出两篇讲义各管哪一格。
改了什么
前后对照的差异:删掉的、加上的,一行一行摆出来。评审人看的就是这一份,不是改的人口头说的「我改了某某」。
界面上叫 diff(差异)。
六、为什么这套机制更适合沉淀知识
传统的文档协作靠人盯人:谁改了、改了什么,全靠口头同步和事后对账。知识散在个人电脑和聊天记录里,人一走就丢了。
作业、批改、机器批改连起来,把沉淀变成了流程本身:每一次合入,都是一次带版本、带评审记录的知识入库。知识天生有出处、有过程、可以追溯。
成果又是结构化的、可以对比的,AI 能读、能复用,后面的工作里能直接调出来。知识沉淀不再是「写完文档就结束」,而是「入库就开始被用」。
- 问题:人传人的损耗
- 机制:作业、批改、机器批改
- 结果:可追溯的知识资产
- 为什么更好:入库即被使用
七、我们自己怎么用
我们是一家小团队,每一份改动都走这一圈。改的人和看的人,常常一边是人、一边是 AI:一个 AI 写改动,另一个 AI 先审读,人最后拍板;上线之前再核一次线上。
评审的对象也不只是代码。这一页的讲义、问答助手的提示词、团队的配置和规矩,都是这样一次一次改出来的。
我们也被它教育过:改过一句提示词,自己以为更稳了,评审前先拿真实问题试了一轮,才发现有一句该拒答的被放了出去。没有这一圈,那一句会直接上线。
八、放到企业里:评审不挑东西
企业主大多不写代码,但每天都在改东西。只要「改」这件事有人做、有人用,就值得有人看。
| 改动对象 | 谁改 | 谁来看 | 怎么算过 |
|---|---|---|---|
| 客服话术 | 客服主管 | 一线客服,AI 先过一遍合规用词 | 拿三个真实问题试答,对得上 |
| 智能中枢里的一条资料 | 业务骨干 | 另一个岗位的同事 | 原来答错的那个问题,现在答对了 |
| 一张工序单 | 流程负责人 | 跑这道工序的人 | 照新工序单跑一遍,结果一致 |
| 服务器或系统配置 | 外包或 IT | 企业自己指定的一个人 | 改前留了退路,改后核过线上 |
企业里评审的难点不在工具,在三件事有没有人认:这次改动有没有说明,看的人是谁,算过的证据是什么。
九、配好工作流之后:四轮进阶
工作流配上之后,评审不是一次做到位的。沿着它往下走,一般是这四轮;上一轮的信号出现了,再进下一轮。
十、这一组怎么读
下一步
这一篇讲的,是我们每天在用的方法。
看我们怎么交付