ディレクトリに戻る

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

スター

66

フォーク

JavaScript

言語

MIT

ライセンス

2026-03-26

作成日

2026-09-01

最終プッシュ

MIT ライセンス、12 冊の古典的エンジニアリング書籍に基づく AI コードレビュースキルパック。標準 Agent Skills として dsh の ~/.dsh/skills にインストールされ、6 つのレビューモードと書籍引用付きの所見、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

02DeepSeek 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 内でのレビューはエージェント自身が実行します。CI で GitHub Action を使う場合、diff は api.anthropic.com または `api-base-url` で指定した任意の Anthropic 互換エンドポイントに送信されるため、ソースコードを預けてもよいホストだけを指定してください。コストは PR 1 件あたり約 $0.05–0.15 です。

dsh 統合は検証されていますか?

README によると、Claude Code・Gemini CLI・Codex CLI はメンテナーによる検証済みです。dsh など残りの 9 プラットフォームは各ツールの公式スキル仕様に沿って文書化され、ファイル配置レベルで検証済み(インストーラーはテスト済み)ですが、メンテナーによるエンドツーエンドの実行検証はまだ行われていません。

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。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。