研发效能指标字典把每个指标的名称、公式、数据来源和口径边界写成可查的记录，让不同团队按同一口径取数和解读。本文提供一份可直接复制到表格工具的空白模板，并说明字段填写规范、必填与选填的划分、一条完整记录的示例，以及后续评审与版本维护的做法。
要点总览（TL;DR）
- 模板包含12个字段：指标编号、名称、所属维度、业务问题、计算公式、统计口径与边界、数据来源、统计周期、责任角色、目标值/参考值、版本、更新日期，可直接复制到表格工具。
- 最小可用字典由9个必填字段组成，目标值/参考值、版本、更新日期按治理需要逐步补齐；必填缺失的指标只作草稿登记，不进入正式看板。
- 填写时把公式的分子分母写全，口径边界至少覆盖起止时点、纳入范围、排除项和异常值处理，这是跨团队对齐的关键。
- 维护上按季度复核，口径变更升主版本并保留旧记录，看板和报表引用字典编号与版本，按先更新字典、再更新看板说明、最后切换取数的顺序执行。
可复制空白指标字典模板
下面的表格可以直接复制到 Excel、在线表格或文档表格中使用。一行登记一个指标，列顺序按填写顺序排列：先写清指标是什么、回答什么问题，再写公式和数据来源，最后补治理信息。字段类型约定写在表格之后，复制时一并保留。
| 指标编号 | 指标名称 | 所属维度 | 业务问题 | 计算公式 | 统计口径与边界 | 数据来源 | 统计周期 | 责任角色 | 目标值/参考值 | 版本 | 更新日期 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| MET-001 | （示例：需求交付周期） | （交付效率） | （需求从进入到交付平均要多久） | （公式见字段说明） | （起止点、排除项、单位） | （系统与字段） | （周/月/迭代） | （角色名称） | （数值+单位） | （v1.0） | （YYYY-MM-DD） |
字段类型与填写格式约定如下，复制模板时建议把这一行作为表头下方的格式说明保留，或在表格工具中设置为数据验证规则：
| 字段 | 字段类型 | 填写格式约定 |
|---|---|---|
| 指标编号 | 文本，唯一 | 前缀+三位流水号，如 MET-001；一经分配不随名称变更而改号 |
| 指标名称 | 文本 | 名词短语，能独立看懂，不带“率”“数”以外的修饰性口号 |
| 所属维度 | 枚举 | 从团队约定的维度清单中选一个，如交付效率、交付质量、进度、资源效率 |
| 业务问题 | 文本，一句话 | 以问句或“用于判断……”开头，说明这个指标帮助回答什么 |
| 计算公式 | 文本 | 用字段名和四则运算表达，分子分母写全，不写“按系统默认” |
| 统计口径与边界 | 文本，条目式 | 写明起止时点、纳入与排除范围、单位、异常值处理 |
| 数据来源 | 文本 | 系统名称+对象+字段，多个来源按主次列出 |
| 统计周期 | 枚举 | 日、周、迭代、月、季度，与看板刷新频率一致 |
| 责任角色 | 文本 | 写岗位角色而非个人姓名，便于人员变动时交接 |
| 目标值/参考值 | 数值+单位 | 目标值写期望水平，参考值写当前基线，两者不混用 |
| 版本 | 文本 | v主版本.次版本，口径变更升主版本，文字修订升次版本 |
| 更新日期 | 日期 | YYYY-MM-DD，每次修改后同步更新 |
字段说明：每个字段回答什么问题
字段的作用是让读字典的人不依赖口头解释就能复现取数。下面按字段分组说明填写意图，重点放在容易产生口径漂移的地方。
标识类字段：指标编号与指标名称
指标编号解决“同一个指标被叫成多个名字”的问题。编号按维度分段分配，例如交付效率用 MET-0xx、交付质量用 MET-1xx，新增指标顺延取号，废弃指标保留编号并标注状态，避免旧报表引用时找不到对应记录。指标名称采用“对象+动作结果”的名词短语，例如“需求交付周期”“线上缺陷密度”，名称中不写团队名和项目名，团队差异放到统计口径里表达。
定位类字段：所属维度与业务问题
所属维度决定指标在度量体系中的位置，也决定它和哪些指标一起被解读。填写时从团队已约定的维度清单中选一个，不要临时造维度。业务问题字段回答“为什么要有这个指标”，写法上落到具体判断，例如“判断需求从受理到上线的等待时间是否集中在某一环节”，比“提升交付效率”更能指导后续分析。一个指标对应一个主要业务问题，需要回答多个问题时拆成多个指标。
计算类字段：计算公式与统计口径边界
计算公式用数据字段名表达，分子分母写全。以需求交付周期为例，写成“Σ(需求上线时间 − 需求受理时间) ÷ 统计周期内上线需求数”，并注明时间单位为自然日还是工作日。统计口径与边界是防止同名指标口径漂移的关键，至少写清四件事：起止时点如何取（受理以状态变更为准还是以创建时间为准）、纳入哪些对象（是否含紧急插单、是否含缺陷修复类需求）、排除哪些情况（中途取消、合并的需求如何处理）、异常值如何处理（超长周期是否截断）。边界写得越具体，跨团队对比时争议越少。
取数与责任字段：数据来源、统计周期、责任角色
数据来源写到系统和字段一级，例如“项目管理系统—需求工作项—状态变更记录”，有多个来源时标明主来源和补充来源，并说明以哪个为准。统计周期与看板刷新频率保持一致，避免出现“字典写按月、看板按周”的错位。责任角色写岗位而非姓名，通常包括指标负责人（解释口径、答复疑问）和数据负责人（保障采集质量），两个角色可以由同一人承担，但要在字典中写明。
必填与选填：最小可用字典怎么定
一次性填满所有字段会让第一批指标迟迟无法登记。可行的做法是先确定最小可用字段集，保证口径能被复现，再按治理需要补充增强字段。
| 字段 | 类别 | 理由与适用场景 |
|---|---|---|
| 指标编号 | 必填 | 唯一标识，支撑引用、变更记录和废弃管理 |
| 指标名称 | 必填 | 检索和沟通的入口 |
| 所属维度 | 必填 | 决定指标在体系中的位置和解读语境 |
| 业务问题 | 必填 | 防止为度量而度量，也是后续评估指标是否保留的依据 |
| 计算公式 | 必填 | 没有公式就无法复现取数 |
| 统计口径与边界 | 必填 | 跨团队对齐的核心，缺失时同名指标无法比较 |
| 数据来源 | 必填 | 决定数据能否被采集和核验 |
| 统计周期 | 必填 | 影响数值解读，缺失会导致周期混用 |
| 责任角色 | 必填 | 口径疑问需要有明确答复人 |
| 目标值/参考值 | 选填 | 指标刚建立、基线尚未稳定时可先留空，积累几个周期后再补 |
| 版本 | 选填（建议尽早启用） | 指标数量少、变更不频繁时可暂缓，进入多团队共用阶段后应启用 |
| 更新日期 | 选填（建议尽早启用） | 与版本配套使用，单独存在时价值有限 |
最小可用字典即上表中的九个必填字段。字段缺失时的处理约定建议写进字典首页：必填字段缺失的指标不进入正式看板，只作为草稿登记；选填字段缺失不影响指标生效，但要在备注中说明计划补齐的时间。对于跨团队共用的指标，统计口径与边界缺失时应暂停对外发布数值，先完成口径评审再恢复。
填写示例：一条完整指标记录
下面用“需求交付周期”演示一条完整记录，字段与模板一一对应。示例中的数值和系统名称为演示情景，实际填写时替换为本团队的真实信息。
| 字段 | 填写内容 |
|---|---|
| 指标编号 | MET-001 |
| 指标名称 | 需求交付周期 |
| 所属维度 | 交付效率 |
| 业务问题 | 判断需求从受理到上线的等待时间主要消耗在哪个环节 |
| 计算公式 | Σ(需求上线时间 − 需求受理时间) ÷ 统计周期内上线需求数，单位：自然日 |
| 统计口径与边界 | 受理时间取需求状态首次变为“已受理”的时间；上线时间取需求关联发布单的完成时间；纳入统计周期内上线的全部需求；排除中途取消和合并关闭的需求；超过 60 天的记录按 60 天截断并在报表中标注 |
| 数据来源 | 项目管理系统—需求工作项—状态变更记录；发布单—完成时间（主来源为状态变更记录） |
| 统计周期 | 月 |
| 责任角色 | 指标负责人：研发效能负责人；数据负责人：项目管理平台管理员 |
| 目标值/参考值 | 目标值：≤ 15 自然日；参考值：近三个月均值 21 自然日 |
| 版本 | v1.0 |
| 更新日期 | 2025-03-10 |
逐字段看填写依据：编号按交付效率维度取号，后续同类指标顺延为 MET-002；业务问题写成可判断的问句，指向环节分析而非笼统的效率提升；公式把分子分母写全并注明单位，读者可以据此复算；口径边界覆盖了起止时点、纳入范围、排除项和异常值四类信息，其中“60 天截断”是团队约定，换团队时需要重新确认；数据来源写到字段一级并标明主来源，避免两个系统时间不一致时无法判断以谁为准；统计周期与月度看板一致；责任角色写岗位，人员调整时只需更新岗位对应的人；目标值与参考值分开填写，参考值来自近三个月实际数据，便于判断目标是否可达。
调整与维护：字典如何随团队演进
指标字典的价值在于长期被引用，维护机制要围绕“谁能改、怎么改、改完如何同步”设计。以下流程适用于指标数量超过一屏、开始被多个团队共用的阶段；指标很少的小团队可以简化评审环节，但变更记录建议保留。
新增指标与修改口径的评审
新增指标时，提出人按模板填写完整记录，重点说明业务问题和口径边界，提交给指标负责人评审。评审关注三点：是否与已有指标重复或高度相关、公式所需数据能否稳定采集、口径边界是否覆盖了常见争议场景。修改已有指标的口径属于影响面更大的变更，需要通知所有引用该指标的看板和报表负责人，确认切换时间后再生效。评审结论记录在字典的变更记录中，包括提出人、评审人、结论和生效日期。
版本号与变更记录的使用
口径变更升主版本，例如从 v1.0 到 v2.0，旧版本记录保留并标注停用日期，便于解释历史报表数值差异；文字表述修订、补充说明升次版本，如 v1.1。变更记录建议单独维护一张表，字段包括指标编号、变更类型、变更前后内容摘要、提出人、评审人、生效日期。看板和报表在引用指标时标注所依据的版本，出现数值跳变时先核对版本是否切换。
定期复核与废弃处理
建议每季度复核一次字典：检查每个指标的业务问题是否仍然成立、数据来源是否因系统调整而失效、目标值是否需要更新。连续两个周期无人查看、或业务问题已不存在的指标，标记为“待废弃”并公示一个周期，确认无引用后停用，编号保留不复用。复核结果同样记入变更记录，形成可追溯的维护轨迹。
字典与看板、报表口径的同步
字典是口径的唯一来源，看板和报表的指标说明应引用字典编号和版本，不在看板中另写一套定义。口径变更生效时，按“先更新字典、再更新看板说明、最后切换取数逻辑”的顺序执行，切换当天在看板标注版本变化。团队使用 ONES 时，可以把指标字典作为文档维护，将每个指标的评审与变更登记为工作项，让口径变更走与需求相同的流转和留痕；ONES 研发效能管理解决方案对交付效率、交付质量、进度情况、资源效率等效能数据进行展示，形成量化、实施、分析、改进的闭环，Performance 可实时同步 Project 中的业务数据并支持自定义报表，字典中的公式与口径边界可以直接对应到报表的数据集选择与图表说明中。无论使用哪种工具，判断标准一致：任何人拿到字典中的一条记录，都能独立复现出与看板一致的数值。
常见问题
指标字典刚建立时，目标值应该怎么定？
目标值在基线尚未稳定时可以先留空，先积累两到三个统计周期的实际数据作为参考值，再据此设定目标。参考值写当前实际水平，目标值写期望达到的水平，两者分列填写，避免把现状当成目标。目标值确定后，建议在变更记录中注明设定依据，后续调整时便于回溯。
同一个指标在不同团队的口径不一致，字典里怎么处理？
优先统一口径，把差异写进统计口径与边界字段，例如起止时点、纳入对象和排除项。如果业务差异确实无法合并，可以登记为两条记录，用指标编号区分，并在名称或备注中标注适用范围，例如“需求交付周期（含紧急插单）”。两条记录共享同一业务问题时，应在字典中互相引用，避免看板并列展示时被误读为同一指标。
指标字典和看板上的指标说明是什么关系？
字典是口径的唯一来源，看板说明应引用字典中的指标编号和版本，不再另写一套定义。口径变更时按“先更新字典、再更新看板说明、最后切换取数逻辑”的顺序执行，切换当天在看板标注版本变化。出现数值跳变时，先核对字典版本是否切换，再排查数据采集问题。
指标数量很少的小团队也需要完整的评审和版本管理吗？
可以简化评审环节，例如由指标负责人一人确认即可，但变更记录建议保留。版本号在指标开始被多个团队引用、或口径发生过实质变更时启用更合适；在此之前，用更新日期加变更记录也能满足追溯需要。随着指标数量和引用方增加，再逐步补齐评审流程和版本规则。
废弃的指标编号可以重新分配吗？
不建议重新分配。废弃指标保留编号并标注停用日期，旧报表和历史数据引用时仍能找到对应记录。连续两个周期无人查看、或业务问题已不存在的指标，标记为“待废弃”并公示一个周期，确认无引用后停用。新增指标顺延取号，编号与名称解耦，名称变更不影响编号。
