CodeSmellGuard — AI 代码质量守门员

在 AI 生成代码进入仓库前自动检测架构异味和文件膨胀

痛点

同事离职后接手了一个全由 AI 写的项目，单个代码文件超过一千行，业务层和 API 层完全混在一起。技术负责人开始质疑：如果程序员完全不管设计、全盘接受 AI 产出，代码质量谁来兜底？很多团队已经走到这一步，但缺少轻量的自动化把关工具。

方案

一个 CLI 工具或 Git hook，在提交前扫描 AI 生成或修改过的文件，检测文件行数超限、职责混杂、函数过长、缺少抽象层等架构异味。输出可配置的警告等级和修复建议，支持只检查本次 diff，不拖慢全量 CI。

用户

使用 Cursor / Copilot / Codex 等工具进行 AI 辅助开发的小团队和独立开发者，尤其是接手 AI 生成代码库的技术负责人

MVP

只支持 JavaScript / TypeScript / Python；基于 git diff 只检查变更文件；用 AST 加简单规则检测文件行数、函数长度、职责混杂和圈复杂度；输出终端彩色报告和退出码；提供一个 .codesmell.yml 配置文件

变现

开源核心规则引擎，高级规则包和团队仪表盘按席位订阅（每席 5～8 美元/月），或者一次性买断桌面端

为何现在

AI 编码工具普及后，代码库膨胀和架构腐烂的速度远超以往，但现有 linter 关注的是语法和风格，不是 AI 特有的架构问题；独立开发者可以快速切入这个缝隙