用途:让仓库回到已知的良好状态。分层动作包括 scan(只读盘点)、caches(清理工具与 linter 缓存)、build(清理构建产物与日志,含 caches)、git(清理过期元数据并审计分支与 stash)、stash(审计并分类 stash)、all(缓存+构建+git 卫生)、tree(把工作区重置为刚克隆的样子,破坏性),以及对应的多仓库批量形式。
必要用法:先运行 resolve-clean-action.sh 解析动作;空参数时从上下文推断,无法确定则展示动作表询问,最安全回退是 scan。只读盘点用 scan.sh;caches 用 clean-caches.sh;build 用 clean-build.sh --include-caches;git 用 git-prune.sh 与 git-branch-audit.sh、git-stash-audit.sh;all 依次执行上述;tree 用 git-tree-reset.sh,默认 --dry-run,须展示 dry-run 输出并取得用户本人确认后才加 --apply。首次调用从不直接 --apply。
限制:tree 属破坏性,永不自动触发,也从不并入 all;默认保留 .env*、.local.json 等密钥与配置、node_modules/、.venv/、vendor/ 等运行时依赖以及技能自有 data/,仅 --include-secrets / --include-deps 可删除。会话内 PreToolUse 钩子会拦截 rm -rf、git clean -f、git reset --hard 等命令,确认后需以 CLEAN_GUARD_ACK=1 前缀重发;可用 clean_destructive_guard_enabled=false 关闭。tree 后需用项目自身 bootstrap 重装依赖并验证环境。批量与 orphaned path 删除等细节见对应参考文档;未提供信息未展开。