Tech Debt Analyzer 是一个面向代码库的技术债务盘点与修复规划技能，由 wyattowalsh/agents 提供，用于系统性地发现、分类、排序并规划技术债务的修复。它的范围明确限定为债务清点与追踪，不用于代码评审、重构执行或依赖更新。
用途 该技能用于对一个项目或指定路径进行系统性技术债务分析，生成包含类别、严重级别、置信度与证据的债务条目清单，并支持按风险×工作量矩阵排序、生成分阶段修复路线图、渲染可视化仪表盘以及与历史基线对比追踪变化。它强调基于证据的发现和置信度评分，避免将风格偏好误报为债务。
主要能力 技能包含多个模式：scan 用于全代码库债务盘点（或限定路径）；analyze 用于对特定文件或目录进行深度分析；prioritize 用于按风险×工作量矩阵对所有债务条目排序；roadmap 用于生成分阶段的修复计划；report 用于渲染仪表盘可视化；track 用于与上一次基线对比。扫描过程包括四个分析脚本：复杂度扫描、死代码检测、依赖陈旧度检查、模式一致性检查，随后进行 AI 增强分析，覆盖文档缺口、测试覆盖缺口、基础设施债务和设计坏味。分析结果会聚合、去重、分类，并计算债务分数（严重级别权重 × 置信度的总和），基线会存储在本地状态目录中，用于纵向追踪。
使用方式 用户通过模式与参数调用该技能，例如输入 scan 或 scan <path> 进行全库或限定路径扫描，输入 analyze <file/dir> 进行定向深度分析，输入 prioritize、roadmap、report、track 进入对应模式，输入为空时显示模式菜单。扫描时会调用 scripts/complexity-scanner.py、scripts/dead-code-detector.py、scripts/dependency-staleness-checker.py、scripts/pattern-consistency-checker.py 等脚本，并要求先运行所有四个分析脚本再呈现结果。每个债务条目需包含位置、类别、严重级别、置信度、描述、影响与修复建议。置信度低于 0.3 的条目应丢弃，0.3 到 0.7 标记为不确定，大于等于 0.7 才报告；死代码检测要求高置信度（>= 0.8）。状态目录为 ~/.{gemini|copilot|codex|claude}/tech-debt/，文件名为 <project-slug>-<YYYY-MM-DD>.json，模式为 { "project": str, "date": str, "score": float, "items": [...], "summary": {...} }。报告模式会读取模板 templates/dashboard.html 并注入 findings JSON。参考文件包括 references/debt-taxonomy.md、references/complexity-metrics.md、references/prioritization-framework.md、references/remediation-templates.md，要求一次只加载一个参考文件。
适用场景 适用于需要定期盘点技术债务、追踪债务趋势、对债务条目进行优先级排序、制定修复路线图或生成可视化报告的工程团队。它适合多轮分析、证据驱动的债务识别，以及将债务按设计、测试、文档、依赖、基础设施分类并评估修复风险与工作量。
限制 该技能仅做债务清点与规划，不执行修复、代码评审或依赖更新。优先排序模式需要先有扫描基线，否则会提示用户先运行扫描。追踪模式必须展示新增、已解决与变更的差异，不能只给出原始数字。不能将风格偏好报告为债务，只能报告结构性、行为性或可维护性问题。跨脚本输出需要去重，避免同一 file:line 重复出现。参考文件需一次加载一个，不应全部预加载。部分事实（如收费、价格、具体平台支持或效果数据）暂未提供。