前言¶
WorkBuddy 里删掉一个任务或会话，界面上它消失了，磁盘上的东西却还在。本文介绍的 Skill「清理已删除任务的本地痕迹」就是处理这件事的：把软删除后遗留的工作空间目录和运行时痕迹找出来，默认只预览，确认后整体移入备份目录，不硬删、不动数据库。
下面介绍它的定位、能力、用法和适用边界。
这是什么¶
这是一个 community 来源的 WorkBuddy Skill，坐标 @user_9e42ec7a/workbuddy-cleanup-traces，当前版本 1.0.5，分类 dev-programming，发布者 user_9e42ec7a，标签 requires_api_key=false（不需要 API Key）。SkillHub 页面显示评分 100000、下载 1576 次。
它解决的问题很具体：WorkBuddy 的「删除」是软删除，不是删除文件。
为什么删了任务，磁盘还占着¶
WorkBuddy 的删除只在 workbuddy.db 里把 sessions.deleted_at 置位，并在列表中隐藏该任务。对应磁盘上的内容不会被自动清理：
- 工作空间文件夹，例如
~/WorkBuddy/2026-07-09-22-17-24，或Claw ~/.workbuddy下的对话记录projects~/.workbuddy下的运行时文件sessions- trace 跟踪
traces - 产物索引
artifact-index
任务删得多了，这些目录会一直占着磁盘，同时留下可被翻看的对话与产物痕迹。
核心能力¶
以下能力来自 SkillHub 页面的官方简介。
- 自动定位残留。入口脚本是
scripts/cleanup.py，它按上述路径规则找出已被删除任务对应的本地文件痕迹，不需要用户逐个找目录。 - 默认 dry-run 预览。默认只列出将要处理的内容，不执行任何移动。
- 安全备份，不硬删。确认后把残留整体移入
WorkBuddy根目录/_cleanup_trash/备份目录，可恢复；明确不修改数据库，workbuddy.db保持原样。 - 跳过被共用的文件夹。如果某个工作空间目录仍被现存会话使用，Skill 会智能跳过，避免误伤在用的任务。
- 只清真实文件痕迹。
app/sessions.json（会话索引）由应用依据数据库自动维护，不在清理范围内，本 Skill 只处理真实文件。 - 跨平台。Windows / macOS / Linux 通用，任意 Python 3 即可运行，任何 WorkBuddy 客户端安装即用。
- 自检。内置
--selftest，不需要真实数据即可验证逻辑。
安装与启用¶
本 Skill 基于通用 SKILL.md 格式，按所属客户端的 Skill 安装方式添加即可。写作时官方页面（https://www.skillhub.cn/skills/user_9e42ec7a/workbuddy-cleanup-traces）无法访问，各客户端（Cursor / Codex CLI / Claude Code 等）的具体安装命令未能核实，这里不列，请以 SkillHub 页面为准。
运行时环境要求很简单：系统里有 Python 3 即可，不需要额外依赖，也不需要 API Key。
典型用法¶
下面三步对应 Skill 的默认行为，命令均在 Skill 目录下执行。
先跑自检，验证逻辑是否正常，不需要真实数据：
python scripts/cleanup.py --selftest
自检通过后，直接运行脚本。默认是 dry-run，只输出将要清理的残留，不动手：
python scripts/cleanup.py
查看 dry-run 结果，确认列表里没有仍被使用的会话目录、也没有你想保留的内容后，再按 Skill 给出的参数执行实际清理。清理动作是「移动」而非删除：文件被整体放进 WorkBuddy根目录/_cleanup_trash/，需要时可以从这里恢复。
触发词：「清理痕迹」「删了任务但工作空间还在」「删除会话后清空间」「同步清理工作空间」「清一下 workbuddy 的残留」。
适用场景与注意¶
适合这几类情况：
- 磁盘清理：删掉大量任务/会话后回收空间。
- 隐私痕迹管理：不再需要已删任务的对话记录和产物，不希望它们留在本地。
- 定期维护：作为例行维护步骤，周期性清理累积的残留。
几个需要注意的点：
- 本 Skill 不修改数据库，也不清理
app/sessions.json。如果需要完整重置，得另做处理。 - 它判断「已删除」的依据是 WorkBuddy 自身的删除状态，因此应与当前客户端和数据库对应，跨实例使用前先确认路径规则一致。
- 文件移入
_cleanup_trash/后仍在磁盘上，空间不会立刻全部释放，需要真正回收空间时再处理该备份目录。 - 被现存会话共用的目录会被跳过，如果 dry-run 里没看到预期的目录，先确认该会话是否仍然有效。
结尾¶
这个 Skill 的价值在于把一件手工、易漏的清理动作变成一条可预览、可回退的命令：默认不动数据，确认后也只是换个位置放着。适合作为 WorkBuddy 的常规维护工具。
官方地址：https://api.skillhub.cn/user_9e42ec7a/workbuddy-cleanup-traces
