返回目錄

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,458

星數

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 外掛,絕不濫發。