用途：techdebt 用于自动检测技术债，设计为在会话结束时运行，趁上下文新鲜时发现问题。
主要能力：通过并行子代理同时执行四类扫描——重复代码（AST 相似度）、安全问题（硬编码密钥、SQL 注入、XSS、不安全加密等）、复杂度热点（圈复杂度、嵌套深度、函数长度、参数数量）、死代码（未用导入、不可达代码、孤立函数）。结果按 P0-P3 严重度排序，按文件分组，并计算债务评分。
使用方式：默认扫描自上次提交以来的变更，命令为 /techdebt；深度扫描整个代码库用 /techdebt --deep；按类别扫描用 --duplicates、--security、--complexity、--deadcode；交互式自动修复用 /techdebt --fix。支持 JSON、Markdown、SARIF 输出格式，以及基线保存与对比（--save-baseline、--compare-baseline）。可集成到会话收尾清单、pre-commit 钩子和 CI/CD 工作流中。
适用场景：会话结束收尾、重构前评估、准备重大发布、PR 检查、持续跟踪债务趋势。
限制：自动修复仅限安全项（如删除无用导入），安全问题与复杂度问题绝不自动修复，需人工确认；Tier 1 语言（Python、JavaScript/TypeScript、Go、Rust）支持完整，其他语言仅基于模式检测；扫描可能超时或产生误报，可通过配置阈值和忽略模式调整；部分专用工具需额外安装。