用途:对 ~/Workspace 下的仓库执行只读扫描,找出需要清理的构建产物、缓存等垃圾,并按严重程度排序输出报告,供人工决定清理。
主要能力:报告每条发现含严重程度、仓库、目录、类别、体积、评分、标记原因和建议清理动作;报告还包含按严重程度与体积排序的 Top 发现,以及按标记体积排名的仓库汇总。
使用方式:先加载自定义配置,优先 <skill_root>/config/customization.yaml,缺失时回退 customization.template.yaml;随后运行 scripts/scan_workspace_cleanup.py。常用命令:默认扫描 uv run --with pyyaml python scripts/scan_workspace_cleanup.py;指定工作区根目录加 --workspace ~/Workspace;机器可读输出加 --json;调整噪声与陈旧阈值用 --min-mb 100 --stale-days 90。配置优先级为 CLI 参数、customization.yaml、customization.template.yaml、脚本内置默认值。自定义流程:读取当前配置,确认工作区根目录、阈值(minMb、staleDays、maxFindings)、严重程度切分与目录/文件覆盖规则,给出 2-4 个选项包及一个推荐默认,创建或更新 customization.yaml(schemaVersion: 1、isCustomized: true、profile),用一次扫描验证并报告变更键与行为差异。
限制:全程只读,绝不执行破坏性命令,不自动删除产物,不写入被扫描仓库,只提供建议。配置细节见 references/customization.md 与 references/config-schema.md,模式与阈值说明见 references/patterns.md,自动化提示模板见 references/automation-prompts.md。