bloat-detector
轻量检测代码库中死代码、重复、复杂度与文档膨胀
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:bloat-detector。 它的用途是:轻量检测代码库中死代码、重复、复杂度与文档膨胀 完整的 Skill 内容见:https://321skill.com/skills/bloat-detector/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请用 bloat-detector 扫描当前项目目录,找出所有死代码、重复代码片段、复杂度超过15的函数以及文档中的冗余内容,并生成一份简明的优化建议报告。' 它会自动运行扫描,输出每个文件的详细指标,并高亮需要优先处理的膨胀点。
介绍
代码库随着迭代会逐渐积累死代码、重复逻辑、过度复杂的函数以及冗余的文档内容,这些“膨胀”因素不仅拖慢开发效率,还增加维护成本。bloat-detector 通过静态扫描快速识别这些藏匿在项目中的体积与质量隐患,帮助团队在早期发现并清理无用代码、简化重复逻辑、定位复杂度热点,同时标记文档中的冗余或过时部分,让代码库保持健康与可维护性。
使用非常简单,只需在终端中运行一条命令,指定项目目录即可。bloat-detector 会自动分析代码结构,生成清晰的报告,按文件或模块列出死代码、重复片段、复杂度评分以及文档膨胀建议。部分结果还支持导出为 JSON 或 HTML 格式,便于集成到 CI/CD 流水线或团队评审流程中。
主要面向前端开发、后端开发、全栈开发以及测试工程师,尤其适合中大型项目或长期维护的代码库。无论是定期清理技术债务,还是接手遗留项目时快速评估代码质量,这个工具都能提供直观的量化指标。团队主管也可以用它来建立代码质量的基线数据,持续追踪改进趋势。
建议将 bloat-detector 纳入持续集成流程,在每次合并请求前自动扫描并给出改进建议,避免膨胀问题持续累积。对于超大型项目,可以按模块分批扫描,降低单次运行时间。注意它主要关注代码结构和文档体积,不涉及安全漏洞或运行时性能分析,需要配合其他工具一起使用。
核心特点
相比 SonarQube 等重型工具,bloat-detector 专注于代码膨胀这一细分维度,且额外支持文档膨胀扫描,安装轻量、即装即用,无需复杂的配置和数据库。
注意事项
不适用于需要深度安全审计、运行时性能分析或跨语言统一分析的场景。
常见问题
bloat-detector 支持哪些编程语言?
默认支持 JavaScript、TypeScript、Python、Java 等常见语言,具体可查看文档中的语言支持列表。
如何忽略某些文件或目录?
在项目根目录创建 .bloatignore 文件,按照 gitignore 语法添加排除规则即可。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/bloat-detector/raw/index.md 读取 bloat-detector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/bloat-detector/raw/index.md(查看排版版本)