SuperAPI AI 工具集

code-refactoring-tech-debt

编程与开发

查看项目

更新于 10-15 12:34

技能介绍

用途

该技能面向技术债务的分析与治理,帮助识别拖慢开发、增加缺陷并造成维护困难的技术债务,并聚焦于可衡量、有明确投入产出比的改进。适用于技术债务分析与修复相关的任务或工作流,以及需要相关指导、最佳实践或检查清单的场景;与技术债务分析修复无关的任务,或需要其他领域工具的场景不适用。

主要能力

技能按类型对技术债务进行盘点:

  • 代码债务:重复代码(完全复制粘贴、相似逻辑模式、重复业务规则)、复杂代码(圈复杂度大于 10、嵌套超过 3 层、方法超过 50 行、上帝类超过 500 行或超过 20 个方法)、结构不良(循环依赖、类之间不当亲密、特性依恋、霰弹式修改)。
  • 架构债务:设计缺陷(缺失抽象、泄漏抽象、违反架构边界、单体组件)。
  • 技术债务:过时框架与库、已弃用 API、遗留模式(如回调与 Promise)、不受支持的依赖。
  • 测试债务:覆盖缺口(未测试代码路径、缺失边界情况、无集成测试、缺少性能测试)、测试质量(脆弱测试、慢测试套件、不稳定测试、无测试文档)。
  • 文档债务:缺少 API 文档、复杂逻辑未记录、缺少架构图、无入门指南。
  • 基础设施债务:手动部署步骤、无回滚流程、缺少监控、无性能基线。

技能还提供影响评估(开发速度影响、质量影响、风险分级)、债务指标看板(圈复杂度、代码重复率、测试覆盖率、依赖健康度、趋势分析)、按投入产出比排序的修复计划(快速见效项、中期改进、长期举措)、实施策略(增量重构、团队分配)、预防策略(自动化质量门禁、债务预算)、沟通计划(面向管理层的报告、开发者文档)以及成功指标(月度指标、季度评审)。

使用方式

技能要求先检查当前仓库、热点以及真实的变更与事故历史,再据此开展分析。输出格式包括:按类型分类并带指标的债务清单、影响分析(成本计算与风险评估)、按季度划分的优先级路线图、本迭代的快速见效项、分步重构实施指南、防止新增债务的预防计划,以及债务削减投入的预期回报。

资料中给出的增量重构示例采用三阶段方式:先为遗留代码添加外观层,再并行实现新服务,最后通过特性开关逐步迁移。

适用场景

适用于需要全面了解开发受阻原因、缺陷增加原因和维护挑战来源的团队,用于制定可操作的技术债务修复计划,并建立防止新债务累积的流程。

限制

资料明确说明:其中的数字、阈值、人员配置和时间线均为假设性规划示例,不是测量结果、承诺回报或强制质量门槛。缺失的成本或使用数据应报告为未知,绝不能以编造的遥测数据填充。仅审查范围不授权大规模重构、策略变更或部署。技能输出不能替代针对具体环境的验证、测试或专家评审;当缺少必要输入、权限、安全边界或成功标准时,应停止并请求澄清。