设计文档评审的评论转任务比例和重复讨论率，难点集中在两处：分母里哪些评论算“有效评审评论”，以及同一议题的再次讨论如何认定。本文给出指标定义、取数字段、计算步骤和一份可复算的算例，并说明这两个指标在解读时的边界，帮助团队把口径固定下来，让不同时间段的统计结果可以对照。
要点总览（TL;DR）
- 评论转任务比例＝统计期内被转为任务的评审评论数÷同期有效评审评论总数，按评论条数计、按评论创建时间归期，分母排除系统通知和纯表情回复。
- 重复讨论率＝同一文档同一议题被再次发起的评论数÷同期该文档有效评审评论总数，议题归并规则需事先书面约定并留痕，规则版本变化要标注断点。
- 取数依赖评论ID、文档ID、评审轮次、创建时间、解决状态、关联任务ID和议题标签；关联任务ID缺失的评论留在分母、不计入分子，分母为零时输出“无有效样本”。
- 两个指标只描述协作过程，需与未解决评论数、响应时长和抽样复核一起解读，不同文档类型、不同评审轮次之间不宜直接横比，也不设通用达标线。
评估目标：评论闭环要回答哪几个问题
这套统计服务于文档评审协作的改进，回答四个具体问题，每个问题对应可观察的协作动作，而不是笼统的“评审好不好”。
- 评论是否被跟进并落到可执行动作：评审中提出的修改意见、补充说明、待确认事项，最终有没有变成任务或明确工作项，由谁在什么时间处理。评论转任务比例回答这个问题。
- 讨论是否在同一议题上反复消耗：同一个问题是否被不同评审人反复提出、反复回复却迟迟没有结论。重复讨论率回答这个问题。
- 评审是否在合理时间内收敛：评论从提出到获得实质回复、从提出到关闭各需要多久，评审结束时还剩多少未解决评论。未解决评论数和响应时长回答这个问题。
- 改进点落在哪里：指标用于定位哪类文档、哪个评审环节需要调整评审人配置、议题拆分方式或结论记录方式。
需要事先明确一点：这些指标描述协作过程，用于团队改进流程，不用于给个人打分。按评论人排名会诱导少提评论或快速标记解决，反而破坏评审质量。
指标与范围：四个指标的定义与统计边界
四个指标共用一套统计对象和时间规则，先定边界再算数，否则同一份数据在不同报表里会得出不同结果。
统计对象：以“文档—评审轮次—评论条数”三级确定。一条评论归属于某份文档的某一轮评审；同一文档多轮评审分别统计，不合并计算。评论以条为单位，一条评论内的多个问题不拆条，除非团队在评审规范中要求一议题一评论。
时间窗与归期：统计期建议按月或按评审轮次设定，起止时间精确到日。所有指标按评论创建时间归期，评论在统计期后转为任务，仍计入评论创建所在期，转任务动作单独记录发生时间，用于观察转化滞后。
| 指标 | 分子 | 分母 | 单位 | 时间窗 | 归期规则 |
|---|---|---|---|---|---|
| 评论转任务比例 | 统计期内被转为任务或明确工作项的评审评论数 | 同期有效评审评论总数 | 百分比 | 按月或按评审轮次 | 按评论创建时间归期 |
| 重复讨论率 | 同一文档同一议题被再次发起的评论数 | 同期该文档有效评审评论总数 | 百分比 | 与转任务比例一致 | 按评论创建时间归期 |
| 未解决评论数 | 统计时点仍处于未解决状态的评论数 | 不适用 | 条 | 统计时点快照 | 按快照时点计 |
| 响应时长 | 首条实质回复时间与评论创建时间之差 | 不适用 | 小时或工作日 | 与统计期一致 | 按评论创建时间归期 |
纳入与排除范围：纳入实质评审评论，即针对文档内容提出的意见、问题、修改建议和确认请求。排除系统通知、自动状态变更记录、纯表情或“收到”“好的”一类无信息回复。跨文档引用产生的评论，归入被评论的文档，不重复计入引用来源文档。评审之外的日常文档留言，若不属于评审轮次，不纳入分母。
数据口径与证据：字段、来源和缺失值处理
取数前先确认字段是否可得。评论与任务的关联关系是评论转任务比例的关键，这条关系需要以字段形式记录，仅靠人工记忆无法稳定复算。
| 字段 | 用途 | 取值说明 |
|---|---|---|
| 评论ID | 唯一标识一条评论 | 系统生成，用于去重和抽样 |
| 文档ID | 确定评论归属文档 | 文档合并时保留原ID映射 |
| 评审轮次 | 区分同一文档的多轮评审 | 无轮次标记时按评审起止时间划分 |
| 评论人 | 区分评审参与角色 | 仅用于分析参与结构，不用于个人排名 |
| 创建时间 | 归期依据 | 精确到分钟 |
| 解决状态 | 计算未解决评论数 | 已解决、未解决、已关闭不处理等取值需事先约定 |
| 关联任务ID | 判定评论是否转为任务 | 一条评论关联多个任务时按一条评论计 |
| 议题标签 | 归并同一议题 | 由评审人打标或按规则归并，需留痕 |
关联关系的记录方式：评论转为任务时，在评论上记录关联任务ID和转化时间；若工具支持评论与工作项直接关联，以系统关联记录为准；若只能手工登记，需指定登记人并在评审结束前完成，避免事后补记造成口径漂移。
特殊情形处理：删除的评论从分母中剔除，并在报表附注中记录剔除条数；文档合并后，原文档评论按映射关系归入合并后文档，评审轮次保留原轮次标记；评论跨轮次迁移时，以迁移后的归属为准，同时保留迁移记录，便于复核。
缺失值与分母为零：关联任务ID缺失的评论，不计入分子，但保留在分母中，并单独统计缺失条数；议题标签缺失的评论，不计入重复讨论率的分子。分母为零时输出“无有效样本”，不写0%或100%，同时附上被排除的评论数量。
计算与评估步骤：从取数到出数的流程
按以下步骤执行，每一步都产出可核对的结果，便于他人复算。
- 圈定样本：按文档ID和评审轮次筛选统计期内的评论，导出字段清单，剔除系统通知、纯表情和无信息回复，得到有效评审评论总数，作为两个比例指标的分母。
- 计算评论转任务比例：评论转任务比例＝被转为任务的评审评论数÷有效评审评论总数×100%。分子按评论条数计，一条评论关联多个任务只计一次；转化发生在统计期之后的，仍计入评论创建所在期。
- 归并议题并计算重复讨论率：先按议题标签或书面归并规则把评论归入议题，同一文档同一议题下第二条及以后发起的评论计为重复评论。重复讨论率＝重复评论数÷该文档有效评审评论总数×100%。归并规则需在统计前确定并记录版本。
- 计算未解决评论数：在统计时点对评论解决状态取快照，统计未解决状态的评论条数，按文档和评审轮次分别列出。
- 计算响应时长：响应时长＝首条实质回复时间－评论创建时间，单位取小时或工作日，需注明是否扣除非工作日；无实质回复的评论单独计数，不参与均值计算，避免拉低或抬高平均值。
- 分层汇总：按文档、按评审轮次、按时间段三个层级分别汇总，先看单文档明细，再看轮次趋势，最后看月度汇总，避免只报总数掩盖个别文档的异常。
- 抽样复核与口径校准：每期抽取一定比例评论，人工核对转任务标记和议题归并是否准确，记录误判条数；误判率超过约定阈值时，修订规则并重算当期数据，规则变更需留版本记录。
在评论与任务衔接的环节，ONES Wiki 支持成员在线添加注释和评论，文档可关联项目任务，页面版本可查看与回滚。团队可以把评审意见的讨论留在文档评论中，把需要跟进的事项落到关联任务上，使评论与工作项保持对应关系，为上述字段的记录提供承载方式。具体到评论级转任务标记和统计报表的取数方式，需结合团队实际使用的产品版本确认。
算例：一份评审文档的口径演示
以下为演示情景，数字为虚构，用于说明计算过程。
某文档一轮评审共产生评论52条，其中系统通知6条、纯表情回复2条，有效评审评论44条。有效评论中，被转为任务的有11条；按议题标签归并后，同一议题再次发起的评论有9条。
- 评论转任务比例＝11÷44×100%＝25.0%。
- 重复讨论率＝9÷44×100%＝20.5%。
- 统计时点未解决评论18条；有实质回复的评论平均响应时长为26小时，另有5条评论至统计时点无实质回复，单独列出。
易错点演示一：分母为零。若另一份文档本轮评审只有3条系统通知，有效评论为0，则两个比例均输出“无有效样本”，并注明排除3条系统通知，不写0%。
易错点演示二：归并规则不同。上例中若把“格式统一”和“术语一致”合并为一个议题，重复评论数由9条变为12条，重复讨论率变为12÷44×100%＝27.3%。同一份数据因归并粒度不同相差近7个百分点，说明规则必须事先约定并留痕，跨期比较时使用同一版本规则。
易错点演示三：议题无法归并。若8条评论缺少议题标签且无法按内容归并，则这8条不计入重复讨论率分子，分母仍保留，并在附注中说明，避免通过剔除难归并评论抬高或压低指标。
解读与限制：指标能说明什么、不能说明什么
两个指标反映的是评论的处理方式和讨论结构，不能单独作为评审质量的结论。转任务比例高，可能说明评审意见具体、可执行，也可能说明团队习惯把任何意见都开成任务；比例低，可能是意见已在评论中直接解决，也可能是意见被忽略。需要结合未解决评论数、响应时长和抽样复核一起判断。
可比性有几条边界需要遵守：
- 文档类型影响基线：需求文档、设计说明、操作手册的评审深度和评论密度差异明显，不同文档类型的比例不宜直接横比，应分别设定观察区间。
- 评审阶段影响结果：初稿评审的重复讨论通常多于终稿确认，跨轮次直接比较会误判改进效果，应按轮次分别观察趋势。
- 议题归并带主观性：重复讨论率对归并粒度敏感，规则调整后需重算历史数据或标注断点，否则趋势线不可信。
- 不设通用达标线：不同团队、不同文档规范下的合理区间不同，建议先用自身历史数据建立基线，观察变化方向，再讨论是否需要调整流程。
把四个指标放在一起看，再配合定期抽样复核，才能判断评论闭环是否真的改善：意见有没有落到可执行动作，讨论有没有在合理轮次内收敛，未解决评论是否在评审结束前清零。
常见问题
评论转任务比例的分母要不要包含已经关闭或删除的评论？
删除的评论从分母中剔除，并在报表附注中记录剔除条数，便于他人复核。已关闭的评论只要属于实质评审评论，仍计入分母，因为它是评审过程中真实产生的意见；关闭状态影响的是未解决评论数的快照统计，不影响转任务比例的分母。需要留意的是，如果团队在评审结束后批量删除低价值评论，分母会被人为缩小，建议在附注中同时记录删除条数占原始评论数的比例，作为口径稳定性的观察项。
一条评论里提了三个问题，只转了一个任务，分子怎么算？
按评论条数计，这条评论计为1条已转任务评论，分子加1，不按问题个数拆分。这样处理的前提是评论以条为单位统计，与分母口径保持一致。如果团队希望更细地反映意见落实情况，可以在评审规范中要求一议题一评论，使评论条数与问题个数接近；规范调整后需重算历史数据或标注断点，否则前后期数据不可比。拆分统计会改变分子分母的对应关系，不建议在同一报表中混用两种粒度。
议题归并规则中途调整了，历史数据还能直接比较吗？
不能直接比较。重复讨论率对归并粒度敏感，算例中把两个议题合并后，同一份数据的重复讨论率从20.5%变为27.3%，相差近7个百分点。规则调整后有两种处理方式：按新规则重算历史数据，使趋势线连续；或保留旧数据并在调整时点标注断点，断点前后的数据分开解读。无论哪种方式，都要记录规则版本、生效时间和调整原因，抽样复核时按对应版本核对，避免用新规则检查旧数据造成误判。
评审评论很少的文档，比例指标还有参考价值吗？
样本量过小时比例波动很大，一条评论的增减就可能带来几个百分点的变化。建议对有效评论数低于约定阈值的文档，只报评论条数和明细，不单独解读比例，或把同类小样本文档合并后再看比例。合并时需保证文档类型和评审阶段相近，否则不同基线混在一起，比例失去可比性。分母为零时直接输出“无有效样本”，并注明被排除的评论数量，不写0%。
评论和任务的关联关系靠人工登记，怎么保证统计可信？
人工登记的关键是时点和责任人固定：指定登记人在评审结束前完成关联记录，记录关联任务ID和转化时间，避免事后补记造成口径漂移。每期抽样核对转任务标记，记录误判条数，误判率超过约定阈值时修订登记规则并重算当期数据。若使用的工具支持评论与工作项直接关联，以系统关联记录为准，可以减少人工登记误差；ONES Wiki 支持成员在线添加注释和评论，文档可关联项目任务，页面版本可查看与回滚，可作为评论讨论与任务跟进的承载方式，评论级转任务标记和统计取数的具体方式需结合团队实际使用的产品版本确认。
