1---2name: skill-773description: Skill4---5# 债务识别分级Skill67## 适用场景8技术债务治理环节,按统一识别口径系统性扫描项目债务,对每条债务依据分级标准判定高/中/低,产出可登记入台账的分级清单。910## 执行步骤111. 按识别口径逐类扫描(见下表),产出候选债务清单。122. 每条债务附证据位置与识别依据。133. 对照风险分级标准逐条判定级别,写明判定理由。144. 登记入债务台账(字段见「技术债务量化Skill」)。1516## 识别口径17| 类型 | 识别信号 |18|---|---|19| 代码坏味 | 重复代码、超长函数、超 3 层嵌套、巨型类、无用代码/死代码 |20| 架构缺陷 | 循环依赖、违反分层、模块边界不清、接口契约混乱 |21| 测试缺口 | 覆盖率低于质量门槛、关键路径无测试、测试不可维护 |22| 安全与合规 | 已知漏洞未修复、敏感信息硬编码、依赖组件 EOL、不合规使用 |23| 文档与知识 | 复杂模块无文档、单一维护人代码、注释与实现不一致 |24| 过时技术 | 弃用 API、EOL 框架、旧版本依赖、停维护的中间件 |2526## 风险分级标准27| 级别 | 判定标准 |28|---|---|29| 高 | 已造成线上故障/资损,或安全漏洞可利用,或阻塞当前迭代交付 |30| 中 | 显著拖慢开发速度(变更成本高),预计 1-2 个迭代内可能触发故障 |31| 低 | 仅影响可维护性/美观性,暂无触发故障迹象 |3233## 规范要点34- 每条债务必须附证据:文件/模块位置 + 具体问题描述 + 识别依据(对应哪个口径)。35- 分级必须对照标准写明判定理由(如「级别:高,理由=该漏洞 CVE-XXXX 存在公开利用脚本」),禁止凭印象定级。36- 同一问题多处出现时,按模块聚合登记,避免碎片化条目。37- 与全局规范一致:超 3 层嵌套、硬编码密钥、无保护强转等直接记为债务。3839## 输出模板40```41## 技术债务识别与分级报告42| ID | 位置 | 描述 | 类型 | 识别依据 | 风险级别 | 判定理由 |43## 统计(各级别数量与占比)44## 高危清单(需立即处理)45```4647## 自检清单48- [ ] 每条债务有位置证据与识别依据49- [ ] 级别判定对照标准写明了理由50- [ ] 六类口径均已覆盖扫描51- [ ] 高危项单独列出