mcpField
W
warden

warden

github.com/getsentryテスト・品質418322 回インストール今日更新
リポジトリ

warden について

wardenは、コミット前にコード変更を分析するコマンドラインスキルです。トリガーによる実行のほか、ファイルやスキルを指定でき、修正の自動適用にも対応します。指摘は深刻度別に表示されます。

主な機能

  1. 01未コミット変更の分析
  2. 02指定ファイルの分析
  3. 03特定スキルの実行
  4. 04--fixによる修正の自動適用
  5. 05スキルトリガーの初期化と管理

活用シーン

  1. 01コミット前の変更確認
  2. 02指定したソースファイルの検査
  3. 03報告された問題の自動修正
  4. 04Wardenの設定とワークフローの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/getsentry/warden --skill warden

インストール後、Claude Code で/wardenを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

SOURCES.md
SPEC.md
references/
cli-reference.md
config-schema.md
configuration.md
creating-skills.md

詳細

コミットする前に Warden を実行して、コードの変更を分析します。

リファレンス

詳細が必要な場合は、該当するリファレンスをお読みください。

ドキュメント読むタイミング
<skill-root>/references/cli-reference.mdオプションの詳細、コマンドごとのフラグ、使用例を確認するとき
<skill-root>/references/configuration.mdwarden.toml、トリガー、パターン、トラブルシューティングを編集するとき
<skill-root>/references/config-schema.md正確なフィールド名、型、デフォルト値を確認するとき
<skill-root>/references/creating-skills.mdカスタムスキルやリモートスキルの作成、スキルの検出について確認するとき

Warden の実行

# Analyze uncommitted changes (uses warden.toml triggers)
warden

# Run a specific skill
warden --skill <skill-name>

# Analyze specific files
warden src/auth.ts src/database.ts

# Analyze changes from a git ref
warden main..HEAD
warden HEAD~3

# Auto-apply suggested fixes
warden --fix

# Fail on high-severity findings
warden --fail-on high

実行する前に、WARDEN_MODEL と、そのモデル用の WARDEN で始まるプロバイダー API キーを設定してください。

コミット前のワークフロー

コードを変更した後、コミットする前に次の手順を実行します。

  1. warden を実行して、未コミットの変更を分析します
  2. 検出結果を確認します
  3. Warden が報告した問題を修正します(または warden --fix を使って自動適用します)
  4. 変更をコミットします

作業の検証には Warden を一度だけ実行してください。同じ変更に対して Warden を繰り返し実行しないでください。

出力の読み方

重大度:

  • high - マージ前に必ず修正してください
  • medium - 確認を推奨します
  • low - 軽微な改善です

終了コード: 0 = 失敗しきい値以上の検出結果はありません。1 = 失敗しきい値以上の検出結果があります。

詳細度: -v は検出結果をリアルタイムで表示します。-vv はデバッグ情報(トークン数、レイテンシ)を表示します。-q はエラーと概要のみを表示します。

コマンド

コマンド説明
warden分析を実行します(デフォルト)
warden initwarden.toml と GitHub ワークフローを初期化します
warden add [skill]warden.toml にスキルのトリガーを追加します
warden sync [remote]キャッシュされたリモートスキルを更新します
warden setup-appマニフェストフローで GitHub App を作成します

すべてのオプションとフラグについては、<skill-root>/references/cli-reference.md をお読みください。

コメント