brooks-lint 是什么?

brooks-lint 是一组跨 Agent 平台的代码质量审查 skills。它把 12 本软件工程著作整理成生产代码与测试代码各 6 类衰退风险,用固定的“症状、来源、后果、对策”格式输出 PR 审查、架构审计、技术债、测试质量、健康看板和全量扫描结果。它依赖宿主模型理解代码,不是传统静态分析器。

⭐ 985 Stars 🍴 47 Forks JavaScript MIT 作者: hyhmrright
来源:github.com/hyhmrright/brooks-lint;https://github.com/hyhmrright/brook… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

AI 代码审查常见问题是每次输出口径不同、建议难以追溯。brooks-lint 用风险编号、严重度、书目来源和固定诊断链约束模型,并提供多平台安装和 CI 门禁。关注度判断只基于项目仍在更新及其可复用的审查框架。

来源:github.com/hyhmrright/brooks-lint

核心功能

十二类衰退风险

生产代码覆盖认知负荷、变更传播、知识重复、偶然复杂度、依赖失序和领域模型失真;测试侧覆盖可读性、脆弱性、重复、Mock 滥用、覆盖率错觉和架构不匹配。

来源:github.com/hyhmrright/brooks-lint
六种审查模式

提供 PR Review、Architecture Audit、Tech Debt、Test Quality、Health Dashboard 和 Full Sweep。Full Sweep 可以自动应用低风险修复,但多文件、接口和架构调整应保留人工确认。

来源:github.com/hyhmrright/brooks-lint
项目级配置与 CI 门禁

.brooks-lint.yaml 可配置严格度、禁用风险、严重度覆盖、忽略路径和自定义风险;GitHub Action 可按健康分、Critical finding 或分数回退失败,并输出 SARIF。

来源:github.com/hyhmrright/brooks-lint
多平台 Agent Skills

同一组 Markdown skills 可安装到 Claude Code、Codex、Gemini、Cursor、Copilot、Windsurf 等平台。安装脚本主要复制 skill 文件;Claude Code 还带 SessionStart hook 生成短命令。

来源:github.com/hyhmrright/brooks-lint

技术架构

skills 目录保存六个独立审查 skill 与共享风险、来源映射和输出规则;commands 与 SessionStart hook 为 Claude Code 提供短命令,其他 Agent Skills 平台按平铺目录加载。evals 保存 57 个场景和 parser fidelity 基准,npm 验证脚本检查版本、清单、文档与触发边界。可选 GitHub Action 检出 diff,调用 Anthropic SDK 把待审查内容发送到 Anthropic API,再发布 PR 评论、门禁结果或 SARIF。

来源:github.com/hyhmrright/brooks-lint;https://github.com/hyhmrright/brook…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 所选 Agent 平台及其模型所选 Agent 平台… CI 模式需要 Anthropic API keyCI 模式需要 Ant… 仓库维护与评测使用 Node/npm仓库维护与评测使… 十二类衰退风险 六种审查模式 项目级配置与 CI 门禁 多平台 Agent Skills brooks-lint 项目本体 核心功能 关键依赖

技术栈

语言Markdown/YAML skills、JavaScript/Node 验证与 benchmark、Shell 安装和 hook框架Agent Skills、Claude Code plugin、Gemini extension 与 GitHub Action
所选 Agent 平台及其模型CI 模式需要 Anthropic API key仓库维护与评测使用 Node/npm
可安装到用户级或项目级 skills 目录;CI 可发布 PR 评论和 SARIF;MIT 许可
来源:github.com/hyhmrright/brooks-lint;https://github.com/hyhmrright/brook…

快速上手

Claude Code 可通过 plugin marketplace 安装;Codex 更适合先克隆仓库,审查 skills、共享规则和 installer,再复制到项目级 .codex/skills 或用系统 skill-installer。首次只运行 PR Review,对一个小 diff 保存原始输出,由开发者逐条核对引用、代码位置和修复可行性。不要先跑会修改代码的 Full Sweep,也不要把健康分直接设成合并门槛。
来源:github.com/hyhmrright/brooks-lint

使用场景

适合给 PR 评审建立固定检查维度、对遗留系统做技术债盘点、讨论模块依赖和领域模型,或把团队接受的风险规则写进项目配置。语法、类型、安全漏洞与确定性规则仍应交给编译器、测试、linter、SAST 和人工评审;brooks-lint 的得分不能替代这些证据。

来源:github.com/hyhmrright/brooks-lint;https://github.com/hyhmrright/brook…

优势与局限

优势

  • 审查输出有固定风险编号、严重度和诊断链,便于团队讨论
  • 书目到 skill 的映射、例外与误报防护公开在仓库中
  • 六个模式可分开安装和调用,并支持项目配置
  • 有 57 场景 eval、parser fidelity benchmark 与 CI/SARIF 集成

局限

  • 书目引用和风险判断由语言模型生成,引用存在不代表结论正确或完整
  • 0–100 健康分是项目自定义量表,不能与缺陷率、安全性或可维护性直接等同
  • Full Sweep 的自动修复会修改代码,必须在分支中审查 diff 并运行项目测试
  • CI 会把 diff 发送到 Anthropic API并产生模型费用,私有代码需评估数据政策与密钥权限
  • 作者自己的 benchmark 和 57 场景 eval 不是独立第三方验证
来源:github.com/hyhmrright/brooks-lint;https://github.com/hyhmrright/brook…

最新版本

官方工作流在 2026 年记录了 chore(release): 1.4.3,README 的 GitHub Action 示例也固定到 v1.4.3;功能说明把当前体系称为 v1.4。项目没有在可读取的搜索结果中提供独立 release notes 页面,因此本页把 1.4.3 作为仓库版本标记,不补写未经核实的变更列表。

来源:github.com/hyhmrright/brooks-lint/actions;https://github.com/hyhmrrig…

实测与证据

status: docs_only_official_sources_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 阅读 hyhmrright/brooks-lint 官方 README、中文 README、CLAUDE.md、SECURITY、安装说明、工作流和许可证;未安装 plugin/skills,未调用模型或 GitHub Action。  |  limitations: 没有验证触发、引用准确率、健康分稳定性、eval、benchmark、自动修复、SARIF、跨平台目录兼容或每次 PR 约 0.05 至 0.15 美元的项目方成本估计。  |  observed_output: 官方工作流记录显示 1.4.3 release 提交,README 的 GitHub Action 示例也使用 v1.4.3;README 把当前能力归入 v1.4 系列,列出 12 本书、12 类风险、6 个 skills 和 57 场景 eval。

来源:github.com/hyhmrright/brooks-lint;https://github.com/hyhmrright/brook…

同类项目对比

相比 GitHub Copilot code review,brooks-lint 是可检查、可改写的 skills 框架,强调 12 本书、固定风险分类和跨多个 Agent 平台;CI 需要自备 Anthropic API key。GitHub Copilot review 深度集成 PR reviewer、IDE、建议应用、自动复审和组织策略,但使用付费 Copilot/AI credits 与 Actions 分钟。两者都可能漏报或误报,GitHub 官方同样要求人工验证;需要自定义审查框架时选 brooks-lint,需要 GitHub 原生流程时选 Copilot review。

来源:github.com/hyhmrright/brooks-lint;https://docs.github.com/en/copilot/…

总结评价

brooks-lint 值得作为团队审查清单的起稿,但不应把书名和健康分当成客观证明。先在一个历史 PR 上盲测,统计真正有用、重复和错误的 findings,再根据仓库特点禁用或降级风险;只有稳定后才考虑 CI 门禁。

来源:github.com/hyhmrright/brooks-lint

常见问题

brooks-lint v1.4.3 是传统 linter 吗?

不是。它是一组交给语言模型执行的审查 skills,关注架构、复杂度、领域模型和测试质量。ESLint、Pylint、编译器、测试和 SAST 仍需保留。

brooks-lint 的书目引用能证明 finding 正确吗?

不能。书目来源提供思考框架,但模型可能误解代码或套用概念。要核对具体文件、执行路径、测试和原书语境,再决定是否接受建议。

可以让 brooks-sweep 自动修复整个仓库吗?

可以运行,但不应无审查合并。官方区分安全修复、多文件或接口改动和人工架构决策;应在独立分支查看 diff、运行测试并逐项确认。

brooks-lint CI 会把代码发到哪里?

官方 SECURITY 说明 GitHub Action 用调用方的 ANTHROPIC_API_KEY,把待审查 diff 发送给 Anthropic API。使用私有仓库前要检查数据政策、保留范围和 secret 权限。

brooks-lint 和 GitHub Copilot code review 怎么选?

要公开可改的风险框架和跨平台 skills,可先试 brooks-lint;要 GitHub 原生 reviewer、IDE 与组织策略,Copilot review 集成更完整。两者都不能替代人工审查。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件