返回目录

brooks-lint

编辑精选维护状态: 活跃

hyhmrright/brooks-lint

基于 12 本经典工程书籍的 AI 代码评审工具,提供腐化风险诊断、书籍引用、严重度标签及 6 种分析模式。

前往 GitHub项目主页
$ curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh

1,471

星标

66

Fork

JavaScript

语言

MIT

许可证

2026-03-26

创建于

2026-09-07

最近推送

MIT 许可、基于 12 本经典工程著作的 AI 代码审查技能包——以标准 Agent Skills 形式安装进 dsh 的 ~/.dsh/skills,提供六种审查模式、带书目引用的诊断和 0–100 健康分。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

MIT

01它能帮你完成什么?

  • Run book-grounded AI code reviews inside DeepSeek Harness

    Structured findings in Symptom → Source → Consequence → Remedy format with book citations, severity labels and a 0–100 Health Score

    Developers and tech leads running dsh who want consistent, traceable code reviews instead of ad-hoc model opinions

  • Audit architecture and prioritize tech debt in a dsh session

    Mermaid dependency graph with circular-dependency and Conway's Law checks, plus debt ranked by Pain × Spread with a Critical / Scheduled / Monitored repayment roadmap

    Engineering teams onboarding a codebase, planning refactors, or deciding what debt to repay first

  • Sweep a repository and auto-fix decay risks from dsh

    Unified R1–R6, T1–T6 and architecture scan with safe changes auto-applied, multi-file changes confirmed, architectural decisions flagged as manual, plus a Fix Log and score delta

    Teams cleaning up a codebase before a release or migration

02如何接入 DeepSeek Harness?

前置条件

  • DeepSeek Harness (`dsh`) installed — brooks-lint ships as Agent Skills that dsh loads from `~/.dsh/skills`
  • bash + curl to run the one-line installer (or the repo's `scripts/install.sh`)

安装步骤

  1. 01

    Run `curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh` (add `--project` to install into the current repo instead of your global config)

    $ curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh

  2. 02

    The installer copies the skills flat into `~/.dsh/skills` so the shared framework (`../_shared/`) always resolves

  3. 03

    Just ask ("review this PR", "audit the architecture") to auto-trigger the matching skill from its description, or invoke the six commands from dsh's `/` menu — `/brooks-review` is auto-registered

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配兼容

Installed into DeepSeek Harness (dsh) as standard Agent Skills via the one-line installer (`install.sh dsh`); dsh loads them from ~/.dsh/skills and auto-registers /brooks-review

  • Six review modes as slash commands / Agent Skills

    a diff, changed files, or the whole repo, pointed at from a dsh sessionmode-specific reports: PR review, architecture audit, tech debt, test quality, health dashboard, full sweep

    /brooks-sweep applies fixes: safe changes are auto-applied to files, multi-file changes are confirmed, architectural decisions are flagged as manual
  • Cited structured diagnosis with Health Score

    any production code or test suite, in any languagefindings as Symptom → Source → Consequence → Remedy with book citations, severity labels (🔴/🟡/🟢) and a 0–100 Health Score

  • Project configuration via .brooks-lint.yaml

    optional `.brooks-lint.yaml` in the project rootcustomized review behavior: strictness presets, disabled risk codes, severity overrides, ignore globs, custom risks and suppressions

    reads `.brooks-lint.yaml` from the project root when present; all settings are optional
  • CI quality gates via GitHub Action

    a pull request diffreview posted as a PR comment, optional fail-below / fail-on / fail-on-regression gates, SARIF output for GitHub Code Scanning

    sends your diff to api.anthropic.com or the configured Anthropic-compatible endpoint (~$0.05–0.15 per PR run)posts PR comments, can upload SARIF to Code Scanning and fail the check

04适合谁?何时不该用?

适合

  • Developers and tech leads running dsh who want consistent, traceable code reviews instead of ad-hoc model opinions
  • Engineering teams onboarding a codebase, planning refactors, or deciding what debt to repay first
  • Teams cleaning up a codebase before a release or migration

不适合

  • The dsh integration is documented from dsh's official skill spec and verified at the file-layout level (the installer is tested), but has not yet been run end-to-end by the maintainer — only Claude Code, Gemini CLI and Codex CLI are maintainer-verified.

05兼容性、维护与安全提示

  • The dsh integration is documented from dsh's official skill spec and verified at the file-layout level (the installer is tested), but has not yet been run end-to-end by the maintainer — only Claude Code, Gemini CLI and Codex CLI are maintainer-verified.
  • When used in CI, brooks-lint sends your diff to api.anthropic.com or whatever Anthropic-compatible endpoint you configure, so only point it at a host you trust with your source; each PR run costs ~$0.05–0.15.
  • Review quality depends on the underlying model of the host agent — the README measures model quality separately with a 57-scenario eval suite, noting the figures vary slightly run to run.
2026-03-262026-08-14v1.5.0

MIT · actively maintained (latest release v1.5.0, 2026-08-14)

06常见问题

如何把 brooks-lint 安装到 DeepSeek Harness?

运行 `curl -fsSL https://raw.githubusercontent.com/hyhmrright/brooks-lint/main/scripts/install.sh | bash -s -- dsh`。安装器会把技能平铺复制到 `~/.dsh/skills`;加上 `--project` 则安装进当前仓库而不是全局配置。dsh 还会自动注册 `/brooks-review`。

它是原生集成还是 MCP?

都不是——brooks-lint 以标准 Agent Skills 形式交付。dsh 从 `~/.dsh/skills` 加载(同时读取 `~/.agents/skills` 和 `AGENTS.md`),技能会根据自身 description 自动触发;需要显式调用时,dsh 直接使用命令表中的写法,可从 `/` 菜单选择或行内输入。

需要什么前置条件?

只需 DeepSeek Harness(dsh)本身,没有其他必需依赖。可选地在项目根目录放一个 `.brooks-lint.yaml`,用于设置严格度、禁用风险代码或忽略文件。CI 的 GitHub Action 另需 ANTHROPIC_API_KEY。

我的代码会发送到哪里?

在 dsh 内运行时,审查由 agent 自身完成。使用 GitHub Action 做 CI 时,diff 会发送到 api.anthropic.com 或你通过 `api-base-url` 指定的任何 Anthropic 兼容端点——只指向你信任的、可以接触源码的主机。每个 PR 约花费 $0.05–0.15。

dsh 集成经过验证了吗?

按 README 说明,Claude Code、Gemini CLI 和 Codex CLI 已获维护者验证;dsh 等其余九个平台是依据各工具的官方技能规范编写文档,并在文件布局层面验证过(安装器经过测试),但尚未由维护者逐平台端到端运行。

08数据与来源

  • 作者声明github.come9acf5c6100d…

    | DeepSeek Harness (`dsh`) | `~/.dsh/skills` | `~/.agents/skills`, `AGENTS.md` | [setup](docs/dsh-setup.md) |

  • 作者声明github.come9acf5c6100d…

    Kiro, Factory Droid, and DeepSeek Harness also auto-register `/brooks-review`.

  • 作者声明github.come9acf5c6100d…

    # <platform> = opencode · cursor · windsurf · antigravity · pi · kiro · copilot · droid · dsh · gemini · codex · agent…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。