mcpField
S
sweep

sweep

github.com/venhdev開発110 回インストール今日更新
リポジトリ

sweep について

sweepは、ワークスペース整理用のスキルです。一時ファイル、完了したタスク群、マージ済みworktreeを特定し、削除前に候補を提示して明示的な承認を求めます。進行中または未確認の作業は保持します。

主な機能

  1. 01一時ファイルとタスク群の監査
  2. 02マージ済みworktreeとブランチの特定
  3. 03承認用の削除候補の準備
  4. 04進行中および変更中の作業の保持
  5. 05worktreeメタデータの整理

活用シーン

  1. 01不要な開発時ファイルの発見
  2. 02完了確認済みタスクディレクトリの削除
  3. 03承認後のマージ済みworktree整理

インストール

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

$npx skills add https://github.com/venhdev/skills --skill sweep

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

同梱ファイルscripts/prune-squashed.sh

詳細

sweep — ワークスペース整理・完全削除エンジン

運用上の不変条件

  • 変更前のゲート：削除候補をすべて標準出力契約に記載し、ファイルを削除する前に明示的な承認を得るまで停止します。
  • 作業中の成果物の保護：完了したことを確認済みの成果物のみを削除します。ready または in-progress のタスクを含むタスクコレクション、変更のある作業ツリー、未マージのブランチは保持します。
  • 対象範囲の限定：削除対象は .agents/scratch/、完全に完了した .agents/tasks/<feature-slug>/ ディレクトリ、およびマージ済みの .agents/worktree/ パスに厳密に限定します。
  • アトミックな実行：承認済みの削除をアトミックに実行し、git worktree prune で不要になった Git 管理メタデータを整理して、回収状況を報告します。

対象領域の基準

1. 回収対象
  1. スクラッチファイルと調査資料：一時スクリプト（hitl-loop.sh）、サブエージェントのトレース（*-dossier.md）、および .agents/scratch/ にある取り込まれたスパイクディレクトリ。
  2. 完了したタスクコレクション：配下のすべてのタスクの Status: done が確認された、.agents/tasks/<feature-slug>/ 配下の機能ディレクトリ。
  3. マージ済みの作業ツリーとブランチ：.agents/worktree/ 配下のクリーンな作業ツリー、および scripts/prune-squashed.sh で確認されたスカッシュマージ済みのローカルブランチ。
2. 状態
  • CLEAN：ワークスペースに未回収の一時成果物がありません。
  • STAGED：回収可能な項目が特定され、ユーザーの承認待ちとして準備されています。
  • DONE：承認された削除を実行し、ファイルシステムの状態を確認済みです。
  • UNRESOLVED：変更のある作業ツリー、または未確認のタスク状態により、安全な削除を実行できません。

標準出力契約

# Sweep Manifest: Workspace Hygiene · <CLEAN | STAGED | DONE | UNRESOLVED>

| Dimension | Target Coordinate | Reclamation Action |
| :--- | :--- | :--- |
| Scratch | .agents/scratch/<file_or_dir> | Delete ephemeral trace / PoC |
| Tasks | .agents/tasks/<feature-slug>/ | Delete completed feature collection |
| Worktree | .agents/worktree/<branch>/ | Remove worktree and prune metadata |
| Branch | <branch_name> | Delete squash-merged local branch |

Summary: <N> items staged for purge.
*(omit if clean)* Gap: <Blocker preventing deletion, e.g. dirty worktree.>
振り分け
  • ワークスペースが CLEAN で、開発を続ける場合 →（/forge 経由）。
  • 監査中に未完了のタスクが見つかった場合 →（/track-tasks 経由）。
  • ブランチまたはタスクの所有者が不明確な場合 →（/clarify 経由）。

実行プロトコル

  1. 監査：.agents/scratch/、.agents/tasks/、.agents/worktree/、およびローカルブランチをスキャンします。クリーンな場合は CLEAN を出力して停止します。
  2. 準備：削除候補を対象領域ごとに分類し、安全条件（未完了タスクがないこと、変更のある作業ツリーがないこと）をすべて確認して、STAGED マニフェストを提示し、承認を待って停止します。
  3. 完全削除：承認後、準備済みのファイル／ディレクトリを削除し、git worktree prune を実行し、bash scripts/prune-squashed.sh を実行して、DONE を報告します。

コメント

Markdown 対応