warden について
wardenは、コミット前にコード変更を分析するコマンドラインスキルです。トリガーによる実行のほか、ファイルやスキルを指定でき、修正の自動適用にも対応します。指摘は深刻度別に表示されます。
主な機能
- 01未コミット変更の分析
- 02指定ファイルの分析
- 03特定スキルの実行
- 04--fixによる修正の自動適用
- 05スキルトリガーの初期化と管理
活用シーン
- 01コミット前の変更確認
- 02指定したソースファイルの検査
- 03報告された問題の自動修正
- 04Wardenの設定とワークフローの準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ getsentry/ warden --skill wardenインストール後、Claude Code で/wardenを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
SOURCES.mdSPEC.mdreferences/cli-reference.mdconfig-schema.mdconfiguration.mdcreating-skills.md詳細
コミットする前に Warden を実行して、コードの変更を分析します。
リファレンス
詳細が必要な場合は、該当するリファレンスをお読みください。
| ドキュメント | 読むタイミング |
|---|---|
<skill-root>/references/cli-reference.md | オプションの詳細、コマンドごとのフラグ、使用例を確認するとき |
<skill-root>/references/configuration.md | warden.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 キーを設定してください。
コミット前のワークフロー
コードを変更した後、コミットする前に次の手順を実行します。
wardenを実行して、未コミットの変更を分析します- 検出結果を確認します
- Warden が報告した問題を修正します(または
warden --fixを使って自動適用します) - 変更をコミットします
作業の検証には Warden を一度だけ実行してください。同じ変更に対して Warden を繰り返し実行しないでください。
出力の読み方
重大度:
high- マージ前に必ず修正してくださいmedium- 確認を推奨しますlow- 軽微な改善です
終了コード: 0 = 失敗しきい値以上の検出結果はありません。1 = 失敗しきい値以上の検出結果があります。
詳細度: -v は検出結果をリアルタイムで表示します。-vv はデバッグ情報(トークン数、レイテンシ)を表示します。-q はエラーと概要のみを表示します。
コマンド
| コマンド | 説明 |
|---|---|
warden | 分析を実行します(デフォルト) |
warden init | warden.toml と GitHub ワークフローを初期化します |
warden add [skill] | warden.toml にスキルのトリガーを追加します |
warden sync [remote] | キャッシュされたリモートスキルを更新します |
warden setup-app | マニフェストフローで GitHub App を作成します |
すべてのオプションとフラグについては、<skill-root>/references/cli-reference.md をお読みください。
コメント
Markdown 対応