bloat-detector
扫描代码库,检测死代码、重复、复杂度和文档冗余问题。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bloat-detector。 它的用途是:扫描代码库,检测死代码、重复、复杂度和文档冗余问题。 完整的 Skill 内容见:https://321skill.com/skills/bloat-detector-x-8/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用 bloat-detector 分析当前项目的 src 目录,找出所有死代码和重复超过3次的代码片段。”,它会运行扫描工具,生成一份包含问题文件、位置和类型的详细报告,并可能给出初步的清理建议。
介绍
bloat-detector 是一个用于识别代码库“臃肿”问题的工具。它主要解决代码库因长期迭代积累的死代码、重复逻辑、过高复杂度以及冗余文档导致的可维护性下降、构建缓慢和认知负担加重等问题。
该工具通过静态分析,扫描项目中的源代码和文档,识别出未使用的函数或变量(死代码)、重复的代码片段、圈复杂度过高的函数以及文档中过时或无用的部分,并以报告形式输出,帮助开发者定位“代码脂肪”。
它非常适合需要定期进行代码健康度检查的开发者,特别是那些接手遗留项目、进行大规模重构或希望提升团队代码质量的前端、后端及全栈工程师。项目经理和运维开发人员也可用它来评估技术债务。
使用建议是将其集成到CI/CD流程中,作为代码提交或定期构建的检查环节。需要注意的是,其检测结果(尤其是死代码)可能存在误报,需要人工复核,且它主要关注静态结构,不分析运行时行为。
核心特点
该技能专注于“代码臃肿”这一综合维度,不仅检查死代码,还同时覆盖重复代码、复杂度和文档膨胀,提供一站式的代码库健康度扫描,而非单一维度的检测。
注意事项
不适合用于分析动态语言(如部分JavaScript特性)的运行时依赖或评估代码的业务逻辑正确性。
常见问题
bloat-detector 能检测哪些语言的代码?
主要支持常见静态语言如Java、C#、Go等,对JavaScript/TypeScript等动态语言的支持可能有限,需查看具体实现。
检测出的“死代码”可以直接删除吗?
建议先人工复核,因为工具可能无法识别反射调用、依赖注入等动态使用场景,直接删除有风险。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bloat-detector-x-8/raw/index.md 读取 bloat-detector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bloat-detector-x-8/raw/index.md(查看排版版本)