bloat-detector
检测代码库中的死代码、重复、复杂度和文档冗余问题
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bloat-detector。 它的用途是:检测代码库中的死代码、重复、复杂度和文档冗余问题 完整的 Skill 内容见:https://321skill.com/skills/bloat-detector-x-5/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用 bloat-detector 分析当前项目的 src 目录,找出所有死代码和重复代码块。” 它会调用该工具扫描指定路径,并生成一份结构化报告,列出疑似无用的函数、类以及重复率超过阈值的代码片段,帮助你定位可清理的冗余部分。
介绍
bloat-detector 是一款专门用于识别和量化代码库“臃肿”问题的工具。它通过静态分析,帮助开发者发现那些占用空间、增加维护成本却无实际价值的代码和文档。
该工具通过扫描代码库,自动检测出未被引用的死代码、重复的逻辑片段、过高的圈复杂度以及冗余或过时的文档内容。用户只需提供代码库路径,即可获得一份详细的“臃肿”报告。
它非常适合需要进行代码质量审计、技术债务清理或准备重构的开发者、团队负责人或技术经理。在项目迭代后期或接手遗留系统时,使用此工具能快速定位问题区域。
建议将此工具集成到 CI/CD 流程中,作为代码质量门禁的一部分,定期运行以监控技术债务的增长。注意,其检测结果(尤其是死代码)需要人工复核,以避免误删可能通过反射等动态机制调用的代码。
核心特点
与单一功能的代码质量工具(如仅检查重复或复杂度)不同,bloat-detector 专注于“代码臃肿”这一综合性问题,将死代码、重复、复杂度和文档问题统一分析,提供关于代码库“脂肪含量”的整体视图。
注意事项
不适合用于动态语言(如部分 JavaScript 代码)或重度使用反射/元编程的代码库的死代码检测,可能产生误报。
常见问题
bloat-detector 能检测哪些语言的代码?
目前主要支持常见的静态类型语言(如 Java, C#, Go 等),对 Python、JavaScript 等动态语言的支持可能有限,需结合具体工具链。
检测出的死代码可以直接删除吗?
不建议直接删除。报告中的死代码需要人工复核,确认其确实未被任何动态调用、反射或序列化机制使用后再进行清理。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bloat-detector-x-5/raw/index.md 读取 bloat-detector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bloat-detector-x-5/raw/index.md(查看排版版本)