SuperAPI AI 工具集

tech-debt-manager

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

技术债管理是一个战略层面的技能,面向需要判断技术债取舍的开发者与团队。核心定位是把技术债视为隐喻而非道德评判:Ward Cunningham 提出该词,指的是有意发布不完美代码,像贷款一样先获益、后付息。

主要原则包括:并非所有债都是坏的,有正当理由的主动借债是战略工具;债会生息,不偿还会随时间累积成本;有些债永远不该还,能稳定运行且少改动的代码就放着;沟通至关重要,需让干系人理解取舍;必须跟踪和量化,看不见的债最危险。

该技能提出若干反直觉观点:多数所谓“技术债”其实只是用今天的眼光看旧代码,属于事后之明而非债;偿债最佳时机常常是“永不”,代码不变时还债是浪费,应当在实际需要改动该代码时再还;重构 backlog 往往是好意落空之处,把每个代码坏味都记为债会堆积永远减不掉的愧疚,应改为在改动某区域时机会性处理,或在债阻塞重要事项时战略性处理;“童子军规则”可能带来风险,只应改进当前任务真正在改的代码,不要做无关改进以免扩大范围、增加风险和评审复杂度。

技能不覆盖的内容包括:如何重构、代码质量标准、架构决策、战略决策。

使用时应以其参考文件为准:创建时查阅 references/patterns.md;诊断时查阅 references/sharp_edges.md,用于解释风险;评审时查阅 references/validations.md 以客观校验输入。若用户请求与参考指导冲突,应礼貌纠正。