warden-sweep について
warden-sweepは、リポジトリ全体をWardenで検査し、検出事項の確認や追跡、ドラフトPRの準備を行うワークフロースキルです。再開可能な段階的手順で作業を進め、最終レポートをまとめます。
主な機能
- 01Wardenによるリポジトリファイルのスキャン
- 02修正前の検出事項の検証
- 03追跡用Issueの作成
- 04検出事項の修正とドラフトPRの作成
- 05実行の再開とレポートの整理
活用シーン
- 01リポジトリのWarden検出事項の確認
- 02修正前の検出事項の検証
- 03IssueとドラフトPRによる検証済み作業の追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ getsentry/ warden --skill warden-sweepインストール後、Claude Code で/warden-sweepを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
SOURCES.mdSPEC.mdreferences/issue-phase.mdorganize-phase.mdpatch-phase.mdpatch-prompt.mdresume-and-artifacts.mdscan-phase.mdscript-interfaces.mdverify-phase.mdverify-prompt.mdscripts/_utils.pycreate_issue.pyextract_findings.pyfind_reviewers.pygenerate_report.pyindex_prs.pyorganize.pyscan.py詳細
Warden スイープ
Warden でリポジトリ全体をスイープします。ファイルをスキャンし、検出結果を検証し、追跡用 Issue を作成し、検証済みの問題に対してドラフト PR を作成して、最終レポートを整理します。
必要なもの:warden、gh、git、jq、uv。
コマンドはリポジトリのルートから実行します。同梱のスクリプトとリファレンスには、ホストのスキルルートパスを使用してください。
出力先は .warden/sweeps/<run-id>/ です。
リファレンス
現在のフェーズで必要なリファレンスのみ読み込んでください。
| 必要な情報 | 読むファイル |
|---|---|
| スクリプトの引数、出力、副作用 | references/script-interfaces.md |
| フェーズ 1 のスキャンワークフロー | references/scan-phase.md |
| フェーズ 2 の検証ワークフロー | references/verify-phase.md |
| フェーズ 3 の追跡用 Issue ワークフロー | references/issue-phase.md |
| フェーズ 4 のパッチとドラフト PR のワークフロー | references/patch-phase.md |
| フェーズ 5 の整理と最終レポートのワークフロー | references/organize-phase.md |
| 再開時の動作と成果物のレイアウト | references/resume-and-artifacts.md |
| 検証タスクのプロンプトテンプレート | references/verify-prompt.md |
| パッチタスクのプロンプトテンプレート | references/patch-prompt.md |
ワークフロー
フェーズごとの進捗を記録してください。
- フェーズ 1:Warden でリポジトリのファイルをスキャンします。
- フェーズ 2:パッチを適用する前に検出結果を検証します。
- フェーズ 3:追跡用 Issue を作成します。
- フェーズ 4:検証済みの検出結果にパッチを適用し、ドラフト PR を作成します。
- フェーズ 5:結果を整理し、最終レポートを作成します。
フェーズの順序
- スクリプトを実行する前に、
references/script-interfaces.mdを一度読みます。 references/scan-phase.mdの手順に従ってフェーズ 1 を実行します。runIdとsweepDirを保存します。references/verify-phase.mdの手順に従ってフェーズ 2 を実行します。パッチを適用する前に、すべての検出結果を検証します。references/issue-phase.mdの手順に従ってフェーズ 3 を実行します。Issue の作成に失敗しても続行します。references/patch-phase.mdの手順に従ってフェーズ 4 を実行します。パッチは検出結果ごとに 1 件ずつ順番に適用します。references/organize-phase.mdの手順に従ってフェーズ 5 を実行します。- 実行が中断された場合や一部のフェーズしか完了していない場合は、
references/resume-and-artifacts.mdを読み、最初の未完了フェーズから続行します。
必ず守るルール
- 修正を作成する前に、検出結果を検証します。
- 生成したパッチにはドラフト PR を使用します。
- 各パッチのブランチは、リポジトリのデフォルトブランチから作成します。
- 検出結果へのパッチは順番に適用します。パッチ作業を並列で実行しないでください。
- スイープ成果物に既存の項目がある場合は、重複作業を避けるためスキップします。
- 失敗はスイープデータに記録し、可能であれば次の検出結果に進みます。
- パッチの成功後または失敗後に、それぞれのワークツリーをクリーンアップします。
最終回答
整理が完了したら、次の内容を報告してください。
## Sweep Complete
| Metric | Count |
|--------|-------|
| Files scanned | {filesScanned} |
| Findings verified | {verified} |
| PRs created | {prsCreated} |
| Security findings | {securityFindings} |
Full report: `{summaryPath}`
コメント
Markdown 対応