hyhmrright/brooks-lint

解决的问题

brooks-lint 是一个基于 AI 的代码审查工具，能够识别传统 linter（专注于语法和风格）通常忽略的架构漂移、技术债务和领域模型扭曲等问题。它提供了一种基于已确立的软件工程原则而非通用 AI 建议的、结构化且可追溯的代码质量评估方式。

工作原理

该工具整合了十二本经典工程书籍（如《人月神话》、《清洁架构》和《重构》）的原则，对十二个“衰变风险”（生产代码六项，测试套件六项）进行诊断。

在审查代码时，它遵循严格的诊断链：症状 → 原因 → 后果 → 解决方案。每个发现均附有书籍引用、严重性标签（Critical、Warning 或 Suggestion）以及数值健康评分（0–100）。

适用人群

希望获得基于软件工程文献而非仅 LLM 模式的一致性、有证据支持的代码审查和架构审计的软件工程师与架构师。

主要亮点

• 书本溯源分析：每个发现均可追溯至十二本经典软件工程著作之一。
• 六项生产衰变风险：诊断认知过载、变更传播、依赖混乱等问题。
• 架构审计：生成 Mermaid 依赖图，可视化模块关系并识别循环依赖。
• 多平台支持：可作为“代理技能”集成到 Claude Code、Cursor、Windsurf 和 GitHub Copilot 等多种 AI 编程助手中。
• 全面工具集：包含专门用于技术债务路线图（/brooks-debt）、测试套件审计（/brooks-test）和自动修复（/brooks-sweep）的命令。