bloat-detector
扫描代码库,检测死代码、重复、复杂度及文档冗余问题
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bloat-detector。 它的用途是:扫描代码库,检测死代码、重复、复杂度及文档冗余问题 完整的 Skill 内容见:https://321skill.com/skills/bloat-detector-x-6/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用 bloat-detector 扫描当前项目的 src 目录,分析代码冗余情况。’,它会执行扫描命令,并生成一份包含死代码位置、重复代码块、高复杂度函数以及文档冗余情况的详细报告,帮助您定位可清理的代码区域。
介绍
bloat-detector 是一款专注于识别和量化代码库“臃肿”问题的工具。它旨在帮助开发团队发现那些占用空间、增加维护成本却无实际价值的代码,例如从未被调用的死代码、重复的逻辑片段、过高的圈复杂度以及文档中不必要的冗余内容。这些问题通常难以通过人工审查发现,却会随着项目迭代不断累积,拖慢开发效率。
该工具通过静态分析技术扫描您的代码库。您只需提供项目路径,它便会自动运行多项检查,包括死代码检测、重复代码识别、复杂度分析以及文档冗余扫描。扫描完成后,它会生成一份详细的报告,清晰地列出问题所在的位置、类型和严重程度,帮助您快速定位需要优化的代码区域。
它非常适合需要长期维护和迭代的中大型项目的开发团队使用,特别是前端开发、后端开发、全栈开发以及负责代码质量和项目健康的运维工程师。对于面临代码库日益庞大、新人上手困难、重构无从下手等问题的团队来说,这是一个高效的辅助工具。
建议将此工具集成到持续集成(CI)流程中,作为代码质量门禁的一部分,定期或在每次提交前运行,以预防“代码臃肿”的积累。使用时请注意,工具的分析结果需要结合具体业务逻辑进行判断,避免误删仍在使用的代码或文档。初次运行时,建议从小范围模块开始,逐步推广至整个项目。
核心特点
与单一功能的代码检查工具(如仅检查复杂度或重复)不同,它集成了死代码、重复、复杂度和文档冗余四大维度的综合扫描,提供一站式的代码“健康度”评估。其报告能直观展示代码库的“臃肿”程度,帮助团队从维护成本角度量化技术债务。
注意事项
不适合用于动态语言或依赖运行时行为才能确定调用关系的复杂项目,可能产生误报。
常见问题
bloat-detector 能扫描哪些编程语言?
主要支持 JavaScript/TypeScript、Python、Java 等常见静态或强类型语言,具体支持范围需查看其官方文档。
如何将检测结果集成到 CI/CD 流程?
工具通常提供命令行接口和退出码,可在 CI 脚本中执行扫描命令,并根据报告严重程度决定是否阻断流水线。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bloat-detector-x-6/raw/index.md 读取 bloat-detector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bloat-detector-x-6/raw/index.md(查看排版版本)