用途：在代码库中跟踪、分类和排序技术债，扫描债务指标并维护一份债务登记表。
主要能力：提供 scan、add、prioritize、report 四个子命令。scan 在代码根目录（按引擎解析 src/、Assets/ 或 Source/）搜索 TODO、FIXME、HACK、@deprecated 标记、重复代码块、超过 500 行的文件和超过 50 行的函数，并按架构、代码质量、测试、文档、依赖、性能六类归类。add 手动新增条目，收集描述、受影响文件、类别、修复工作量和影响。prioritize 按影响÷工作量打分（Impact Low 1/Med 2/High 3/Critical 4，Effort S 1/M 2/L 3/XL 4，保留一位小数），高分优先，同分按 Added 日期较早者优先，并推荐下个迭代要处理的项目。report 生成统计：按类别统计 Open 条目与总工作量、当前迭代新增与解决数、趋势方向，并标记超过 3 个迭代未处理的条目。
使用方式：以 /tech-debt 加子命令调用；未提供子命令时输出用法并停止。写入登记表前会先征求用户同意，scan 与 add 会先匹配已有 Open 条目以避免重复，scan 还会把文件中已不存在的模式提议标记为 Resolved。登记表位于 docs/tech-debt-register.md，包含 ID、Category、Description、Files、Effort、Impact、Priority、Status、Added、Sprint 十列。
适用场景：游戏工作室或一般代码库的迭代式债务管理，配合 /sprint-plan 安排高优先级债务，配合 /story-done 记录偏差。
限制：scan 在代码根目录无法解析时报告 NOT ASSESSED 并停止；代码根目录无源文件时同样报告 NOT ASSESSED，不写入登记表；用户拒绝写入时状态为 BLOCKED。report 为只读模式，不写文件。Impact 或 Effort 为“—”的条目不参与打分。自动化提问行为遵循 .claude/docs/automation-modes.md。