mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-28 09:23:08 +08:00

Files

catlog22 f60dd44d5b feat: add team-tech-debt skill for tech debt identification and cleanup

6-role team (coordinator, scanner, assessor, planner, executor, validator)
with 3 pipeline modes (scan, remediate, targeted) and fix-verify loop.
Scanner performs 5-dimension analysis (code, architecture, testing,
dependency, documentation) via CLI fan-out. Follows team-skill-designer
patterns with self-contained role.md and command.md files.

2026-02-23 22:46:27 +08:00

5.2 KiB

Raw Blame History

Command: evaluate

CLI 分析评估债务项。对每项债务评估业务影响(1-5)、修复成本(1-5)、未修复风险，产出优先级象限分配。

When to Use

Phase 3 of Assessor
需要对债务清单中的项目进行量化评估
债务项数量较多需要 CLI 辅助分析

Trigger conditions:

TDEVAL-* 任务进入 Phase 3
债务清单包含 >10 项需要评估的条目
需要上下文理解来评估影响和成本

Strategy

Delegation Mode

Mode: CLI Batch Analysis CLI Tool: gemini (primary) CLI Mode: analysis

Decision Logic

// 评估策略选择
if (debtInventory.length <= 10) {
  // 少量项目：内联评估（基于严重性和工作量启发式）
  mode = 'heuristic'
} else if (debtInventory.length <= 50) {
  // 中等规模：单次 CLI 批量评估
  mode = 'cli-batch'
} else {
  // 大规模：分批 CLI 评估
  mode = 'cli-chunked'
  chunkSize = 25
}

Execution Steps

Step 1: Context Preparation

// 准备评估上下文
const debtSummary = debtInventory.map(item =>
  `[${item.id}] [${item.dimension}] [${item.severity}] ${item.file}:${item.line} - ${item.description}`
).join('\n')

// 读取项目元信息用于上下文
const projectContext = []
try {
  const pkg = JSON.parse(Read('package.json'))
  projectContext.push(`Project: ${pkg.name}, Dependencies: ${Object.keys(pkg.dependencies || {}).length}`)
} catch {}

Step 2: Execute Strategy

if (mode === 'heuristic') {
  // 内联启发式评估
  for (const item of debtInventory) {
    const severityImpact = { critical: 5, high: 4, medium: 3, low: 1 }
    const effortCost = { small: 1, medium: 3, large: 5 }
    item.impact_score = severityImpact[item.severity] || 3
    item.cost_score = effortCost[item.estimated_effort] || 3
    item.risk_if_unfixed = getRiskDescription(item)
    item.priority_quadrant = assignQuadrant(item.impact_score, item.cost_score)
  }
} else {
  // CLI 批量评估
  const prompt = `PURPOSE: Evaluate technical debt items for business impact and fix cost to create a priority matrix
TASK: • For each debt item, assess business impact (1-5 scale: 1=negligible, 5=critical) • Assess fix complexity/cost (1-5 scale: 1=trivial, 5=major refactor) • Describe risk if unfixed • Assign priority quadrant: quick-win (high impact + low cost), strategic (high impact + high cost), backlog (low impact + low cost), defer (low impact + high cost)
MODE: analysis
CONTEXT: ${projectContext.join(' | ')}
EXPECTED: JSON array with: [{id, impact_score, cost_score, risk_if_unfixed, priority_quadrant}] for each item
CONSTRAINTS: Be realistic about costs, consider dependencies between items

## Debt Items to Evaluate
${debtSummary}`

  Bash(`ccw cli -p "${prompt}" --tool gemini --mode analysis --rule analysis-analyze-code-patterns`, {
    run_in_background: true
  })

  // 等待 CLI 完成，解析结果，合并回 debtInventory
}

function assignQuadrant(impact, cost) {
  if (impact >= 4 && cost <= 2) return 'quick-win'
  if (impact >= 4 && cost >= 3) return 'strategic'
  if (impact <= 3 && cost <= 2) return 'backlog'
  return 'defer'
}

function getRiskDescription(item) {
  const risks = {
    'code': 'Increased maintenance cost and bug probability',
    'architecture': 'Growing coupling makes changes harder and riskier',
    'testing': 'Reduced confidence in changes, higher regression risk',
    'dependency': 'Security vulnerabilities and compatibility issues',
    'documentation': 'Onboarding friction and knowledge loss'
  }
  return risks[item.dimension] || 'Technical quality degradation over time'
}

Step 3: Result Processing

// 验证评估结果完整性
const evaluated = debtInventory.filter(i => i.priority_quadrant)
const unevaluated = debtInventory.filter(i => !i.priority_quadrant)

if (unevaluated.length > 0) {
  // 未评估的项目使用启发式兜底
  for (const item of unevaluated) {
    item.impact_score = item.impact_score || 3
    item.cost_score = item.cost_score || 3
    item.priority_quadrant = assignQuadrant(item.impact_score, item.cost_score)
    item.risk_if_unfixed = item.risk_if_unfixed || getRiskDescription(item)
  }
}

// 生成统计
const stats = {
  total: debtInventory.length,
  evaluated_by_cli: evaluated.length,
  evaluated_by_heuristic: unevaluated.length,
  avg_impact: (debtInventory.reduce((s, i) => s + i.impact_score, 0) / debtInventory.length).toFixed(1),
  avg_cost: (debtInventory.reduce((s, i) => s + i.cost_score, 0) / debtInventory.length).toFixed(1)
}

Output Format

## Evaluation Results

### Method: [heuristic|cli-batch|cli-chunked]
### Total Items: [count]
### Average Impact: [score]/5
### Average Cost: [score]/5

### Priority Distribution
| Quadrant | Count | % |
|----------|-------|---|
| Quick-Win | [n] | [%] |
| Strategic | [n] | [%] |
| Backlog | [n] | [%] |
| Defer | [n] | [%] |

Error Handling

Scenario	Resolution
CLI returns invalid JSON	Fall back to heuristic scoring
CLI timeout	Evaluate processed items, heuristic for rest
Debt inventory too large (>200)	Chunk into batches of 25
Missing severity/effort data	Use dimension-based defaults
All items same quadrant	Re-evaluate with adjusted thresholds

5.2 KiB Raw Blame History