technical-debt-assessment

技术债评估

目录

• 概述
• 适用场景
• 快速开始
• 参考指南
• 最佳实践

概述

系统地识别、衡量和管理技术债，以便对代码质量投入做出明智的决策。

适用场景

• 评估遗留代码
• 确定重构优先级
• 规划 Sprint
• 推进代码质量计划
• 收购尽职调查
• 架构决策

快速开始

最小可运行示例：

interface DebtItem {
  id: string;
  title: string;
  description: string;
  category: "code" | "architecture" | "test" | "documentation" | "security";
  severity: "low" | "medium" | "high" | "critical";
  effort: number; // hours
  impact: number; // 1-10 scale
  interest: number; // cost per sprint if not fixed
}

class TechnicalDebtAssessment {
  private items: DebtItem[] = [];

  addDebtItem(item: DebtItem): void {
    this.items.push(item);
  }

  calculatePriority(item: DebtItem): number {
    const severityWeight = {
      low: 1,
      medium: 2,
      high: 3,
      critical: 4,
    };
// ... (see reference guides for full implementation)

参考指南

references/ 目录中的详细实现：

指南	内容
技术债计算器	技术债计算器
代码质量扫描器	代码质量扫描器

最佳实践

✅ 应该做

• 量化技术债的影响
• 根据投资回报率确定优先级
• 持续跟踪技术债
• 将技术债纳入 Sprint
• 记录技术债相关决策
• 设置质量门槛

❌ 不应该做

• 忽视技术债
• 一次性修复所有问题
• 跳过影响分析
• 凭情绪做决定