bloat-detector

检测代码膨胀:死代码、重复、复杂度和文档冗余

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:bloat-detector。
它的用途是:检测代码膨胀:死代码、重复、复杂度和文档冗余
完整的 Skill 内容见:https://321skill.com/skills/bloat-detector-x-2/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请使用 bloat-detector 扫描当前项目,找出所有死代码和高复杂度函数,并生成一份清理建议清单。' 它会自动运行扫描命令,解析输出结果,将死代码函数名、重复代码块、圈复杂度超过20的方法以及过时的文档注释整理成表格,并按照影响程度排序,最后给出每个问题的删除或重构建议。

介绍

代码膨胀是项目维护成本攀升的隐形杀手。死代码、重复片段、过高复杂度、过时文档,会让代码库日益臃肿,拖慢迭代速度。Bloat Detector 正是针对这一痛点设计的轻量级静态分析工具,一键扫描项目,快速定位膨胀源头,为你提供清晰的清理建议。

使用非常简单:在项目根目录下运行 bloat-detector 命令,它会自动扫描代码库,输出死代码、重复代码、高复杂度函数以及文档膨胀的详细报告。你可以根据报告中的行号、文件名和严重等级,精准找到需要优化的区域,并参考说明进行重构或删除。支持增量扫描,方便持续集成。

适合全栈开发者、后端工程师、前端工程师以及技术管理者,尤其是在代码审查、重构遗留代码、优化项目健康度时能发挥巨大作用。如果你正在维护一个长期迭代的项目,或是接手了一个陌生代码库,Bloat Detector 能帮你快速摸清代码的“肥胖”状况,制定清理计划。

建议在每次重大重构前先运行一次扫描,记录基线数据;或者在 CI/CD 流程中集成该工具,设置阈值报警,防止代码质量持续恶化。注意它主要针对代码结构层面的膨胀,不会检测运行时性能问题或安全漏洞,需要配合其他工具补全。

核心特点

区别于通用的代码质量检查工具(如 SonarQube、ESLint),Bloat Detector 专注于“膨胀”维度,专门识别死代码、重复代码、高复杂度模块和文档冗余,并给出简洁的清理优先级,特别适合快速评估代码库健康度。

注意事项

不适用于运行时性能分析、安全漏洞检测或跨语言膨胀对比,且对动态语言(如 Python)的死代码检测可能存在漏报。

常见问题

Bloat Detector 支持哪些编程语言?

支持 JavaScript、TypeScript、Python、Java、Go 等主流语言,具体可查看项目 README 中的语言支持列表。

如何判断报告中的死代码是否真的可以删除?

报告会标记出疑似死代码,但建议结合代码上下文和测试覆盖确认,避免误删被动态引用或反射调用的代码。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/bloat-detector-x-2/raw/index.md 读取 bloat-detector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。