技术债务与已知错误
把已知错误和技术债务当作同一份可见的、被推迟修复的账本,度量每一项在保持打开的每个月里让你付出什么,并把一部分受保护的容量花在利息最高的项目上。
概述与动因
每个团队都会推迟一些修复。某个缺陷已被理解却没有修复,为了赶日期走了捷径,某个组件被任其老化,某个变通办法被写进了运行手册。每一次推迟,在作出时都是明智的决定。麻烦始于推迟在不为人见的地方累积,因为承担它们的代价,之后会表现为事件、缓慢的交付和疲惫的人,而任何报告上都没有一行把代价与原因联系起来。
有两套词汇描述同一种模式。在 ITIL 中,已知错误是根本原因已被理解、并且存在变通办法、或存在尚未应用的永久修复的问题。已知错误被记录下来,使服务台和运维人员能迅速解决重复的事件,而记录一直保持打开,直到修复被发布。在敏捷的软件工作中,技术债务是一个隐喻,由沃德·坎宁安于 1992 年提出,指那些使未来的变更更困难的设计和实现选择。这个隐喻带有对度量很重要的两个思想:本金,即消除这笔债务所需的工作量;以及利息,即债务存在期间每个周期所付出的额外工作量或风险。
两种视角在看哪里上有所不同。已知错误通过运维被发现:事件或问题调查找到了原因。技术债务通常通过交付被发现:开发人员注意到某个变更比它应有的难度更大。已知错误往往是已经开始伤害客户的技术债务。技术债务往往是一个等待发生的已知错误。把清单分开保存,一份在 ITSM 工具里,一份在待办或维基里,就隐藏了这种联系,并为同一份稀缺的容量产生两种相互竞争的论证。
本主题为这份合并的账本提供一小组度量。它回避为整个组织的债务给出单一的金额数字,因为没有哪种方法能可靠地产生它,而是度量你能观察到的东西:打开的项目、等待的时间、造成的事件、增加的工作,以及花在修复上的容量。然后,这份账本为产品与运维之间的优先级交谈提供输入(见主题 4.1,问题管理指标,了解问题记录和永久修复,以及主题 2.9,运维工作与计划外工作,了解债务造成的打断负荷)。
本主题使用的术语:
- 变通办法是在不消除原因的情况下恢复服务或避免失败的办法。
- 永久修复消除原因。根本原因分析是找到它的工作。
- 代码重构在不改变外部行为的情况下重组代码。它是偿还设计债务的通常办法。
- 代码异味是代码中常常暗示更深层问题的表面迹象。它是去看一看的提示,不是裁决。
- 机会成本是你因选择把时间用于某一用途而放弃的最佳替代方案的价值。每次修复都与一项功能竞争,而这种比较才是真正的决定。
- 延迟成本是推迟一项工作所造成的经济损失。它是为债务项目的利息定价背后的思想。
- 软件缺陷是软件中的缺陷。已知错误可能是缺陷、配置弱点、设计限制或供应商缺陷。
- 静态程序分析不运行代码而检查代码。它的警告和复杂度分数是可能存在债务的指示,证据弱于事件历史。
并非所有债务都是错误。马丁·福勒的象限把有意与无意、鲁莽与审慎的债务区分开来(见参考文献清单)。带有偿还计划的审慎捷径是一笔合理的贷款,而鲁莽的债务是该预防的那种。这里的指标不评判起源。它们显示余额。
关键原则
- 一份账本,两扇门。来自运维的已知错误和来自交付的债务项,进入同一份可见的清单,并在描述同一原因的记录之间建立链接。
- 度量利息,也度量本金。修复的规模没有一个打开的项目每月让你付出什么重要,包括事件、变通办法和被拖慢的变更。按每单位修复工作量的利息排序。
- 让推迟成为有负责人的决定。每个项目都有负责人、说明的等待理由和评审日期。没有人选择推迟的项目是忽视,并按忽视来统计。
- 在需要之前保护容量。事先约定的、每个团队用于修复工作的规定容量份额,胜过糟糕季度之后的英雄式清理。
- 让变通办法保持诚实。变通办法是一项服务,有它自己的成本、负责人和失败模式。度量它被使用的频率和失败的频率。
- 描述系统,绝不描述人。债务属于服务或组件。绝不把它归于某位作者,也绝不按工程师接触的债务给他们排名。
- 粗略估计。"小时"、"天"和"周"的规模就够了。超出这个的精确度是编造出来的。
指标定义
下面的指标描述被推迟修复的账本。时钟和边界在每个公式中说明。时间度量报告为分布(中位数和第 85 或第 95 百分位数),而不是单一的平均值。
| 指标 | 定义 | 公式 | 单位 | 数据来源 | ITIL 实践 | 敏捷对应 | 频率 |
|---|---|---|---|---|---|---|---|
| 已知错误待办年龄 | 打开的已知错误等待永久修复多久 | 时钟在问题记录被标记为"已知错误"时启动;在永久修复被发布到生产环境时停止;以"接受风险"关闭的项目单独报告并排除。按服务报告计数、年龄中位数和第 85 百分位数年龄 | 天(分布) | ITSM 工具的问题和已知错误记录、发布记录 | 问题管理 | 老化工作项图表;缺陷待办的年龄 | 每月 |
| 变通办法覆盖率 | 有文档化、经测试、坐席可遵循的变通办法的打开已知错误占比 | 变通办法在过去 6 个月内被评审过的打开已知错误数 / 打开的已知错误数;已关闭和接受风险的项目被排除 | 百分比 | 与已知错误记录关联的知识库 | 问题管理;知识管理 | 运行手册或可运维性的完成定义 | 每月 |
| 与打开的已知错误关联的事件 | 其原因是打开的已知错误的事件,是对服务中断所付利息的直接度量 | 该期间与事件开始时仍打开的某个已知错误关联的事件数 / 该期间的全部事件数;没有原因链接的事件报告为未关联,不计入 | 百分比,加计数 | ITSM 工具的事件到问题的链接 | 事件管理;问题管理 | 逃逸缺陷;生产缺陷的流入 | 每月 |
| 债务存量 | 仍然打开的已登记技术债务项的数量和估计规模 | 期末债务登记册中打开的项目数;规模是登记时分配的粗略工作量档位(小时、天、周)之和;未登记的或疑似的债务被排除 | 计数,以及工作量档位 | 跟踪器中的债务登记册,按服务标记 | 持续改进;服务设计 | 标记为债务的产品待办项 | 每月 |
| 债务利息 | 由打开的债务和已知错误造成的额外工作,以团队时间计 | 该期间记录在带有债务或已知错误引用的工作项上的小时数(变通办法、手工步骤、返工,以及在受影响变更上的额外工作)/ 该期间团队的总工作小时数;修复工作本身被排除,并计入容量占比 | 工作时间的百分比 | 工作项上的时间或工作量标签,保持在团队层面 | 持续改进;问题管理 | 计划外工作和返工占比 | 每月 |
| 债务容量占比 | 用于偿还债务和已知错误的交付容量占比 | 标记为债务修复或已知错误修复的已完成工作项的容量(项目数或工作量)/ 该期间全部已完成工作项;没有标签的项目被排除 | 百分比 | 跟踪器,按标签统计已完成项目 | 持续改进;变更赋能 | 容量分配 | 每个计划期,每月评审 |
| 债务净变化 | 账本是在增长还是在缩小 | 该期间登记的债务和已知错误项 减去 该期间解决的项目;解决是指修复已发布,而不是已合并;以"不修复"关闭的项目单列一行统计 | 计数(有符号) | 债务登记册和已知错误记录 | 持续改进 | 按类别的待办变化 | 每月 |
接受风险是关闭已知错误的一种正当方式,因为有些问题不值得修复。它被单独列出,使关闭项目不会悄悄地改善年龄数字。变通办法覆盖率中的 6 个月评审窗口只是一个示例。团队按其系统变化的快慢来设定窗口,并写入指标登记册。
建议
构建账本
1. 把已知错误清单和债务清单合并成一份账本。保留一份登记册,带有起源(运维或交付)、服务、负责人、规模档位和指向相关记录的链接的字段。ITSM 工具可以存放它,跟踪器也可以,只要每个系统都链接到另一个。没有统一的视图,运维中的已知错误,就会与交付中看不见的债务项争夺同一批工程师。
2. 在债务被创建或发现的那一刻登记它。有意采取的捷径,在同一个拉取请求或变更记录中进入登记册,附说明的理由和评审日期。之后发现的债务,由发现者登记。一条廉价的、一行字的捕获规则,胜过定期审计,因为人们会忘记上个季度所知道的事。
度量利息
3. 每次都把事件链接到已知错误。事件与其已知错误之间的链接,是你手里关于利息最强的数据,而它在解决时只花几秒钟。在原因已知时,让链接成为必填字段,并报告未关联的占比,使缺口不会看起来像好消息(见主题 3.3,事件响应与解决时间)。当同一个原因出现在若干起事件中时,问题记录承载着修复的证据。
4. 给债务产生的工作打标签。让工程师在因某个已知弱点而需要变通办法、手工步骤或额外返工时标记一个工作项,并将其链接到账本项。标签成本很低,并在团队层面给出债务利息的数字。把结果视为误差很宽的估计,对于给项目排序和观察趋势有用,不用于核算。
5. 用两个数字为每个项目定价:修复工作量和每月利息。对工作量使用粗略的档位,比如小时、天、周;对每月成本,使用从关联事件、被标记的工作,以及你的组织已有的任何停机成本估计中得出的粗略数字。把利息除以工作量,得到一个简单的回收时间。不要编造精确度:一个档位加上一项说明的假设,就足以把显而易见的收益与可以等待的项目区分开。
保护容量并作出决定
6. 预留一份固定的容量份额,并报告它。与产品负责人约定每个周期用于修复工作的份额,由账本的趋势决定,并每季度重新审视。把债务容量占比报告在计划内工作的数字旁边,使领导层把修复工作看作一项有意的投资。预留的份额也使团队免于在每次计划交谈中都进行取舍的争论,而功能待办通常会赢得这种争论。
7. 用一种共同的货币把修复与功能排序。把已知错误和债务项,与功能一起放进同一场优先级交谈,以延迟成本和回收时间来表达。一个消除每周一起事件、并在一个季度内收回其工作量的修复,凭自身的价值竞争。按嗓门大小、资历或登记日期排序,结果很差(见主题 4.4,变更失败与返工)。
8. 对推迟的决定闭合回路。对每个有意保持打开的项目,记录谁接受了风险、评审日期,以及会把它提上来的触发条件,比如第二起事件或该区域有计划的变更。按它自己的节奏评审接受风险清单。被推迟了三次、又没有触发条件的项目,就是一个忽视它的决定,账本应当如实说明。
保持数字诚实
9. 先发布修复,再关闭记录。已知错误保持打开,直到永久修复进入生产环境,并在规定的窗口内检查过复发。在"已合并"或"工单完成"时关闭,会美化年龄和净变化的数字,并在之后重新打开事件(见主题 4.5,发布与部署指标)。跟踪已知错误的重开率,作为对关闭规则的质量检查。
10. 除了总数之外,也看账本的形状。持平的计数可能隐藏一条很长的陈旧项目的长尾、某项服务中占比不断增长的项目,或靠把一切都以"不修复"关闭而保持很小的账本。在一页上显示年龄分布、按服务的拆分和接受风险清单。在计划下个季度工作的同一场会议上,与拥有这些服务的人一起评审它。
操纵途径与护栏
| 指标 | 被操纵的方式 | 配套的护栏指标或实践 |
|---|---|---|
| 已知错误待办年龄 | 把旧记录以"接受风险"或"不修复"关闭;把一条旧记录拆成新的年轻记录;通过重新登记来重置时钟 | 在同一页报告接受风险的计数和年龄;由所属团队之外的人评审关闭;保留记录谱系 |
| 变通办法覆盖率 | 写一个含糊的变通办法来满足字段;统计没有任何坐席试过的变通办法 | 关联事件中变通办法的使用和失败率;定期测试一份变通办法样本 |
| 与打开的已知错误关联的事件 | 让事件不关联,或把它们关联到另一个原因,使占比下降 | 旁边报告未关联事件占比;对已关闭事件作遗漏链接的抽样评审 |
| 债务存量 | 不登记债务,使存量看起来很小;把许多项目合并成一个大项目;登记琐事以显得勤勉 | 对照代码评审和事件复盘的样本评审登记册;项目规模和具体性检查 |
| 债务利息 | 少打标签以避开审视,或多打标签以争取修复预算;把这个数字读作对团队的评级 | 对已标记和未标记项目的样本审计;仅团队层面的视图,团队之间不作比较;把利息与事件链接放在一起阅读 |
| 债务容量占比 | 把普通的功能工作标记为修复;挑选容易的表面项目来填满份额 | 成果检查:最老的高利息项目的年龄和事件链接在下降;对照排序评审修复了什么 |
| 债务净变化 | 解决许多微小的项目来抵消少数几个大的;把项目以"不修复"关闭使计数下降 | 按规模档位和按利息显示净变化;报告"不修复"一行;对已解决项目的复发检查 |
健康的读数显示一份可见的、具体的、朝团队所选方向移动的账本。最老的高利息项目的数量在下降。与打开的已知错误关联的事件呈下降趋势,未关联的占比很小。债务容量占比稳定在约定的水平,而不是在危机之后飙升、之后消失。接受风险清单很短,并被评审。当任何单一数字看上去极好,而其他数字不动时,在庆祝之前先怀疑定义。
权衡:利弊
| 做法 | 优势 | 劣势 |
|---|---|---|
| 把已知错误和债务合并成一份账本 | 统一的优先级排定;运维和交付看到相同的成本 | 需要共享的工具或链接;必须理清两个职能之间的所有权 |
| 用于修复的固定容量份额 | 可预测;保护修复工作免于功能压力 | 如果排序薄弱,可能被花在低价值的项目上 |
| 只在修复赢得优先级辩论时才安排修复工作 | 灵活;响应当前的优先级 | 功能几乎总是获胜;账本一直增长,直到发生危机 |
| 从事件和被标记的工作估计利息 | 把债务与可观察的成本相联;支持排序 | 数字粗略;依赖诚实的标注和事件链接 |
| 专门的修复冲刺或"债务周" | 专注,进展可见 | 是间歇性的;账本在两次活动之间重新填满;打断计划内的承诺 |
选择能让最老的高利息项目保持移动的最轻量的安排。小团队可以在一块看板上,用一个标签和月度评审来运行账本。大型组织需要工具之间的链接和约定的排序方法。目标是对每个项目作出有意的决定,而不是一份空的清单。
与团队讨论的问题
1. 哪三个打开的项目每个月让我们付出最多?我们怎么知道? 请人们凭记忆说出候选,然后对照事件链接和被标记的工作进行检查。把记忆中的清单与度量出来的清单比较,并注意其中的差距。约定从现在起如何收集排序的证据。
2. 当我们推迟一项修复时,谁来决定?我们何时再看? 走一遍最近的五次推迟,问谁接受了风险,设定了什么评审日期。无人决定之处,这个项目是被忽视了,而不是被推迟了。约定一条规则:每次推迟都带有负责人、理由和触发条件。讨论接受风险清单将如何被评审、由谁评审。
3. 我们应当为修复预留多少容量?什么会改变这个份额? 展示账本的趋势和当前的债务容量占比。问团队愿意放弃什么来提高它,又有什么证据会让它下降。记录数字、理由和重新审视的日期。
4. 我们的变通办法是真实的吗?新来的坐席能照着做吗? 随机挑一个变通办法,请一位没有写它的人照着做。为涵盖影响最大的错误的变通办法约定一套测试流程。
5. 什么算已修复?在关闭记录之前,我们观察多久? 比较运维、交付和产品负责人使用的关闭规则。讨论适合该服务的复发窗口,以及已关闭的项目重新打开时团队将怎么做。约定一个定义,并写进指标登记册。
6. 我们的债务数字可能在哪里给我们讲了一个舒适的故事? 请求每个数字可能被美化的方式:未登记的债务、先修复容易的项目、以不修复关闭的项目。查看未关联事件占比和接受风险清单。选一个本季度要增加的护栏,并指出由谁来检查。
四种视角
产品与交付团队
交付团队最先看到债务,通常是在修改代码的时候。他们受益于一份易于添加的登记册,以及一份受保护的容量份额,使修复工作不必依赖在每次计划交谈中赢得争论。他们应当在采取捷径时登记它们,给由弱点造成的工作打标签,并避免把债务当作他们不愿做的任何工作的标签(见主题 2.2,前置时间、周期时间与流动效率,了解债务对前置时间的影响)。
服务与运维团队
运维团队看到的是利息:重复的事件、手工步骤、脆弱的变通办法,以及随之而来的值班负荷。他们拥有已知错误记录和变通办法文档,并掌握为利息定价的事件数据。他们应当把每起事件链接到其已知错误,测试变通办法,并把排好序的证据带到计划交谈中,而不是一份抱怨清单(见主题 5.7,琐务与值班指标)。
领导层与治理
领导层决定修复工作得到多少容量,而他们设定的激励决定账本是否保持诚实。他们应当要年龄分布、利息数字和接受风险清单,而不是单一的债务分数。把账本读作对团队的评级,会惩罚登记,并把债务逼入地下。治理论坛应当把风险接受视为有负责人和评审日期的决定。
客户与用户
客户把债务感受为重复的失败和他们必须遵循的变通办法。在变通办法影响用户之处,连同一份关于何时预计修复的平实说明一起发布,并守住这个日期,或解释变化。更少的重复事件和关于已知问题的诚实状态,比"没有缺陷"的承诺建立更多信任(见主题 6.1,客户满意度指标)。
实践:一个敏捷 ITIL 示例
一家地区医院的 IT 部门运行着一个患者预约服务,由一个产品团队和一个运维小组支持。本示例中的所有数字都是示意数字。
运维小组在 ITSM 工具中保存着 23 个已知错误。产品团队在它的看板上另有一份 41 个债务项的清单。一次季度评审发现,其中 9 个已知错误和 7 个债务项描述的是同样的五个原因。最老的已知错误已有 14 个月,已知错误年龄中位数为 5 个月,第 85 百分位数为 11 个月。变通办法覆盖率为 61%。与打开的已知错误关联的事件占该季度事件的 18%,另有 22% 的事件未关联,所以真实占比可能更高。
团队把两份清单合并成一份有 55 个不同项目的账本。对关联事件最多的十个项目,它用档位估计修复工作量,用小时估计每月利息。有一项很突出:一个夜间的预约同步作业,大约每两周静默失败一次,需要值班人员手工重启。它的修复估计需要两周。它的利息,来自关联事件和被标记的工作,约为每月 10 小时,而且每次失败都会延迟早晨的门诊名单。回收时间约为四个月,比当时计划中的任何功能都快。
记录在决策日志中的决定是:为产品团队预留 15% 的容量用于修复工作,按每单位工作量的利息排序,并首先修复同步作业。运维负责人还同意,凡存在已知错误之处,把每起事件都链接到它,并测试最常用的五个变通办法。
两个季度后,已知错误年龄中位数为 4 个月,第 85 百分位数为 9 个月。与打开的已知错误关联的事件降到 11%。未关联的占比降到 8%,这使团队对这个数字更有信心。然后团队抓住了一个操纵风险。债务净变化一行显示,该季度解决了 12 个项目,但其中 6 个是以不修复关闭的,其中两个是最老的高利息项目。团队之外的一位评审者阅读了记录,发现这些关闭是为了改善年龄数字。这些项目被重新打开,关闭理由成为带有指名批准人的必填字段,接受风险的项目现在与年龄分布出现在同一页。
行业视角
初创企业。债务通常是有意的,而且往往是对的,因为抵达第一个客户的速度最重要。在看板上用一个标签保留一份清单,在采取捷径时登记它们,并设定评审日期,使"以后"有一个含义。当利息开始显现在事件中时,提高修复的份额。
小型企业。单个管理员或小团队往往同时承担运维和交付,所以两份清单自然是一份。把已知错误及其变通办法记录在共享文档中,并注明每个项目依赖哪个供应商或合同。供应商拥有的缺陷是你自己无法修复的已知错误,所以要跟踪供应商承诺的日期和你的变通办法。
大型企业。许多团队、许多服务和许多供应商,产生了若干相互竞争的清单和若干"完成"的定义。确定一个账本结构、一条关闭规则和一种排序方法,并让团队附带说明映射的本地字段。
政府与公共部门。遗留系统、漫长的采购周期和固定的预算,使一些债务偿还起来代价高昂,也使一些更换决定缓慢。记录阻碍修复的法律、保留和审计约束,因为它们解释了推迟。把账本作为风险报告的一部分展示,并在预算周期内计划修复,而不是把它当作计划外的成本(见主题 8.5,受监管与政府报告)。
商业论证:动机、投资回报与总拥有成本
动机是停止支付你看不到的利息。重复的事件、手工的变通办法,以及缓慢而有风险的变更,是看得见的成本,它们通常被记录为不同预算中的不同问题。合并的账本把它们变成修复成本与承担债务成本之间的一次比较。
这项实践的成本有三个部分。第一是设置:一份登记册、ITSM 工具与跟踪器之间的链接,以及一个标注约定。第二是运行工作量:每起事件几秒钟用于链接,每个工作项几秒钟用于标注,以及每项服务每月一两个小时的评审。第三是修复容量本身,这是最大的一项,是一项有意的投资,不是开销。
回报来自你自己能度量的模式。比较一个已知错误修复前后与之关联的事件、受影响变更上被标记工作的小时数,以及避免的值班打断。如果你的组织已经估算了停机成本,就加上它。不要借用行业数字来估计债务的成本:关于这个主题的研究文献是真实的,但数字取决于背景,你自己的事件和时间数据是更好的证据。《加速》的研究把交付表现与组织表现联系起来(见主题 2.8,DORA 指标),尽管它没有给你的账本定价。关于成本和回报更广的论述,见主题 7.7(投资回报与商业论证)。
反模式与陷阱
- 永不相遇的两份清单。运维和交付以不同的证据争夺同一份容量。合并清单,或链接每个共享的原因。
- 为整个组织给出单一的债务分数。它隐藏了成本所在,并招致给团队排名。按服务报告账本,附年龄、利息和所有权。
- 把大重写作为唯一的修复。大型清理会停滞,而账本在它们进行期间重新填满。按回收时间排序,小步地让项目退役。
- 把零债务当作目标。追求它会奖励琐碎的关闭,并阻碍诚实的登记。争取让账本中最老的高利息项目在移动。
- 在"已合并"时关闭已知错误。修复尚未到达用户,事件又会回来。在发布时关闭,然后在规定的窗口内观察复发。
- 把推迟藏在"不修复"里。年龄数字改善了,风险却还在。把接受风险单独统计,附负责人和评审日期。
- 把静态分析当作真相。分数反映的是代码的形状,不是成本。用它找出候选,然后用事件链接和变更历史确认。
- 把债务归于作者。它教会人们隐藏捷径、回避困难的组件。把每项度量保持在服务和团队层面(见主题 1.2,古德哈特定律与指标心理学)。
成熟度模型
| 维度 | 1 起步 | 2 发展 | 3 标准化 | 4 管理 | 5 协同 |
|---|---|---|---|---|---|
| 账本与定义 | 已知错误和债务存在于人们的脑子里或零散的笔记中 | 运维和交付各自保留一份清单,规则不同 | 一份账本,有书面定义、负责人,以及每个项目的关闭规则 | 对照书面定义评审年龄、接受风险和净变化 | 当定义不再为决定提供依据时,与供应商和客户一起修订 |
| 度量利息 | 事件与原因之间没有链接 | 部分事件被手工链接到已知错误 | 在原因已知之处要求事件链接;工作在团队层面被标记 | 为头几个项目估计利息和回收时间并形成趋势 | 利息与服务成果相联,并在团队和供应商之间共享 |
| 容量与优先级 | 修复发生在危机中 | 部分团队非正式地留出时间 | 约定的容量份额和共同的排序方法 | 份额依据账本趋势调整,并作为计划内工作获得资助 | 在共享平台和供应商之间协调修复容量 |
| 变通办法与关闭 | 变通办法没有文档,或掌握在一个人手里 | 为部分错误编写了文档,未经测试 | 变通办法在知识库中,并有发布时关闭的规则 | 度量变通办法的使用、失败和关闭之后的复发 | 变通办法随修复发布而自动退役,并有来自用户的反馈 |
检查清单
- 已知错误和债务项位于一份账本中,或逐项相互链接。
- 每个项目都有负责人、规模档位、服务和评审日期。
- 有意的捷径在采取时就被登记,并附理由。
- 在原因已知之处,事件被链接到已知错误,并报告未关联的占比。
- 由弱点造成的工作在团队层面被标记,并通过样本审计标注情况。
- 头几个项目各有修复工作量档位和每月利息估计。
- 约定、报告并每季度评审用于修复工作的容量份额。
- 已知错误在修复发布时关闭,并有说明的复发窗口。
- 以接受风险关闭的项目单独列出,附批准人和评审日期。
- 影响最大的错误的变通办法,按计划测试。
- 与总数一起显示年龄分布和按服务的拆分。
- 没有任何债务指标被用来比较或排名个人。
AI 提示词
把两份清单合并成一份账本。
我有两份被推迟修复的清单。清单 A 来自[运维工具或来源],有[数量]个已知错误。清单 B
来自[交付跟踪器或来源],有[数量]个技术债务项。这是各条目:[粘贴含标题、服务、登记
日期和一行描述的条目]。请把看起来描述同一原因的条目分组,为每组提出一个单一的账本
条目,并标出需要人来确认匹配的条目。不要编造原因、服务或日期。列出你的假设,以及在
合并之前我应当回答的问题。
为头几个项目估计工作量档位和每月利息。
对[服务]上的账本项[项目标题],我有这些证据:关联事件[含日期和持续时间的清单]、
被标记的工作[小时数或项目数],以及团队给出的修复估计[估计]。请帮我写出粗略的工作量
和每月利息档位、一个简单的回收时间,以及每个数字的置信水平。展示你的算术。不要编造
成本、基准值或行业数字。如果缺少某个数字,请向我索取。列出你的假设。
评审关闭与操纵风险。
这是我们已知错误和债务账本的定义以及上个季度的数据:[年龄、变通办法覆盖率、债务
净变化以及关闭规则的定义]和[已关闭项目的摘要,附关闭理由]。请指出这些度量可能被
美化的方式、数据中表明这种情况已经发生的证据,以及每种的护栏。把这当作对度量工具
的评审,而不是对人的评审。不要指控任何人,也不要编造数据。列出你的假设。
为与产品负责人的优先级交谈做准备。
我需要提议[团队]下个季度如何在功能与修复工作之间分配容量。账本显示[账本摘要:计数、
年龄分布、带工作量和利息档位的头几个项目]。功能计划包含[产品负责人提供的计划功能及
其预期价值的摘要]。请起草一页纸的提案,比较修复份额的各种选项,说明主要修复项目的
延迟成本,并指出各种取舍。不要编造价值估计或基准份额。列出你的假设,以及产品负责人
必须作出的决定。
AI 技能
- 敏捷 ITIL 指标技能:用于查找定义相关指标(比如复发或变更失败)的主题,以及属于它旁边的护栏。
- 敏捷 ITIL 指标维护者技能:用于检查被编辑的指标是否写明了它的时钟、操纵途径和护栏。
关键要点
- 已知错误和技术债务,是同一份被推迟修复的账本的两种视图,所以把它们放在一起或相互链接。
- 度量每个项目每月让你付出的利息,以事件、变通办法和被拖慢的变更计,并按回收时间给修复排序。
- 让每次推迟都成为有负责人、理由和评审日期的决定,并把接受风险单独报告。
- 为修复工作预留约定的容量份额,并报告在计划内工作旁边。
- 在修复发布时关闭已知错误,然后在信任结果之前观察复发。
- 把每项度量保持在服务和团队层面,并使用护栏,使更好的数字意味着更好的系统。
参考文献与延伸阅读
- Cunningham, W., "The WyCash Portfolio Management System," OOPSLA '92 Experience Report, ACM, 1992.
- Fowler, M., "Technical Debt Quadrant," 2009, https://martinfowler.com/bliki/TechnicalDebtQuadrant.html
- Fowler, M., Refactoring: Improving the Design of Existing Code, 2nd edition, Addison-Wesley, 2018.
- Kruchten, P., Nord, R., and Ozkaya, I., Managing Technical Debt: Reducing Friction in Software Development, Addison-Wesley, 2019.
- Sculley, D., and others, "Hidden Technical Debt in Machine Learning Systems," Advances in Neural Information Processing Systems 28, 2015, https://papers.nips.cc/paper_files/paper/2015/hash/86df7dcfd896fcaf2674f757a2463eba-Abstract.html
- Reinertsen, D. G., The Principles of Product Development Flow: Second Generation Lean Product Development, Celeritas Publishing, 2009.
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Beyer, B., Jones, C., Petoff, J., and Murphy, N. R. (eds.), Site Reliability Engineering: How Google Runs Production Systems, O'Reilly Media, 2016, https://sre.google/sre-book/table-of-contents/
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, ITIL.
- Wikipedia, Technical debt.
- Wikipedia, Ward Cunningham.
- Wikipedia, Root cause analysis.
- Wikipedia, Code refactoring.
- Wikipedia, Code smell.
- Wikipedia, Opportunity cost.
- Wikipedia, Cost of delay.
- Wikipedia, Software bug.
- Wikipedia, Static program analysis.