brooks-lint 是一组跨 Agent 平台的代码质量审查 skills。它把 12 本软件工程著作整理成生产代码与测试代码各 6 类衰退风险,用固定的“症状、来源、后果、对策”格式输出 PR 审查、架构审计、技术债、测试质量、健康看板和全量扫描结果。它依赖宿主模型理解代码,不是传统静态分析器。
来源: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.brooks-lint.yaml 可配置严格度、禁用风险、严重度覆盖、忽略路径和自定义风险;GitHub Action 可按健康分、Critical finding 或分数回退失败,并输出 SARIF。
来源:github.com/hyhmrright/brooks-lint同一组 Markdown skills 可安装到 Claude Code、Codex、Gemini、Cursor、Copilot、Windsurf 等平台。安装脚本主要复制 skill 文件;Claude Code 还带 SessionStart hook 生成短命令。
来源:github.com/hyhmrright/brooks-lintskills 目录保存六个独立审查 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…所选 Agent 平台及其模型CI 模式需要 Anthropic API key仓库维护与评测使用 Node/npm适合给 PR 评审建立固定检查维度、对遗留系统做技术债盘点、讨论模块依赖和领域模型,或把团队接受的风险规则写进项目配置。语法、类型、安全漏洞与确定性规则仍应交给编译器、测试、linter、SAST 和人工评审;brooks-lint 的得分不能替代这些证据。
来源: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不是。它是一组交给语言模型执行的审查 skills,关注架构、复杂度、领域模型和测试质量。ESLint、Pylint、编译器、测试和 SAST 仍需保留。
不能。书目来源提供思考框架,但模型可能误解代码或套用概念。要核对具体文件、执行路径、测试和原书语境,再决定是否接受建议。
可以运行,但不应无审查合并。官方区分安全修复、多文件或接口改动和人工架构决策;应在独立分支查看 diff、运行测试并逐项确认。
官方 SECURITY 说明 GitHub Action 用调用方的 ANTHROPIC_API_KEY,把待审查 diff 发送给 Anthropic API。使用私有仓库前要检查数据政策、保留范围和 secret 权限。
要公开可改的风险框架和跨平台 skills,可先试 brooks-lint;要 GitHub 原生 reviewer、IDE 与组织策略,Copilot review 集成更完整。两者都不能替代人工审查。