mcpField
S
sweep

sweep

github.com/venhdev开发110 次安装今天更新
代码仓库

关于 sweep

sweep 是用于工作区清理的技能，可识别临时文件、已完成的任务集合及已合并的 worktree。它会先列出待删除项并要求明确授权，同时保留进行中或状态未核实的工作。

主要功能

  1. 01审查临时文件与任务集合
  2. 02识别已合并的 worktree 和分支
  3. 03暂存删除项以待批准
  4. 04保留进行中及脏工作区
  5. 05清理 worktree 元数据

适用场景

  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. 临时文件与案卷：.agents/scratch/ 中的临时脚本（hitl-loop.sh）、子 Agent 轨迹文件（*-dossier.md）和已吸收的试验目录。
  2. 已完成的任务集合：.agents/tasks/<feature-slug>/ 下所有包含任务的 Status: done 的功能目录。
  3. 已合并的工作树与分支：.agents/worktree/ 下干净的工作树，以及通过 scripts/prune-squashed.sh 验证已通过 squash 合并的本地分支。
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