bloat-detector
扫描代码库,检测死代码、重复、复杂度和文档冗余问题
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bloat-detector。 它的用途是:扫描代码库,检测死代码、重复、复杂度和文档冗余问题 完整的 Skill 内容见:https://321skill.com/skills/bloat-detector-x-7/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用 bloat-detector 分析当前项目的 src 目录,找出所有复杂度超过10的函数和重复的代码块。’,它会运行扫描工具,生成一份包含问题函数位置、重复代码片段及建议的详细报告。
介绍
bloat-detector 是一个用于识别代码库中“臃肿”问题的工具。它主要解决代码库随着项目迭代而积累的无效代码、重复逻辑、过高复杂度以及冗余文档等问题,这些问题会降低代码可维护性、增加理解成本并浪费存储空间。
该工具通过静态分析的方式,扫描指定目录下的源代码,自动识别出未被引用的死代码、结构或逻辑重复的代码片段、圈复杂度过高的函数以及文档中重复或无用的内容,并生成详细的报告,帮助开发者定位问题区域。
它非常适合需要定期进行代码健康度检查的开发者,特别是那些维护大型或长期演进项目的团队。无论是前端、后端还是全栈开发者,都可以利用它来保持代码库的整洁和高效。
使用建议是将其集成到持续集成(CI)流程中,作为代码质量门禁的一部分,在每次提交或合并请求时自动运行。需要注意的是,工具的报告结果需要人工复核,特别是对于死代码的判定,需确认其是否真的未被使用,避免误删。
核心特点
与单一功能的代码分析工具(如仅检测重复代码)不同,bloat-detector 集成了死代码、重复代码、复杂度和文档冗余四大维度的扫描,提供一站式的代码库“健康体检”报告。其文档冗余扫描功能在同类工具中较为少见,能有效识别文档中的重复和过时内容。
注意事项
该工具主要依赖静态分析,对于通过动态加载、反射或复杂构建流程引用的代码,可能存在误报死代码的风险。
常见问题
bloat-detector 能扫描哪些编程语言?
根据其仓库描述,它主要面向通用代码库扫描,具体支持的语言需查看其详细文档或配置文件。
如何将扫描结果集成到 CI/CD 流程?
可以将其安装为 CI 流水线中的一个步骤,执行扫描命令并根据报告结果(如设置复杂度阈值)决定是否通过检查。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bloat-detector-x-7/raw/index.md 读取 bloat-detector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bloat-detector-x-7/raw/index.md(查看排版版本)