衡量文档更新计划的执行效果，需要把“是否按计划更新”和“更新后是否产生价值”分开评估，并为每个指标写清公式、分子分母、统计时间窗与缺失值处理方式。本文给出一套可复算的三层指标与计算步骤，并说明如何结合抽样核验和使用方反馈解释结果，避免用单一数字证明计划有效。
要点总览（TL;DR）
- 衡量执行效果要分两层：计划执行度看更新是否按计划发生，计划有效性看更新后文档是否仍准确、可用、被需要的人找到，两层指标不能互相替代。
- 指标按计划层、执行层、结果层组织：计划层看按期更新率与逾期分布，执行层看评审完成比例、旧版本归档比例、更新记录完整率，结果层看访问引用变化与过期引发的返工咨询。
- 每个指标写清公式、分子分母、统计时间窗、单位与排除项，并提前约定“更新”以实质修改时间计、草稿修改不计入、无责任人文档不计入分母等口径。
- 计算按五步走：锁定清单形成分母、按公式取数、做趋势与分布分析、抽样核验与使用方反馈交叉验证、形成结论并标注不确定项。
- 高按期更新率不等于内容准确，访问量受入口与搜索排序影响，指标间可能冲突，需组合使用并定期复核口径。
评估目标：先定义“执行效果”指什么
“执行效果好不好”是一个模糊问题，直接取数容易得到互相矛盾的结论。评估开始前，先把目标拆成两层：计划执行度回答“更新动作有没有按计划发生”，计划有效性回答“更新之后文档是否仍然准确、可用、被需要的人找到”。两层目标对应不同指标，也对应不同的结论用途，混在一起会让数字失去解释力。
评估对象需要写清楚三件事：纳入评估的文档集（例如某产品线的操作手册、某部门的制度文档）、计划周期（月度、季度或半年）、责任角色（文档责任人、评审人、发布人）。范围不写清，分母就会随统计人的理解变化，不同部门算出的按期更新率无法比较。
评估结论的用途应提前约定。常见用途包括：判断当前更新频次是否合理、是否需要补充编写或评审人力、流程中哪个环节造成积压。把结论定位为调整计划与流程的依据，而非个人绩效考核，可以减少执行者为达标而做形式化修改的动机，也让数据更接近真实状态。
本评估回答的问题是：在给定文档范围与周期内，计划被执行到什么程度，执行后文档是否仍被有效使用。内容质量的专业判断、发布审核流程的详细设计不在本文范围内，需要由对应的专业评审承担。
指标与范围：三层指标及统计边界
指标按计划层、执行层、结果层组织。计划层看更新是否按期发生，执行层看更新动作是否走完必要环节，结果层看文档更新后是否仍被使用、是否因过期引发问题。三层指标组合使用，才能同时回答执行度和有效性。
| 层级 | 指标名 | 公式 | 单位 | 统计范围 |
|---|---|---|---|---|
| 计划层 | 按期更新率 | 统计期内按期完成更新的文档数 ÷ 应更新文档数 × 100% | 百分比 | 纳入清单且计划周期内有更新要求的文档 |
| 计划层 | 逾期文档数 | 统计期末仍未完成计划更新的文档数 | 篇 | 同上，按文档计数 |
| 计划层 | 逾期天数分布 | 按逾期天数分档（1–7天、8–30天、30天以上）统计文档数 | 篇 | 逾期文档，按实际逾期天数归档 |
| 执行层 | 更新后完成评审比例 | 更新后完成评审的文档数 ÷ 统计期内完成更新的文档数 × 100% | 百分比 | 统计期内有更新动作的文档 |
| 执行层 | 旧版本归档比例 | 更新后旧版本已归档的文档数 ÷ 统计期内完成更新的文档数 × 100% | 百分比 | 同上 |
| 执行层 | 更新记录完整率 | 更新时间、修改人、修改说明三项齐全的更新记录数 ÷ 更新记录总数 × 100% | 百分比 | 统计期内的全部更新记录 |
| 结果层 | 文档访问与引用变化 | 统计期访问量或引用次数 ÷ 上一同长度周期对应值 − 1 | 百分比 | 同一文档集，两周期口径一致 |
| 结果层 | 过期文档引发的返工或咨询次数 | 统计期内因文档过期导致的返工单数 + 相关咨询记录数 | 次 | 可归因到具体文档的记录 |
范围界定要落到可核对的清单：纳入哪些文档类型（操作手册、接口说明、制度文件等）、涉及哪些责任部门、统计起止日期。排除项同样要写明，例如已下线文档、处于草稿状态尚未发布的文档、统计期内新建且未到首个更新节点的文档。排除项不写清，按期更新率会被新建文档稀释或抬高。
数据口径与证据：每个数字从哪里来
指标定义一致，取数规则不一致，两个人仍会算出不同结果。口径说明要覆盖数据来源、关键定义和缺失处理三部分，并形成一份取数对照表，供复算时逐项核对。
数据来源主要是文档管理系统中的版本记录、更新时间、责任人字段，以及评审与发布记录。版本记录用于确认文档是否发生过实质修改及修改时间；责任人字段用于确定应更新文档清单；评审与发布记录用于计算执行层指标。ONES Wiki 的官网描述提到记录所有页面版本并支持随时查看与回滚，可作为版本追溯的取数依据之一；具体字段明细、导出方式与统计视图需结合实际配置核验。
关键口径需要提前约定并写入说明：
- “更新”以最近一次实质修改时间计，还是以首次发布时间计。建议以实质修改时间计，并在说明中定义“实质修改”的判定标准，例如正文内容变更超过一定篇幅或关键结论发生变化。
- 草稿状态的修改是否计入更新。建议不计入，只有发布后的修改才视为计划执行。
- 同一文档一个周期内多次修改如何计数。建议按文档计数，按期更新率的分母是文档数，不是修改次数。
缺失与异常处理规则要写死：无责任人的文档单独列出，不计入按期更新率分母，同时作为清单问题反馈；无更新记录的文档按“未更新”处理；时间字段为空的记录不参与时间相关计算，并记录缺失数量。缺失比例过高时，指标结论需标注可信度受限。
定量指标之外，补充两类定性证据：一是抽样核验，按文档类型分层抽取一定数量，检查更新内容是否为实质变化而非格式调整；二是使用方反馈，通过访谈或反馈记录收集“最近是否遇到文档与实际不符”的具体案例。定性证据用于解释数字背后的原因，不替代指标计算。
计算与评估步骤：从取数到结论
按以下五步执行，每一步留下可复算的记录，便于他人核对或下期对比。
- 锁定文档清单与计划周期，形成分母。导出纳入范围的文档清单，标注每篇文档的计划更新频次与应更新日期，剔除排除项，得到应更新文档数。这一步的产物是一份带责任人和计划节点的清单。
- 按公式计算各层指标，记录分子分母与时间窗。逐项填写指标计算表，每个数字旁注明取数日期、数据来源和统计起止时间。计划层与执行层指标按文档计数，结果层指标注明对比周期。
- 做趋势与分布分析，而非只看平均值。按期更新率按部门或文档类型拆分，逾期天数用分档分布呈现。平均值相同的情况下，逾期集中在少数文档和普遍轻微逾期，对应的改进动作完全不同。
- 抽样核验与使用方反馈交叉验证。对标记为“已更新”的文档抽样检查内容是否实质变化，对结果层指标异常（访问量骤降、返工集中）的文档追查原因，把定性发现与定量结果对照。
- 形成结论并标注不确定项。结论写明哪些指标支持“执行到位”、哪些环节存在积压、哪些数字因缺失或样本不足需要谨慎解读，并给出下一周期可调整的具体动作。
计算记录模板可包含：指标名、分子、分母、结果、取数日期、数据来源、缺失记录数、备注。模板固定后，不同周期、不同部门按同一结构填报，横向比较才有意义。
例子：一个季度的更新计划评估
以下为演示情景，数字用于说明计算方式，不代表任何组织的实际水平。
某部门纳入评估的制度文档共 120 篇，计划要求每季度至少更新一次，统计期为第一季度（1月1日至3月31日）。其中 6 篇在统计期内新建且未到首个更新节点，按排除项处理，应更新文档数为 114 篇。
季度末统计：按期完成更新的文档 96 篇，则按期更新率 = 96 ÷ 114 × 100% ≈ 84.2%。逾期文档 18 篇，按逾期天数分档：1–7天 10 篇，8–30天 6 篇，30天以上 2 篇。逾期集中在少数文档，说明问题更可能出在个别责任人的工作量或交接，而非整体计划频次不合理。
执行层：96 篇完成更新的文档中，完成评审的 72 篇，评审完成比例 = 72 ÷ 96 × 100% = 75%；旧版本已归档的 84 篇，归档比例 = 84 ÷ 96 × 100% = 87.5%；更新记录三项齐全的 90 条，完整率 = 90 ÷ 96 × 100% ≈ 93.8%。评审完成比例偏低，提示更新动作走完了修改，但确认环节存在缺口。
结果层：本季度文档访问量较上季度下降 8%，同期文档集规模未变。结合抽样核验发现，下降主要来自两篇入口位置调整的文档，其余文档访问平稳，因此不能直接判定文档价值下降。返工与咨询记录中可归因到文档过期的共 5 次，其中 3 次涉及逾期 30 天以上的文档，与计划层分布相互印证。
边界情况处理：若某文档类型在统计期内应更新文档数为 0，按期更新率的分母为零，此时不计算百分比，改用绝对数量描述，例如“本期无应更新文档，发生主动更新 3 篇”。若某部门应更新文档仅 4 篇，样本过小，百分比波动会被放大，建议合并到上级部门统计或延长统计窗口，并在结论中注明样本量。
解读与限制：指标能说明什么、不能说明什么
按期更新率高，说明更新动作按计划发生了，不能直接推出内容准确。文档可能被修改了日期或做了格式调整，实质内容未变。因此计划层指标需要与抽样核验配合，抽样发现形式化修改比例偏高时，应回头检查计划频次是否过密、更新标准是否清晰。
访问量受入口位置、搜索排序、链接引用等多重因素影响，单独用访问量变化证明文档价值容易误判。结果层指标更适合作为线索：访问下降时追查是入口变化还是内容过时，返工与咨询记录则能提供更直接的过期证据。
指标之间可能冲突。为提升按期更新率，执行者可能做小改动即标记完成，导致评审完成比例和内容实质变化比例同时下降。评估时应把计划层与执行层、结果层指标放在一起看，发现指标间背离时优先核查取数口径和执行行为，而非单独奖励某一指标。
建议每季度或每半年复核一次口径说明，文档类型、责任分工或系统字段发生变化时同步更新，保证跨期数据可比。结论中保留不确定项和缺失记录数，让读者知道哪些判断有数据支撑、哪些需要进一步核实。文档的版本记录、更新时间与责任人信息在协作平台中留痕，是上述取数与复核的基础；ONES Wiki 记录所有页面版本并支持查看与回滚，可作为版本追溯的取数来源之一，具体统计视图与字段导出能力需结合实际配置确认。
常见问题
计划周期内新建的文档，要不要计入按期更新率的分母？
建议不计入。新建文档尚未到首个更新节点，计入分母会拉低按期更新率，让执行情况显得比实际差。处理方式是在范围界定中把“统计期内新建且未到首个更新节点”的文档列为排除项，单独记录数量，并在结论中说明排除依据。如果新建文档数量较大，可以另设一个观察指标，例如新建文档首个更新节点的按期完成情况，与存量文档分开统计。
文档更新了但没走评审，算不算完成计划？
这取决于计划对“完成”的定义。如果计划只要求内容更新，修改发布即可视为完成；如果流程要求更新后经评审确认，那么未评审的更新只能算执行了一部分。建议在指标上分开呈现：计划层按期更新率反映更新动作是否发生，执行层评审完成比例反映流程是否走完。两者同时偏低说明执行整体不足，按期更新率高而评审完成比例低，则提示确认环节存在缺口，需要检查评审人力或流程节点设置。
文档数量少的部门，按期更新率波动很大，怎么处理？
样本过小时百分比会被单篇文档放大，例如应更新 4 篇、逾期 1 篇，按期更新率就从 100% 掉到 75%，不宜直接与其他部门比较。可选的处理方式有三种：合并到上级部门统计、延长统计窗口累积样本、改用绝对数量描述（如“应更新 4 篇，按期完成 3 篇”）。无论采用哪种，都要在结论中注明样本量和处理方式，避免读者误读。
没有文档管理系统，靠人工登记表能算出这些指标吗？
可以，但需要先固定登记字段。至少包含：文档名称、责任人、计划更新频次、应更新日期、实际更新时间、是否完成评审、旧版本是否归档、修改说明。字段固定后，按期更新率、逾期分布、评审完成比例都能从登记表直接统计。风险在于登记依赖人工填报，完整率和真实性需要抽查核验，建议定期抽取部分文档与正文实际修改记录比对。使用协作平台记录版本与更新时间，可以减少人工登记的遗漏。
评估结果要不要和责任人绩效挂钩？
建议谨慎。指标与个人绩效直接挂钩后，执行者容易通过形式化小改动提升按期更新率，导致数字好看但内容实质未变，评审完成比例和抽样核验结果反而下降。更稳妥的做法是把评估结论用于调整计划频次、补充编写与评审人力、优化流程节点，个人层面只做异常沟通，例如逾期集中在少数文档时了解具体原因。若确需纳入考核，应同时使用计划层与结果层指标，并保留抽样核验环节。
