用途:对代码仓库做系统性技术债审计,产出可引用、可落地的审计文档。适用于 oh-my-openagent(OMO)环境,需使用其内置工具(grep、glob、bash、read、lsp_diagnostics、task)。
主要能力:分阶段执行。阶段 0 通过 glob 映射语言栈、读取依赖配置、用 git log 分析改动热点、找出大文件,定位高改动加大体积的债务热点。阶段 1 按九个维度审计:架构腐化、一致性腐化、类型与契约债、测试债、依赖与配置债、性能与资源卫生、错误处理与可观测性、安全卫生、文档漂移。每个结论须标注 file:line:col。
输出:在仓库根目录写 TECH_DEBT_AUDIT.md,含执行摘要(3-5 句)、架构心智模型一段、发现表格(ID、类别、文件行号、严重度、工时、描述、建议)、Top 5 优先级(按影响/工时排序)、30 分钟内可完成的速赢清单、“看似糟糕实则合理”的模式、待维护者澄清的开放问题。
用法要点:阶段 1 各维度并行调用工具;大于 5 万行的仓库可用 task 并行派生子代理处理最重维度;阶段 3 去重、按严重度(Critical/High/Medium/Low)分级、估算工时并汇总。示例命令包括 bash("sg -p ...")、grep("TODO|FIXME|HACK|XXX|WORKAROUND|TEMP")、bash("npm audit --omit=dev 2>&1 | head -40") 等,需按资料原样使用。
限制:官方文档未提供安装方式、价格、平台支持范围;模型无关,但工具依赖 OMO 内置能力,勿替换。审计结果需人工判断,避免为凑数编造问题。