1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | brooks-lint |
| 作者/维护者 | hyhmrright（个人开发者） |
| 来源链接 | https://github.com/hyhmrright/brooks-lint |
| 许可证 | MIT（GitHub API 实测，LICENSE 文件原文一致） |
| GitHub Stars | 1,243（GitHub API 实测，2026-07-21） |
| Forks | 58（同上） |
| 最新版本 | v1.4.1（2026-07-17 发布） |
| 安装方式 | 一条命令跨 11 个平台安装脚本，或 Claude Code 插件市场 |
2. 功能介绍与亮点
brooks-lint 是一个把“十二本经典软件工程著作”的方法论编码进结构化审查流程的代码质量技能——不是简单地让 AI 泛泛地评论代码，而是从《人月神话》《重构》《整洁架构》《领域驱动设计》《程序员修炼之道》等经典书籍中提炼出六种“生产代码衰变风险”与六种“测试代码衰变风险”，逐一比对代码。
- 六种运行模式：
/brooks-review（PR 审查）、/brooks-audit（架构审计，附 Mermaid 依赖关系图）、/brooks-debt（技术债优先级清单）、/brooks-test（测试套件质量审查）、/brooks-health（跨维度健康仪表盘）、/brooks-sweep（全维度扫描并自动修复）。 - 结构化输出：每条发现都遵循“症状 → 出处 → 后果 → 修复建议”四段式，并标注具体书籍与章节作为依据，而非笼统的“建议优化”。
- 0–100 健康分：三档严格程度（strict/balanced/legacy-friendly）产出可复现的量化评分，配套一套 30 条真实报告组成的冻结语料库和确定性测试，评分逻辑可自行用
npm run benchmark复核。 - 架构级洞察：
/brooks-audit模式会生成模块间依赖关系的 Mermaid 图，按发现严重度着色，直接在 GitHub / Notion 等支持 Markdown 的环境渲染。
3. 适用场景
固定分类：工程效率与代码质量。
适合已经在用 Claude Code / Codex 等编码 agent 生成或修改代码、但担心“AI 只看得到语法层面”的初中级开发者与小团队——尤其是希望在合并前获得比 ESLint/Pylint 更深一层（架构漂移、知识重复、领域模型失真）反馈,又不想为此再接一个独立 SaaS 工具的场景。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——插件市场一键安装，slash 命令自动注册，官方维护者亲自验证。
- Codex CLI：✅ 原生支持——官方维护者亲自验证，提供 Skill Installer 与命令行两种安装路径。
- OpenClaw：❓ 未验证——项目 README 未提及该平台。
- Hermes Agent：❓ 未验证——项目 README 未提及该平台。
（技能以标准 Agent Skills 格式分发，README 另文档化了 OpenCode、Cursor、Windsurf、Antigravity、pi、GitHub Copilot、Kiro、Factory Droid 共 8 个平台的安装方式，但这些均为“按文件层级验证、未经维护者端到端跑通”的状态，本报告不代为断言其可用性。）
5. 推荐理由
把主观的“AI 觉得这段代码有点问题”变成可追溯到具体书籍出处、可复现评分的结构化诊断，同时以标准 Agent Skills 格式原生覆盖 Claude Code 与 Codex 两个生态，无需额外账号或付费依赖，安装即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 1,243 GitHub Stars，仓库 Issue 区可见至少 6 位独立第三方用户（rapcal、erikpr1994、madjidsun、cary-hu、kergekacsa、grevgeny）主动报告使用体验或提交兼容性问题，曾登上 Trendshift 当日 JavaScript 仓库榜 |
| 可用性 | 9 | 单条命令即可在 11 个平台中的任一平台完成安装；README 含英/简中/繁中/日/韩/西六种语言版本；2026-07-17 刚发布 v1.4.1；无需任何外部 API Key 或付费依赖 |
| 安全性 | 9 | 技能本体为纯 Markdown 提示词与分析指南，不执行任意 Shell 命令、不发起网络请求、不要求任何凭据；MIT 许可、全仓库代码可审计；安装脚本仅做文件复制，未发现可疑指令 |
安全检查清单逐项结果：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 仅安装脚本复制文件到目标目录，技能运行时不执行代码 |
| ② 是否联网外发数据 | 否，全部分析在宿主 agent 会话内完成 |
| ③ API Key/凭据要求 | 无（可选的开发者侧 live 评测套件需要 ANTHROPIC_API_KEY，与终端用户日常使用无关） |
| ④ 可疑指令/Prompt Injection 迹象 | 未发现 |
| ⑤ 作者/组织信誉 | 个人开发者，仓库配有确定性测试套件与冻结语料库，工程规范扎实 |
| ⑥ License 是否明确 | 明确，MIT |
| ⑦ 最近维护时间 | 2026-07-17（4 天前），含近期真实 Bug 修复记录 |
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 brooks-lint 的差异 |
|---|---|---|
| differential-review（Trail of Bits） | 安全导向的 diff 审查，结合 git 历史计算改动“爆炸半径”、检查测试覆盖率 | 聚焦安全回归检测；brooks-lint 聚焦架构/可维护性衰变，且附带可复现的量化健康分 |
| second-opinion（Trail of Bits） | 调用外部 LLM（OpenAI Codex 或 Google Gemini CLI）对改动做“第二意见”审查 | 依赖额外安装的外部 CLI 工具获取多模型视角；brooks-lint 完全在宿主 agent 内运行，不需要接入第二个模型 |
| code-review-and-quality（Addy Osmani） | 五轴（正确性/可读性/架构/安全/性能）通用代码审查 | 覆盖面更广但审查依据来自通用工程原则；brooks-lint 每条发现都能追溯到具体书籍章节，且提供架构依赖关系图与技术债专项模式 |
8. 用户评价
- rapcal（GitHub Issue #14，OpenCode 兼容性咨询）：在维护者提供跨平台安装脚本后回复“Thanks, it looks amazing!”，对工具效果给出正面评价。
- madjidsun（GitHub Issue #21）：提交了一份关于 Claude Code 下技能被模型自动调用时出现无限循环的详细技术报告，诊断准确；维护者两天内定位根因并在 v1.4.1 修复发布，展示了较高的问题响应质量。
9. 其他补充
- README 提供英语、简体中文、繁体中文、日语、韩语、西班牙语六个语言版本。
- 仓库内置 30 条真实报告组成的冻结基准语料库与 57 个场景的评测套件，评分逻辑可通过
npm run benchmark与npm run evals本地复现。
10. 安装使用方式
Claude Code（推荐）：
/plugin marketplace add hyhmrright/brooks-lint
/plugin install brooks-lint@brooks-lint-marketplace首次会话启动时会自动安装 /brooks-review 等短命令。
Codex CLI：
Install the brooks-lint skill from hyhmrright/brooks-lint其他平台（OpenCode / Cursor / Windsurf / Antigravity / pi / Copilot / Kiro / Factory Droid 等）：
curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- <platform>安装完成后直接用自然语言提问（如“review this PR”、“audit the architecture”）即可自动触发对应模式，也可直接输入 /brooks-review 等 slash 命令。
11. 注意事项
- 早期版本在 Claude Code 下曾出现“技能被模型自动调用时陷入无限循环”的问题，已在 v1.4.1 修复，建议安装时确认版本不低于该号。
- OpenClaw 与 Hermes Agent 的兼容性尚未有可验证的官方或第三方说明，若在这两个生态使用需自行验证。
- brooks-lint 定位是架构与可维护性层面的深度审查，不覆盖语法/风格检查，仍需搭配 ESLint、Pylint 等传统 linter 与类型检查器、测试套件一并使用。