评估文档更新计划的执行情况，先要明确评估目标，再统一统计口径。具体做法是把计划拆成可计数的应更新文档清单，在固定时间窗内计算按期完成率、范围覆盖率、逾期时长和返工率，并抽样核验内容是否实质更新。本文给出指标定义、分母与时间窗规则、可复算的计算步骤和一个季度示例，并说明结果解读的边界。ONES 的工作项与文档状态可用于承载更新计划和执行记录，便于后续取数。
要点总览（TL;DR）
- 评估文档更新计划执行情况，先把“执行情况”拆成进度、范围、质量三类问题，再选择对应指标，避免只盯一个完成率。
- 常用指标包括按期完成率、范围覆盖率、平均逾期天数、返工率和计划外更新占比，各自回答不同问题，需要组合使用。
- 统计前要书面固定应更新文档清单的来源、统计时间窗、截止时点，以及分母为零、文档下架、责任人变更、计划中途调整的处理规则。
- 计算按期完成率时，分子是实际更新日期不晚于计划日期的文档数，分母是锁定的应更新文档数，两者使用同一时间窗。
- 高完成率不等于内容质量高，需抽样核验版本对比和修改说明；文档类型差异、计划本身不合理和小样本都会影响结果解读。
评估目标：先确定要回答哪几个问题
“执行情况”是一个笼统的说法，直接开始统计容易变成指标堆砌。评估前先把问题拆成三类，每类对应不同的数据来源和判断方式。
- 进度类问题：计划中的文档是否按期更新？关注计划日期与实际更新日期的对比，回答“有没有拖”。
- 范围类问题：该更新的文档是否都纳入了计划并完成？关注应更新清单与实际更新清单的差集，回答“有没有漏”。
- 质量类问题：更新后的内容是否真正有效？关注版本变化是否对应实质内容修改，回答“改了有没有用”。
三类问题缺一不可。只看进度，会出现“按期改了但只改错别字”的情况；只看范围，无法判断时间上的拖延程度；只看质量，则缺少整体执行面的量化依据。
接着明确评估结果的用途。用于季度复盘时，指标宜粗、宜稳定，便于跨周期比较；用于调整责任分工时，需要按责任人和文档类型分组；用于修订下一轮计划时，则要重点分析逾期原因和计划本身的合理性。用途不同，取数粒度和汇报形式也不同。
最后界定评估周期与评估对象。周期可以是月度、季度或按发布节奏设定，对象要写清楚是哪个文档集合、覆盖哪些责任人范围。例如“产品知识库中由产品团队负责的 120 篇文档，评估 2025 年第三季度”。边界写清楚，后续分母才有依据。
指标与范围：文档更新计划执行情况的指标清单
下面五个指标分别对应进度、范围、时效、质量和计划稳定性，建议组合使用。每个指标都要在报告中注明统计窗口，否则数字之间不可比。
| 指标 | 回答的问题 | 适用对象 |
|---|---|---|
| 按期完成率 | 计划内的文档有多少在截止日前完成更新 | 所有纳入计划的文档 |
| 范围覆盖率 | 应更新清单中有多少文档实际产生了更新 | 按周期规则或变更触发的文档集合 |
| 平均逾期天数 | 未按期完成的文档平均拖了多久 | 逾期文档，用于判断拖延程度 |
| 返工率（二次修改率） | 更新完成后短期内又被再次修改的比例 | 有评审环节或质量要求较高的文档 |
| 计划外更新占比 | 实际更新中有多少不在原计划内 | 全部更新记录，用于评估计划准确性 |
指标之间是互补关系。按期完成率高但范围覆盖率低，说明计划本身漏掉了应更新文档；两项都高但返工率高，说明更新质量或评审环节存在问题；计划外更新占比持续偏高，说明计划编制时对变更来源估计不足。单一指标只能说明一个侧面，组合起来才能定位问题出在计划、执行还是质量环节。
不同文档类型适用的指标权重不同。操作手册、对外说明类文档对时效敏感，应重点看按期完成率和逾期天数；制度、规范类文档变更频率低，更适合看范围覆盖率和返工率；项目过程文档随项目节奏更新，计划外更新占比本身就有参考价值。
数据口径：分母、时间窗与缺失值怎么定
口径不统一是评估结果无法复算的主要原因。以下四项规则需要在统计前书面确定，并在每个周期沿用。
应更新文档清单怎么形成
常见来源有三种：一是计划登记，即周期开始时由责任人逐条登记本期需要更新的文档；二是周期规则，例如规定核心文档每季度复核一次、对外文档每半年更新一次，按规则自动生成清单；三是变更触发，例如需求变更、流程调整、版本发布后，关联文档自动进入应更新范围。三种来源可以并用，但要在清单中标注来源，便于后续分析漏项原因。
统计时间窗与截止时点
时间窗要同时定义起点和终点。起点通常是计划周期的第一天，终点是周期最后一天 24:00。按期完成的判断标准是“实际更新日期不晚于计划日期”，两个日期都取自然日，避免因提交时间在当天早晚产生争议。跨周期补做的文档计入实际完成所在周期，并在原周期标注为逾期，防止同一文档在两个周期重复计数。
特殊情况的处理规则
- 分母为零：某类文档本期没有应更新项时，该指标记为“不适用”，不写 0%，避免拉低整体均值。
- 文档下架或合并：在统计截止前已正式下架的文档从分母中剔除，并单独记录剔除数量；合并到其他文档的，按合并后的文档计一次。
- 责任人变更：以计划周期结束时登记的责任人为准，变更记录保留在备注中，分组统计时不追溯拆分。
- 计划中途调整：周期内新增或取消的计划项需经确认后生效，调整前后的清单都要留档，报告中注明“含中途调整 N 项”。
需要记录的字段
每篇应更新文档至少记录：文档标识、文档类型、责任人、计划更新日期、实际更新日期、更新后版本号、更新来源（计划内/计划外）、状态（完成/逾期/取消）。字段齐全，指标才能复算，也才能按类型和责任人分组。
计算与评估步骤：从取数到得出结论
按以下顺序执行，每一步的产物都可以被下一个人复核。
- 锁定清单。导出本期应更新文档清单，确认总数，记录中途调整项。这个总数就是后续多数指标的分母。
- 计算按期完成率。按期完成率 = 按期完成文档数 ÷ 应更新文档数 × 100%。分子是实际更新日期不晚于计划日期的文档数，分母是第 1 步锁定的应更新文档数，两者使用同一时间窗。
- 计算范围覆盖率。范围覆盖率 = 实际产生更新的文档数 ÷ 应更新文档数 × 100%。与按期完成率的区别在于，覆盖率只问“改没改”，不问“是否按时”，两者之差可以近似反映“改了但迟了”的规模。
- 计算平均逾期天数。对每篇逾期文档计算实际更新日期减计划日期的天数，取算术平均。尚未完成的逾期文档按统计截止日计算已逾期天数，并单独标注“未完成”。
- 计算返工率。返工率 = 更新后 30 天内再次修改的文档数 ÷ 本期完成更新的文档数 × 100%。30 天是示例窗口，团队可根据文档类型调整，但要在口径中固定。
- 抽样核验内容。从本期完成更新的文档中按类型分层抽取，每类不少于 5 篇或 10%，取较大者。核验证据包括版本对比记录、修改说明、评审意见。通过标准建议设为：修改内容与计划中声明的更新目的对应，关键段落有实质变化，无遗留的过期表述。任一项不满足记为不通过。
- 分组对比。按文档类型、责任人、更新来源分别汇总上述指标，找出差异集中的组，再回到具体文档查看原因。
定量指标回答“完成了多少”，抽样核验回答“完成得怎么样”，两者结合才能形成完整判断。核验不通过的文档即使计入按期完成，也应在报告中单独披露。
例子：一个季度的文档更新计划评估
以下为演示情景，数字用于说明计算过程，不代表任何团队的基准水平。
某产品团队第三季度应更新文档 80 篇，其中计划登记 60 篇、周期规则生成 15 篇、变更触发 5 篇。季度内中途新增 4 篇、取消 2 篇，调整后应更新文档为 82 篇。
| 项目 | 数量 | 说明 |
|---|---|---|
| 调整后应更新文档 | 82 篇 | 分母 |
| 按期完成 | 61 篇 | 实际更新日期不晚于计划日期 |
| 逾期完成 | 13 篇 | 平均逾期 9 天 |
| 截至季末未完成 | 8 篇 | 平均已逾期 21 天 |
| 实际产生更新 | 74 篇 | 含逾期完成 |
按期完成率 = 61 ÷ 82 × 100% ≈ 74.4%。范围覆盖率 = 74 ÷ 82 × 100% ≈ 90.2%。两者相差约 15.8 个百分点，说明主要问题在时间而非遗漏。全部逾期文档的平均逾期天数为 (13×9 + 8×21) ÷ 21 ≈ 13.6 天。
本期完成更新的 74 篇中，30 天内再次修改的有 9 篇，返工率 ≈ 12.2%。计划外更新共 11 篇，占实际更新的 14.9%，主要集中在需求变更触发的接口文档。
抽样核验抽取 20 篇，其中 17 篇通过，3 篇未通过，问题分别是：两篇只更新了标题和日期、正文未变；一篇仍保留已下线的旧流程描述。这 3 篇中有 2 篇计入了按期完成，说明按期完成率对内容质量不敏感。
据此可以得出判断：本期执行的主要短板是逾期集中和部分更新流于形式。后续动作可以包括：对逾期集中的接口文档调整计划节奏或提前触发；在完成标准中增加“版本对比需体现实质修改”的要求；对核验未通过的文档安排补做并纳入下期跟踪。
解读与限制：结果怎么用、哪些情况不能下结论
指标是执行情况的近似描述，使用时要守住几条边界。
高完成率不等于内容质量高。按期完成率只比较日期，不判断修改是否有效。必须结合抽样核验的证据一起看，核验不通过的比例应作为独立结论披露，不能因为完成率高就省略。
文档类型差异会影响可比性。操作手册和制度文档的更新难度、评审环节不同，直接比较完成率意义有限。跨类型汇总时给出总体值，分析原因时按类型拆开。
计划本身的合理性要先检查。如果计划日期普遍设置过紧，低完成率反映的是计划问题而非执行问题。可以对比历史逾期分布和计划编制时的估算依据，判断是否需要调整计划节奏。
小样本下谨慎解读。某类文档应更新数量少于 10 篇时，完成率的波动很大，一篇文档的差异就能造成十个百分点以上的变化。这类分组宜看具体文档清单，不急于下结论。
结果要回到下一轮计划。评估的价值在于修订：把逾期原因归类为计划估算、资源冲突、变更冲击或流程等待，分别对应调整计划日期、明确责任人投入、完善变更触发规则、简化评审环节。下一轮计划修订后，沿用同一口径再统计，才能看出改进是否发生。
在协作层面，更新计划和执行记录需要有稳定的承载位置。ONES Wiki 记录所有页面版本并支持随时查看与回滚，页面组可关联项目，文档可嵌入任务进度和报表；配合 ONES 的项目与任务管理，可以把“哪篇文档、由谁、计划何时更新、实际何时完成”对应到具体工作项和文档状态上，为上述指标提供可追溯的取数基础。具体统计口径仍需团队按本文方法自行定义。
常见问题
计划中途新增或取消的文档，统计时应该怎么处理？
周期内新增或取消的计划项，需要经过确认后生效，调整前后的清单都要留档，并在报告中注明“含中途调整 N 项”。统计时以调整后的清单作为分母，这样按期完成率和范围覆盖率才能反映实际执行范围。如果调整频繁，建议单独统计调整次数，作为评估计划稳定性的参考。
按期完成率和范围覆盖率都高，是否说明更新计划执行得好？
两项指标都高，说明文档基本都更新了、时间上也基本守住了，但还不能判断内容是否有效。需要结合抽样核验，检查版本对比中是否有实质修改、是否清理了过期表述。如果返工率也偏高，说明更新后短期内又被反复修改，质量或评审环节可能存在问题。三项一起看，才能区分“按时交差”和“真正更新到位”。
某类文档本期应更新数量很少，完成率波动很大，怎么汇报？
应更新数量少于 10 篇时，一篇文档的差异就能造成十个百分点以上的变化，完成率不适合作为独立结论。建议这类分组直接列出具体文档清单和完成状态，说明未完成的是哪几篇、原因是什么，把完成率作为参考值附在后面。跨周期积累到足够样本后，再比较趋势。
评估结果出来后，怎么判断问题出在计划还是执行？
可以先看逾期分布和计划日期的设置依据。如果逾期集中在某几类文档，且计划日期普遍紧贴发布节点，问题可能出在计划估算；如果计划日期留有合理余量但仍有大量逾期，更可能是资源冲突或流程等待。把逾期原因归类为计划估算、资源冲突、变更冲击、流程等待四类，分别对应调整计划日期、明确责任人投入、完善变更触发规则、简化评审环节，下一轮沿用同一口径再统计，才能看出改进是否发生。
更新计划和执行记录放在哪里，后续取数才方便？
关键是让“哪篇文档、由谁负责、计划何时更新、实际何时完成”这几个字段有稳定的记录位置。ONES Wiki 记录所有页面版本并支持随时查看与回滚，页面组可关联项目，文档可嵌入任务进度和报表；配合 ONES 的项目与任务管理，可以把更新计划和执行记录对应到具体工作项和文档状态上，为按期完成率、逾期天数等指标提供可追溯的取数基础。具体统计口径仍需团队按本文方法自行定义。
