AB
AiBoss
チュートリアル

用 Claude 做三轮串行内容评审:让设计文档的遗漏逐轮收敛

チュートリアル

用 Claude 做三轮串行内容评审:让设计文档的遗漏逐轮收敛

一份可直接照做的评审流程:把同一份设计文档交给三个互不共享上下文的 Claude 代理,按串行顺序做三轮内容评审,第二轮只找第一轮漏掉的、第三轮只找前两轮漏掉的,最后统一汇总成一张按重要度排序的指摘清单。文中给出每轮该传什么、该要求什么输出格式、如何判定某一轮未完成并重跑,以及哪些判断仍然必须由人来做。

设计文档、方案对比材料这类东西,最怕的不是写得不好,而是评审时漏看。一次评审能提出二十条左右的意见,但换一个全新的视角再看一遍,往往还能再挖出五到十条。如果只评审一轮就定稿,这些没被挖出来的问题就跟着文档一起发出去了。

下面这套做法把内容评审固定成三轮串行:每一轮都启动一个全新的 AI 代理,不继承上一轮的对话;第二轮拿到第一轮的指摘清单,只负责找第一轮没找到的;第三轮拿到前两轮的清单,只负责找前两轮都没找到的。三轮跑完再统一汇总。本文讲的是这套流程本身——每一轮传什么、要求什么输出格式、怎么判定某一轮没做完要重跑,以及哪些判断不能交给 AI。

需要先说明一点:这套流程里 AI 只负责提意见,不负责改文档。改不改、怎么改,由写文档的人自己定。

准备工作

一份可以整篇通读的文档

流程要求每一轮都确认「已通读全文」,所以待评审的材料必须是一份能完整交给模型的文本。如果文档由多个文件拼成,先合并成一份,或者明确列出全部文件清单,否则「全文已确认」这句话就没有意义。

一份事先约定好的比较对象与范围

这一步容易被跳过,但它直接决定评审质量。方案对比类文档如果没有写清「和什么比、比到什么程度」,评审就会跑偏——评审者会拿自己脑补的对比对象来挑毛病,提出的意见和文档实际的范围对不上。

所以在发起评审之前,先把比较对象和范围写下来,并且每一轮都要随材料一起传过去。如果委托方没有给出比较对象,正确做法是在开始评审之前先向委托方确认,而不是自己替它定一个。

一份评审观察点清单

把「内容评审要看哪些方面」整理成一份固定清单,例如:结论与依据是否对应、前提假设是否写明、数据来源是否交代、方案之间的比较维度是否一致、风险与边界条件是否覆盖、术语是否前后统一。这份清单是每一轮都要逐项确认的对象,也是判断某一轮是否做完的依据。

清单不是一次写完就固定的。把历史上真实出现过的指摘按观察点归类,持续补进这份清单,评审的命中率会明显上升——素材里的经验是,在流程和观察点清单都稳定下来之后,原先细碎加起来约十条的指摘,最后能压到两三条。

一份文章推敲规则

除了内容层面的观察点,还需要一份文字层面的规则:表述是否含糊、同一概念是否用了不同说法、段落之间是否有跳跃、结论句是否被埋在长段落里。这份规则和观察点清单一样,每一轮都要逐项确认。

三个互不共享上下文的代理

三轮评审必须是三个独立的会话。不要在一个会话里连续追问三轮,也不要让第二轮继承第一轮的对话历史。原因很直接:同一个会话会沿着上一轮的视角继续看,越看越像,漏掉的东西还是漏掉。换一个干净的上下文,才有可能从另一个角度看同一份材料。

操作步骤

第一步:写下必须遵守的硬规则

把下面这些规则原样写进每一轮的指令里。它们是整套流程真正起作用的部分——没有这些约束,模型很容易把三轮压缩成一轮,或者干脆跳过某些观察点。

  • 三轮评审必须串行执行,禁止并行。
  • 第二轮在第一轮代理返回结果之后才启动;第三轮在第二轮返回结果之后才启动。
  • 第二轮的输入里必须包含第一轮的指摘清单;第三轮的输入里必须包含第一轮和第二轮的指摘清单。
  • 每一轮都启动一个全新的、不继承上一轮对话的代理。
  • 三轮全部完成之前,不得输出最终结果。
  • 即使某一轮返回零条指摘,剩下的轮次也不能省略。
  • 出现下列任一情况的轮次视为未完成,必须重跑同一轮:没有针对观察点清单和推敲规则的全部条目给出确认结果;没有明确表示已通读资料全文。

为什么坚持串行:只有拿到上一轮的清单,下一轮才能专门去搜「上一轮漏了什么、上一轮哪里判错了」。为什么坚持换新代理:避免被上一轮的看法带着走。

第二步:确定每一轮传什么

三轮的输入是层层叠加的,不是每轮重来一遍。

轮次传入内容
第一轮待评审资料、事先约定的比较对象、内容评审观察点清单、文章推敲规则
第二轮第一轮的全部输入,加上第一轮的指摘清单
第三轮第一轮的全部输入,加上第一轮和第二轮的指摘清单

注意「事先约定的比较对象」每一轮都要带。少了它,后面两轮会开始质疑文档的范围本身,产出一堆与本次评审无关的意见。

第三步:给每一轮写不同的任务指令

三轮的输入结构相同,但任务目标必须不同,否则后两轮只是在重复第一轮。

  • 第一轮:按观察点清单和推敲规则的全部条目,通读资料全文,逐项给出结论并列出指摘。
  • 第二轮:专门找第一轮没有找到的指摘;如果发现第一轮的某条指摘本身是错的,要明确写出来。
  • 第三轮:专门找第一轮和第二轮都还没有找到的指摘;同样,发现前两轮有错误要写出来。

把「找漏掉的」和「纠正前面的错误」这两件事同时交给后两轮,是有意为之。后一轮不只是补漏,它也是前一轮的复核者。

第四步:规定统一的返回格式

三轮必须返回同一种结构,否则最后没法合并。要求返回三块内容:

  1. 逐项确认结果:把观察点清单和推敲规则的所有条目逐条列出,每条后面写「有问题」或「无问题」。
  2. 指摘清单:固定列,依次为编号、重要度、位置、修改前、修改后、处理分类、对应观察点。
  3. 对前一轮指摘的订正:仅第二轮和第三轮需要;没有订正就写「无」。

其中两个字段的取值要固定下来:

  • 重要度:只有「重要」和「一般」两档。
  • 处理分类:只有「修改」「需要判断」「跳过」三种。

为什么非要逐条写「无问题」?因为只有全部条目都出现,才能一眼看出哪一项被跳过了。如果只让模型报有问题的项,被悄悄略过的观察点就永远藏在空白里——这也正是判定「未完成」的依据。

第五步:判定未完成并重跑

每一轮返回后,先做两项检查,再决定是否进入下一轮:

  • 观察点清单和推敲规则的每一条,是否都有明确的确认结果?
  • 是否明确说明了已通读资料全文?

任何一项不满足,这一轮就算没做完,用同样的输入重跑同一轮,不要带着缺口往下走。另外,某一轮返回零条指摘并不等于可以收工——剩下的轮次照常执行。

第六步:三轮结束后统一汇总

三轮都完成后,把三份指摘清单合并成一张总表,按重要度排序,重要的排在前面。同时把第二轮和第三轮新挖出来的条目单独列一份,方便看清后两轮到底补上了什么。这一步是流程的收尾,也是判断这套流程值不值得继续用的依据。

一个完整示例

假设要评审一份「三种技术方案对比」的设计文档。已经准备好:文档全文、事先约定的比较对象(例如「只与现有方案对比,不涉及尚未落地的备选方案」)、观察点清单(六项)、推敲规则(四项)。

第一轮

启动一个全新代理,输入文档、比较对象、六项观察点、四项推敲规则,指令如下:

请按以下观察点与推敲规则的全部条目,通读资料全文后给出评审结果。

【比较对象与范围】
只与现有方案对比,不涉及尚未落地的备选方案。

【观察点清单】
1. 结论与依据是否对应
2. 前提假设是否写明
3. 数据来源是否交代
4. 比较维度是否一致
5. 风险与边界条件是否覆盖
6. 术语是否前后统一

【推敲规则】
1. 表述是否含糊
2. 同一概念是否用了不同说法
3. 段落之间是否有跳跃
4. 结论句是否被埋在长段落里

【返回格式】
一、逐项确认结果:列出上述全部 10 个条目,每条写「有问题」或「无问题」。
二、指摘清单:列为 编号 / 重要度 / 位置 / 修改前 / 修改后 / 处理分类 / 对应观察点。
    重要度取「重要」或「一般」;处理分类取「修改」「需要判断」「跳过」。
三、明确说明是否已通读资料全文。

假设这一轮返回了二十条左右的指摘,十条确认结果齐全,并声明已通读全文。检查通过,进入第二轮。

第二轮

再启动一个全新代理,输入与第一轮完全相同,另外附上第一轮的指摘清单,指令改为:

【本轮任务】
下面是第一轮的指摘清单。请找出第一轮没有找到的指摘。
如果第一轮的某条指摘本身有误,请明确指出。

【第一轮指摘清单】
(粘贴第一轮的完整输出)

其余输入与返回格式同第一轮;
第三块「对前一轮指摘的订正」必须填写,没有订正写「无」。

这一轮通常会再挖出五到十条新问题,其中可能包含对第一轮某条指摘的纠正。同样检查十条确认结果是否齐全、是否声明通读全文。

第三轮

再换一个全新代理,输入第一轮的原始材料,加上第一轮和第二轮的指摘清单:

【本轮任务】
下面是第一轮和第二轮的指摘清单。请找出这两轮都还没有找到的指摘。
如果前两轮的某条指摘有误,请明确指出。

【第一轮指摘清单】
(粘贴)

【第二轮指摘清单】
(粘贴)

其余输入与返回格式同前;第三块「对前一轮指摘的订正」必须填写。

第三轮往往还能再补出几条。三轮合计,素材里的经验是三十到四十条指摘,其中真正需要动手修改的也大致在这个量级。

汇总

把三份清单合并,按重要度排序,重要的在前;再把第二轮、第三轮新增的条目单独列一份。然后由写文档的人逐条过一遍,确定哪些改、哪些需要再判断、哪些跳过。素材里的做法是:三轮合计三十到四十条,实际修改的也差不多是这个数量。

注意事项

AI 只提意见,不改文档

流程里 AI 的产出止于指摘清单。处理分类最终由人确定,改不改也由人决定。不要让模型直接改文档——它没有判断「这条意见是否值得采纳」的立场,而写文档的人有。

能抓的是错误,不是判断

这套流程能覆盖的是疏漏和错误:依据缺失、口径不一致、术语不统一、结论没写清。它做不到的是判断类工作——比如「这里配一张什么图会更好懂」「这个章节顺序是否更符合读者思路」。这类问题仍然要人来定。

前提交代不清,流程就会失效

比较对象、范围、观察点、推敲规则,任何一项没交代清楚,评审质量都会明显下降。素材里明确提到,前提讲得不够细致时,这套流程经常跑不出预期效果。所以准备工作那几节不是形式,是流程的一部分。

三轮不能省,也不能并

并行跑三轮看起来更快,但那样每一轮都拿不到上一轮的清单,也就无法针对性地找漏,等于把同一件事做了三遍。同理,某一轮返回零条指摘也不构成跳过后续轮次的理由。

最后仍然需要人工检查

三轮跑完、汇总排序之后,人工复核这一步不能省。流程降低的是漏检率,不是取消复核的理由。

关于模型与配额

三轮串行意味着同一份材料要处理三次,上下文长度和调用次数都是单轮的三倍左右。具体的上下文窗口、速率限制与计费方式随模型和套餐变化,使用前请以官网当前信息为准。