bloat-detector
检测代码库膨胀，提升代码质量
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：bloat-detector。 它的用途是：检测代码库膨胀，提升代码质量 完整的 Skill 内容见：https://321skill.com/skills/bloat-detector-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'扫描当前项目中所有未使用的函数和变量'，它会遍历项目文件，识别出死代码并列出文件名、函数名和行号。
对AI说：'检测src目录下的代码重复度'，它会分析该目录中所有文件，输出重复片段的位置和相似度百分比，并给出合并建议。
介绍
代码库随着项目演进往往会积累大量冗余，导致维护成本激增。本 Skill 专注于从四个维度检测代码库膨胀：死代码（未被调用的函数、变量、类等）、重复代码（相同或高度相似的代码片段）、复杂度过高的函数（如圈复杂度超标）以及文档膨胀（过时、冗余或缺失的注释与文档）。通过扫描，它能快速定位需要清理或重构的区域，帮助团队保持代码库的整洁和可维护性。
使用方式非常简单：在支持该 Skill 的 AI 编码助手（如 Claude、Cursor）中，直接对 AI 说出“检测当前项目的代码膨胀情况”或指定具体模块，工具会自动分析项目文件结构，扫描目标代码，并以结构化报告形式输出每个维度的膨胀点，包括文件路径、行号、严重程度和建议措施。你还可以对特定目录或文件进行针对性扫描，或设置阈值过滤低优先级问题。
本 Skill 适合所有需要维护代码质量的开发者，尤其是全栈开发者和后端开发者。对于正在重构遗留系统、进行代码审查、或希望建立持续代码质量流水线的团队尤为实用。它也适用于 AI 生成代码的审查，因为 AI 生成的代码有时会包含不必要的重复或死代码。
使用时建议先对项目整体做一次基线扫描，然后定期（如每次合并前）进行增量扫描。注意，本工具专注于膨胀问题，不涉及安全漏洞、性能优化或编码规范（如命名风格）的检查，因此需要与其他静态分析工具配合使用以达到更全面的代码质量覆盖。
核心特点
同类工具多聚焦单一维度（如死代码或重复代码），而本 Skill 同时覆盖死代码、重复、复杂度和文档膨胀四个维度，提供一站式代码膨胀检测，且无需额外配置即可集成到 AI 编码助手工作流中。
注意事项
不适合检测安全漏洞、性能瓶颈、编码规范（如缩进、命名）或逻辑错误等非膨胀类问题。
常见问题
这个工具能检测哪些语言的代码膨胀？
默认支持主流语言如 JavaScript/TypeScript、Python、Java、Go、C/C++ 等，具体支持列表可查看项目文档。
扫描结果如何查看？
会以结构化报告呈现，包含每个膨胀点的文件路径、行号、严重程度（高/中/低）以及建议的清理或重构方案。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/bloat-detector-x/raw/index.md 读取 bloat-detector 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/bloat-detector-x/raw/index.md（查看排版版本）