技能介绍

问题从哪来

项目越跑越久，改一个小功能要动一大片文件、回归周期变长、线上偶发故障难复现——这些往往不是「业务复杂」，而是技术债务在复利：重复逻辑、上帝类、过时依赖、测试缺口和缺失文档叠在一起，拖慢交付并抬高缺陷率。你需要的不只是「感觉哪里烂」，而是可度量的清单、影响评估和能排进迭代的修复顺序。

技能如何组织分析

该技能把债务扫描拆成六类，并要求量化而非泛泛而谈：

代码债务：重复代码（行数与位置）、高圈复杂度与深层嵌套、过长方法与上帝类
架构债务：缺失或泄漏的抽象、边界违规、单体组件与依赖滞后
测试债务：覆盖率缺口、脆弱/慢/ flaky 测试及关键路径未测
文档与基础设施：未文档化 API、缺架构图、手动部署与无回滚/监控

在此基础上会做影响评估（开发速度、质量、风险等级），并输出债务度量仪表盘与趋势思路。修复侧按 ROI 划分速赢（1–2 周）、中期（1–3 月）与长期（2–4 季度）路线，配套增量重构、团队分工与预防策略（质量关卡、债务预算）。交付物包括优先路线图、实施指南、沟通计划与成功 KPI（如缺陷率、部署频率、前置时间等目标方向）。

适用边界

适合：需要系统性技术债务分析、排期与汇报材料，或要制定可执行重构计划时
不适合：与债务无关的单点功能开发、或需要具体工具链（如 Sonar、Dependabot）自动化配置时——本技能侧重方法论与清单，不替代你仓库里的静态分析工具
分析深度依赖你提供的 $ARGUMENTS（代码上下文、约束、团队规模）；信息不足时结论会偏框架性，需补充仓库与指标后再细化