SuperAPI AI 工具集

tech-debt-management

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:技术债是向未来开发速度借的贷款,需要被追踪、定价并战略性地偿还。本技能用于把评审、事故、回顾会或交付摩擦中反复出现的结构性证据,转化为按优先级排序的技术债务登记表与整改计划,避免债务静默侵蚀开发速度并放大风险。它强调债务必须基于证据,而不是把所有令人不快的小问题都塞进债务桶。

主要能力:从代码评审中标记为技术债的发现、回顾会中隐含重复结构性修复的行动项、复盘里反复出现的发布回滚或可观测性弱点、架构漂移、关键路径缺少测试或防护、因边界薄弱而重复出现的人工运维负担中识别债务;区分一次性缺陷、正常路线图功能工作和真正每周期都在产生利息的债务。使用 Fowler 技术债务象限(审慎/草率 × 有意/无意)对债务类型分类,明确审慎有意的债是合理的商业选择,草率的债更需要预防而非仅补救。对每项债务估算“利息率”,包括每冲刺浪费的开发时间、暴露的安全与可靠性风险、是否阻塞其他改进、整改成本,以及是否扩大棕地共存或发布边界风险。按每冲刺影响除以整改成本排序,优先选择能减少已知事故复发、移除不安全手工变通、加强生命周期各阶段交接的债务项。最后为团队预留固定比例的冲刺容量用于还债,健康代码库常见目标约 20%,债务积压严重时可到 30% 至 40%,并跟踪债务趋势。

使用方式:本技能是生命周期中的一环,输入为前置技能产出的评审报告、回顾报告和复盘报告,输出技术债务登记表与整改计划。为每个高优先级债务项定义负责人、目标时间窗、成功信号以及下一生命周期去向(需求接收、规划、实现或交付)。质量门槛包括债务登记表保持最新且团队可访问、高优先级项有带工作量估算的整改计划、每项都有负责人时间线和下一步去向、冲刺容量已分配、债务趋势被持续跟踪。

适用场景:适合在代码评审、事故复盘、回顾会、交付摩擦中反复出现同类结构性问题时使用,也适合架构与文档发生漂移、关键路径缺少测试防护、运维手工操作反复出现时使用。

限制与反模式:不要忽略债务直到危机爆发,那时整改成本会成倍增加;不要指望一次性的“债务冲刺”,债务持续累积,偿还也应持续;不要只跟踪不行动,让债务看板永远无人推进;不要把美化性重写当还债,聚焦可衡量影响;不要把所有烦恼都当债务,否则等于没有优先级。相关技能包括代码评审、重构、回顾会,以及规划中的迁移策略。分发方面:公开安装入口为 skills/.curated,规范源为 skills/08-evolution/tech-debt-management/SKILL.md,通过 npx skills add/update 兼容方式导出,打包稳定性与能力就绪度均为 beta。