---

name: technical-debt-quantifier description: 技术债务量化器 - 用于迁移规划和修复的技术债务测量、分类与优先级排序 allowed-tools: [“Bash”, “Read”, “Write”, “Grep”, “Glob”, “Edit”]

技术债务量化器技能

测量、分类和优先排序技术债务，为迁移规划和债务修复策略提供数据驱动的决策支持。

目的

实现技术债务管理，包括：

• 债务分类与清单管理
• 修复工作量估算
• 利息计算（持续成本）
• 优先级评分
• 趋势跟踪

能力

1. 债务分类

• 代码债务（代码异味、复杂度）
• 架构债务（耦合度、内聚性）
• 测试债务（覆盖率缺口）
• 文档债务
• 基础设施债务

2. 修复工作量估算

• 估算每项修复时间
• 计算总修复成本
• 识别快速收益项
• 规划冲刺分配

3. 利息计算

• 计算持续维护成本
• 估算生产力影响
• 预测未来债务增长
• 模拟复利效应

4. 优先级评分

• 按业务影响评分
• 按风险等级加权
• 考虑修复成本
• 计算修复投资回报率

5. 债务价值比

• 对比债务与功能交付速度
• 行业基准对比
• 跟踪债务百分比
• 设定组织目标

6. 趋势跟踪

• 监控债务随时间变化
• 跟踪修复进度
• 识别债务来源
• 报告债务速度

工具集成

工具	用途	集成方式
SonarQube	债务计算	API
CodeScene	热点分析	API
Codacy	质量指标	API
Code Climate	可维护性	API
NDepend	.NET债务分析	CLI

输出模式

{
  "analysisId": "string",
  "timestamp": "ISO8601",
  "debt": {
    "total": {
      "estimatedHours": "number",
      "monetaryValue": "number",
      "items": "number"
    },
    "byCategory": {
      "code": {},
      "architecture": {},
      "test": {},
      "documentation": {}
    },
    "byPriority": {
      "critical": [],
      "high": [],
      "medium": [],
      "low": []
    }
  },
  "metrics": {
    "debtRatio": "number",
    "debtPerLoc": "number",
    "interestRate": "number"
  },
  "trends": {
    "thirtyDay": "number",
    "ninetyDay": "number"
  },
  "recommendations": []
}

与迁移流程集成

• legacy-codebase-assessment: 遗留代码库评估
• technical-debt-remediation: 技术债务修复

相关技能

• code-smell-detector: 代码异味检测
• static-code-analyzer: 静态代码分析

相关代理

• technical-debt-auditor: 技术债务审计