mcpField
P
project-workspace-cleaner

project-workspace-cleaner

github.com/gaelic-ghost开发160 次安装
代码仓库

关于 project-workspace-cleaner

只读扫描工作区根目录下的代码库，并按严重程度排列清理事项。它汇总各仓库结果、报告跳过的路径，只提供建议，不修改或删除文件。

主要功能

  1. 01只读扫描工作区代码库
  2. 02可配置扫描阈值和结果数量
  3. 03按严重程度排列清理发现
  4. 04汇总仓库并报告跳过路径
  5. 05仅提供建议，不修改文件

适用场景

  1. 01检查生成的或长期未用的仓库产物
  2. 02为多个工作区代码库安排清理优先级
  3. 03找出适合人工审查的大目录
  4. 04核查包含部分结果的扫描

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-workspace-cleaner

安装后在 Claude Code 中输入/project-workspace-cleaner确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
config/
customization.template.yaml
references/
automation-prompts.md
config-schema.md
customization.md
patterns.md
scripts/
scan_workspace_cleanup.py
tests/
test_scan_workspace_cleanup.py

详细介绍

项目工作区清理器

对工作区根目录中的仓库进行只读扫描，并按严重程度排列清理任务。

输入

  • 可选的 CLI 覆盖项：
    • --workspace
    • --min-mb
    • --stale-days
    • --max-findings
    • --config
    • --json
  • 配置优先级：
    1. CLI 标志
    2. config/customization.yaml
    3. config/customization.template.yaml
    4. 脚本默认值

工作流

  1. 按照文档说明的优先级解析设置。
  2. 运行 scripts/scan_workspace_cleanup.py。
  3. 如果遍历或 stat 操作失败，记录跳过的路径，然后继续扫描其余可访问路径。
  4. 按严重程度、分数、大小、仓库和目录排列发现项。
  5. 返回排序后的发现项以及仓库级汇总。
  6. 如果没有发现项，也没有跳过的路径，则报告面向用户的清理完成结果。

输出约定

每项发现包含：

  • severity

  • repo

  • directory

  • category

  • size_human

  • score

  • why_flagged

  • suggested_cleanup

  • 仓库汇总包含标记文件的总大小，以及各严重程度的发现项数量。

  • JSON 输出包含 partial_results 和 skipped_paths。

  • 对于面向用户的清理完成运行，输出必须精确为 No findings.

  • 如果跳过了任何路径，则返回部分结果警告并列出跳过的路径，而不是使用清理完成消息。

防护措施

  • 绝不运行破坏性命令。
  • 绝不自动删除构建产物。
  • 绝不向扫描的仓库写入内容。
  • 仅提供建议。

参考资料

  • references/config-schema.md
  • references/customization.md
  • references/automation-prompts.md
  • references/patterns.md

评论

支持 Markdown