techdebt

name	techdebt
description	Scan and report technical debt in the codebase. Use after completing a feature or at session end.
user-invocable	false
triggers	["/techdebt","技術債","tech debt","find duplicates","找重複"]
version	1.0.0
scope	public

Tech Debt Scanner

Scan the current project for technical debt, including duplicate code, outdated dependencies, TODO/FIXME markers, etc.

Execution

Step 1: Scan for duplicate code

Use Grep to search for similar code patterns. Adapt file extensions to the project language:

# JS/TS projects
grep -rn "function\|const.*=.*=>" --include="*.ts" --include="*.tsx" --include="*.js" | sort | uniq -d

# Python projects
grep -rn "def " --include="*.py" | sort | uniq -d

# Go projects
grep -rn "^func " --include="*.go" | sort | uniq -d

# Rust projects
grep -rn "^fn " --include="*.rs" | sort | uniq -d

# Or use jscpd for JS/TS (if installed)
npx jscpd --min-lines 5 --min-tokens 50 src/

Step 2: Scan for TODO/FIXME

grep -rn "TODO\|FIXME\|HACK\|XXX" --include="*.ts" --include="*.tsx" --include="*.js" --include="*.py"

Step 3: Check for outdated dependencies

# Node.js projects
pnpm outdated 2>/dev/null || npm outdated 2>/dev/null

# Python projects
pip list --outdated 2>/dev/null

Step 4: Check for large files

Files over ~300 lines are candidates for splitting. Adapt extensions to the project language:

# JS/TS projects
find . \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" \) -not -path "*/node_modules/*" | xargs wc -l | sort -rn | head -20

# Python projects
find . -name "*.py" -not -path "*/.venv/*" | xargs wc -l | sort -rn | head -20

# Go/Rust projects
find . \( -name "*.go" -o -name "*.rs" \) | xargs wc -l | sort -rn | head -20

# Universal (all source files, excludes vendor/node_modules)
find . -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.py" -o -name "*.go" -o -name "*.rs" \) \
  -not -path "*/node_modules/*" -not -path "*/.venv/*" -not -path "*/vendor/*" \
  | xargs wc -l | sort -rn | head -20

Output Format

Output a technical debt report in the following format:

## Tech Debt Report - [Date]

### Duplicate Code (Priority: High)
| File A | File B | Similarity | Recommendation |
|--------|--------|------------|----------------|

### TODO/FIXME (Priority: Medium)
| File | Line | Content | Age |
|------|------|---------|-----|

### Outdated Dependencies (Priority: Low)
| Package | Current Version | Latest Version |
|---------|-----------------|----------------|

### Large Files (May need splitting)
| File | Lines | Recommendation |
|------|-------|----------------|

Integration

• Can be run automatically at session end
• Reports saved to .techdebt/report-YYYY-MM-DD.md
• Can be used with CI to track technical debt trends