用途:对工作区根目录下的仓库执行只读卫生审计,发现构建产物、缓存堆积、陈旧大文件等清理机会,并按严重程度排序,帮助用户决定清理优先级。
主要能力:扫描仓库并输出排序后的发现项,每项包含 severity、repo、directory、category、size_human、score、why_flagged、suggested_cleanup;同时给出仓库级汇总,包括被标记总大小和各严重级别的数量。JSON 输出包含 partial_results 与 skipped_paths。
使用方式:通过脚本 scripts/scan_workspace_cleanup.py 运行。可选 CLI 覆盖参数包括 --workspace、--min-mb、--stale-days、--max-findings、--config、--json。配置优先级为:CLI 参数、config/customization.yaml、config/customization.template.yaml、脚本默认值。遍历或 stat 失败时记录跳过路径并继续扫描其余可访问路径。
输出约定:无发现且无跳过路径时,面向用户输出恰好为 No findings.;若有路径被跳过,则返回部分结果警告并列出跳过路径,而不使用该干净结果消息。
限制与护栏:绝不运行破坏性命令,绝不自动删除产物,绝不写入被扫描仓库,仅提供建议。参考资料包括 references/config-schema.md、references/customization.md、references/automation-prompts.md、references/patterns.md。