衡量技术债累积速度，核心是看单位时间窗内新增债务与已偿还债务的净变化，单看存量规模无法反映趋势。季度复盘时，可以把新增债务工时、债务偿还率、净债务增速和债务密度放在同一口径下计算，再结合债务关联的缺陷、变更失败和交付延期判断紧迫性。ONES 可用于登记债务条目、关联需求与缺陷，并沉淀季度复盘记录。
要点总览（TL;DR）
- 衡量技术债累积速度看单位时间窗内的净变化：净债务增速=（期末存量−期初存量）÷期初存量，配合新增债务工时、偿还率与债务密度共同刻画。
- 偿还率=已关闭债务工时÷期初债务工时，反映本期偿还力度相对期初存量的比例；债务密度=债务工时÷代码规模或交付需求数，反映债务相对交付规模是否变重。
- 存量用债务台账未关闭工时或条目数表示，业务影响用债务关联的缺陷、变更失败、交付延期等事件统计，三者组合才能判断治理紧迫性。
- 季度复盘需先固定统计范围与台账字段，处理分母为零、估算工时缺失与存量口径变化，跨季度对比时保持字段定义不变。
- 紧迫性判断采用组合规则：增速为正且偿还率偏低需增加治理投入；增速为正且影响事件集中在少数模块优先治理；增速为负但存量高则保持常规偿还节奏。
评估目标：季度复盘要回答的三个问题
季度技术债复盘需要回答三个问题：累积多快、存量多大、影响多深。三者分别对应趋势、规模和后果，缺一项都难以支撑治理决策。累积速度回答“照当前节奏，债务会不会失控”；存量规模回答“当前需要投入多少偿还工作”；业务影响回答“哪些债务已经在拖累交付质量”。
单看存量不足以判断紧迫性。两个团队同样有 400 小时未关闭债务，一个季度新增 40 小时、关闭 120 小时，另一个季度新增 300 小时、关闭 20 小时，前者在收敛，后者在加速累积。存量相同，治理优先级完全不同。
评估结论主要用于三类决策：排出下一季度优先治理的债务条目；确定治理投入占研发工时的比例；与上季度、去年同期对比，跟踪趋势是否改善。复盘输出应包含指标数值、口径说明和优先级结论，便于下季度复算核对。
指标与范围：衡量累积速度用哪几个指标
累积速度由一组指标共同刻画，单个指标只能反映一个侧面。新增债务工时说明“流入有多快”，偿还率说明“流出是否跟得上”，净债务增速说明“存量在往哪个方向走”，债务密度说明“债务相对交付规模是否变重”。
| 指标 | 公式 | 单位 | 时间窗 |
|---|---|---|---|
| 新增债务条目数 | 统计期内新登记且未关闭的债务条目计数 | 条 | 季度 |
| 新增债务工时 | 统计期内新登记债务的估算工时之和 | 人时 | 季度 |
| 债务偿还率 | 已关闭债务工时 ÷ 期初债务工时 | 百分比 | 季度 |
| 净债务增速 | （期末存量 − 期初存量）÷ 期初存量 | 百分比 | 季度 |
| 债务密度 | 债务工时 ÷ 代码规模（千行）或交付需求数 | 人时/千行、人时/需求 | 季度末快照 |
统计范围需要事先写清。债务类型可包括架构耦合、缺少测试、重复代码、过期依赖、文档缺失等；纳入项应限定为已登记、有估算工时、可归属到模块或需求的条目。临时排查记录、已确认功能缺陷不计入债务台账，后者按缺陷流程处理。时间窗统一按自然季度，期初取上季度最后一个工作日，期末取本季度最后一个工作日，避免跨季度口径漂移。
数据口径：债务台账字段与取数规则
指标可复算的前提是台账字段完整、取数来源固定。债务台账至少需要以下字段：
| 字段 | 用途 | 填写规则 |
|---|---|---|
| 登记日期 | 判断是否属于本期新增 | 首次登记当天，补录需注明原始发现日期 |
| 关闭日期 | 判断是否属于本期偿还 | 债务条目验收关闭当天 |
| 估算工时 | 计算新增、关闭与存量工时 | 由认领人评估，超过约定阈值需复核 |
| 关联需求/模块 | 计算债务密度、定位治理范围 | 至少填一个模块，能关联需求时一并填写 |
| 影响事件 | 统计业务影响 | 记录关联缺陷、变更失败、交付延期等事件编号 |
| 状态 | 区分未关闭与已关闭 | 状态变更需留时间戳 |
取数来源分三类：需求管理系统提供需求交付量与需求关联关系；代码库提供代码规模与变更记录；缺陷记录提供影响事件。三处数据通过需求编号或模块名称与债务条目对齐。
缺失值处理规则要提前约定：估算工时缺失的条目不计入工时类指标，但在条目数指标中保留并单独标注；关闭日期缺失视为未关闭；分母为零时该指标记为“不适用”，不用零或无穷大替代。跨季度对比时字段定义保持不变，若本期新增字段，需在口径说明中注明并从下季度起纳入计算。
计算步骤：从台账到累积速度指标
按以下四步计算，每一步都保留中间结果，便于复核。
步骤一：按季度汇总新增与关闭债务工时。筛选登记日期落在本季度内的条目，求估算工时之和，得到新增债务工时；筛选关闭日期落在本季度内的条目，求估算工时之和，得到已关闭债务工时。期初存量为上季度末未关闭条目的工时之和，期末存量为本季度末未关闭条目的工时之和。
步骤二：计算净债务增速。公式为（期末存量 − 期初存量）÷ 期初存量。结果为正表示债务在累积，为负表示净偿还。期初存量为零时，该指标不适用，改用新增债务工时绝对值描述。
步骤三：计算偿还率。公式为已关闭债务工时 ÷ 期初债务工时。偿还率反映本期偿还力度相对期初存量的比例，超过 100% 说明偿还量大于期初存量，通常伴随新增债务同时发生。
步骤四：计算债务密度。公式为债务工时 ÷ 代码规模（千行）或 ÷ 本期交付需求数。代码规模取季度末快照，交付需求数取本季度完成的需求计数。分母为零时记为不适用。若季度内发生大规模代码迁移或模块拆分，需在口径说明中标注，并考虑同时给出按需求数计算的口径作为对照。
存量口径变化时，例如债务类型范围调整或估算标准变化，应在期初存量上做同口径重述，并在复盘中同时披露调整前后数值，避免增速被口径变化放大或掩盖。
例子：一个季度的技术债复盘计算
以下为演示情景，数据为假设值，不代表任何真实项目。
| 项目 | 数值 |
|---|---|
| 期初存量（上季度末未关闭工时） | 800 人时 |
| 本季度新增债务工时 | 260 人时 |
| 本季度关闭债务工时 | 180 人时 |
| 期末存量 | 880 人时 |
| 本季度交付需求数 | 40 个 |
| 关联影响事件数 | 12 起（缺陷 8、变更失败 2、交付延期 2） |
按公式计算：净债务增速 =（880 − 800）÷ 800 = 10%；偿还率 = 180 ÷ 800 = 22.5%；债务密度 = 880 ÷ 40 = 22 人时/需求。新增 260 人时、关闭 180 人时，净增 80 人时，与增速 10% 一致。
解读时看组合：增速为正且偿还率偏低，说明流入大于流出，债务在累积；债务密度 22 人时/需求意味着每交付一个需求背后背着约 22 人时未偿债务。再按模块拆分影响事件，若某模块集中了多数缺陷和变更失败，即使其工时占比不高，也应优先治理。示例的局限在于工时估算由人工给出，且影响事件只统计了已记录部分，实际复盘应结合条目明细核对。
解读与限制：指标怎么读、哪里会失真
增速快但偿还率也高，说明团队在大量偿还的同时仍在大量新增，常见于快速扩张或架构调整期。此时应重点看新增债务的来源是否集中，若集中在少数模块，治理动作应前移到需求评审和设计阶段，而非只加大偿还投入。
常见失真来源有三类。工时估算偏差：不同人评估同一债务可能相差数倍，需统一估算基准并抽样复核。登记不全：只登记了显性债务，隐性债务未入账，导致增速被低估。影响事件漏记：缺陷与变更失败未关联到债务条目，业务影响被低估。
债务密度跨团队不可比。代码规模口径、需求粒度、技术栈复杂度不同，直接比较数值意义有限，更适合在同一团队内做季度间对比，或按模块做相对排序。
紧迫性判断建议采用组合规则：净债务增速为正且偿还率低于约定阈值，列为需要增加治理投入；增速为正且业务影响事件集中在少数模块，列为优先治理对象；增速为负但存量仍高，保持常规偿还节奏并跟踪影响事件。指标用于排序和跟踪，不能单独作为绩效结论，也不能替代对具体债务条目的技术判断。
用ONES承载债务台账与季度复盘
季度复盘要落地，债务条目需要有统一的登记入口和可追溯的状态。可以把每条技术债作为工作项登记，填写估算工时、所属模块和关联需求，债务关闭时更新状态并记录关闭时间，形成可筛选的台账基础。
业务影响统计依赖关联关系。债务工作项关联对应的缺陷、变更记录和延期需求，复盘时按模块汇总关联事件数量，与工时数据放在一起看，判断哪些债务的影响更集中。
按季度汇总时，用登记日期和关闭日期筛选本期新增与关闭的债务工作项，汇总估算工时，得到新增、关闭和期末存量，再按前述公式计算增速、偿还率和密度。复盘结论和下一季度治理任务可以在同一工作项体系中流转：复盘记录归档，治理任务分配负责人和计划完成时间，状态变更留痕，下季度复盘时直接对照上期任务完成情况。
常见问题
季度内新增债务工时很大，但净债务增速接近零，这种情况怎么解读？
这通常说明本期偿还量也很大，流入与流出基本抵消。此时单看增速会低估团队的债务活动强度，应同时看新增债务工时和偿还率的绝对值，并分析新增债务的来源是否集中。若新增集中在少数模块，治理动作应前移到需求评审和设计阶段，而不是只维持现有偿还投入。
债务条目没有估算工时，还能计入累积速度指标吗？
可以计入条目数指标，但不计入工时类指标。建议在台账中单独标注这类条目，并在口径说明中写明处理规则，避免它们被静默排除。若缺失比例较高，工时类指标的增速和偿还率都会失真，应先补估再计算，或在复盘中披露缺失条目的数量与占比。
期初存量为零时，净债务增速和偿还率怎么处理？
期初存量为零时，这两个指标的分母为零，应记为“不适用”，不用零或无穷大替代。此时改用新增债务工时的绝对值描述累积情况，并在下季度期初存量恢复非零后再计算增速和偿还率。跨季度对比时需注明该季度指标不适用，避免趋势线出现断点被误读。
不同团队之间的债务密度可以直接比较吗？
直接比较意义有限。代码规模口径、需求粒度、技术栈复杂度不同，债务密度数值的可比性会下降。更适合在同一团队内做季度间对比，或按模块做相对排序，找出债务相对交付规模变重的模块。若确需跨团队对照，应统一代码规模与需求计数口径，并在复盘中说明差异。
季度中途调整了债务类型范围，增速还能和上季度比吗？
需要先做同口径重述。按新范围重新计算上季度期初存量，再计算本期增速，并在复盘中同时披露调整前后数值。若无法重述，应标注口径变化，把本期增速作为新口径下的首个基准值，从下季度起再比较趋势，避免口径变化被误读为债务加速或收敛。
