用途：tech-debt-audit 是一个 Claude Code 技能，对当前代码库做一次有主见、不敷衍的技术债与架构审计，最终在仓库根目录生成 TECH_DEBT_AUDIT.md，每条具体发现都带 file:line 引用。
主要能力：审计分三阶段。第一阶段先读 README、包清单与架构文档，梳理目录与模块，运行 git log 查看变更与热点，列出最大文件与近半年最常改动文件，并先写出架构心智模型。第二阶段按九个维度找具体问题：架构腐化（循环依赖、分层违规、超大文件与函数、重复逻辑、死代码）、一致性腐化、类型与契约债、测试债、依赖与配置债、性能与资源卫生、错误处理与可观测性、安全卫生、文档漂移。第三阶段输出报告，含执行摘要、架构模型、发现表格（ID/类别/文件行号/严重程度/工作量/描述/建议）、Top 5 优先项、快速收益清单、"看似有问题其实没问题"一节，以及给维护者的开放问题。
使用方式：安装可执行 mkdir -p ~/.claude/skills/tech-debt-audit 与 curl -o ~/.claude/skills/tech-debt-audit/SKILL.md https://raw.githubusercontent.com/ksimback/tech-debt-skill/main/SKILL.md，或复制到项目内 .claude/skills/tech-debt-audit/SKILL.md。在 Claude Code 中于目标仓库运行 /tech-debt-audit 即可，首次约 5–20 分钟。若报告已存在，会进入重复运行模式，标记 RESOLVED、更新过期项并标注 NEW。
适用场景与限制：适合中大型代码库的定期技术债盘点。它是静态审计，不是安全审计，不能替代渗透测试或威胁模型；无法发现业务逻辑缺陷；难以区分有意与无意的简化，因此设有开放问题一节。超过 20 万行代码时结果可能偏浅，可限定模块范围。工具未安装时会在报告中注明而不阻塞，且不会未经许可全局安装开发工具。许可证为 MIT。