tech-debt 用于对代码库做系统化技术债分析。它在 8 个类别中排查问题，按影响和修复工作量评分，最终生成带优先级的 TECH_DEBT.md 修复计划；其中 4 个类别直接分析，4 个委托给专门技能。
先做前置检查：
git --version 2>/dev/null && git rev-parse --is-inside-work-tree 2>/dev/null
不在 git 仓库中时会给出警告但继续执行，只是无法做 git 历史分析。
流程：第一步收集项目上下文，统计文件数、当前分支与最近提交，并根据配置文件识别项目类型（Go、Node、Python、.NET、Rust 或混合）。第二步处理委托类别：代码质量（scout 技能，对近期改动文件给出按“影响 × 低风险”排序的改进机会）、Linting（lint-fix 技能仅运行检测模式）、安全（security-audit 技能做 OWASP Top 10、密钥检测、供应链评估与威胁建模）、依赖（dep-upgrade 技能仅运行审计步骤）、设计原则（design-principles 技能以委托模式审查 SOLID、DRY、YAGNI、KISS 等）。
接下来直接分析四类：架构（god 文件、耦合、分层违规、循环依赖，挑出 3-5 个最影响开发的问题）、测试（覆盖率、测试/代码比、关键未测路径、测试反模式、测试类型缺失）、文档（必备文件、API 文档覆盖、过时文档、缺失 ADR）、基础设施（CI/CD、部署、可观测性、配置与密钥管理）。
然后按评分标准为每个类别打 0-10 分，给每条发现标注影响（LOW/MEDIUM/HIGH/CRITICAL）与工作量（S/M/L/XL），计算 P1 到 P4 优先级，生成含总体健康分、记分卡、明细发现、修复路线图和成功指标的 TECH_DEBT.md，并对文件运行 markdownlint，最后展示给用户并询问先处理哪些项。
限制：具体评分细则、模板与详细分析模式在 references/ 下的 analysis-patterns.md 与 scoring-guide.md 中，资料未给出其内容；委托类别依赖对应专门技能是否可用。原文对类别数量存在 8、9、80、90 等不一致表述，此处如实保留，未做推断。