claude-routine-cleanup Skill 技能

技能简介

claude-routine-cleanup 是一款专为 Claude Code 桌面端 Scheduled Task（Routine）设计的清理 Skill。每个 Routine 跑一次都会留下一条 Session，高频 Routine 一个月能堆 700+ 条，占盘又拖慢应用加载。它能批量只删「无人工回复」的旧 Routine Run，把「人回复过」与「不可校验」两类全部默认保留，绝不误删你想继续翻的会话。

核心能力

1. 保留最新 N 条：由你指定 keep N，默认保留足够多以便回溯。
2. 三类桶分级：autonomous（无人回复，会删）/ engaged（人回复过，默认保护）/ unverifiable（transcript 已不可读，默认保护）。
3. 全计划先展示：列出每一桶的 Run 数、占用空间、时间跨度、批次数，并标注每次操作的写入策略，从不擅自动手。
4. 走官方 delete_session 通道：不直接 rm 文件，调用 Claude 桌面端自带的删除工具，确保 Runs 列表实时刷新、避免「Session not found on disk」幽灵条目。
5. 强制 25 条/批上限：遵守应用层限制，分批执行；并把多张审批卡合并展示，减少点击次数。
6. 可解锁两类默认保护：通过 ~/.claude/routine-cleanup.json 写入 include_unverifiable: true 等字段，一次性授权下次默认行为。

安装配置

1. 环境前置：Python 3.9+（仅标准库）、Claude 桌面应用、Claude Code v2.1.248+。
2. 推荐先调长保留期：在 ~/.claude/settings.json 设 "cleanupPeriodDays": 3650，把 desktopSessionCleanupPeriodDays 留空，避免被自动过期误删。
3. 作为 Plugin 安装（推荐）：/plugin marketplace add naw103/claude-routine-cleanup + /plugin install routine-cleanup@routine-cleanup。
4. 作为普通 Skill 安装：git clone https://github.com/naw103/claude-routine-cleanup && cp -r claude-routine-cleanup/skills/routine-cleanup ~/.claude/skills/。
5. 可选配置：在 ~/.claude/routine-cleanup.json 写入默认策略（如 { "include_unverifiable": true }），减少每次确认。

使用步骤

1. 在 Claude Code 对话窗口（普通会话，不要在 Routine Run 里）输入 /routine-cleanup nightly-report keep 10，或自然语言说「清理 bug-fix routine 的旧 Run，只留最新 10 条」。
2. Claude 列出所有 Routine，确认目标 Routine 名后展示完整计划（删除数、空间、批次数）。
3. 你回复 yes；Claude 把每 25 条 Run 通过桌面应用自带的 delete_session 工具发起删除，每批弹一张审批卡。
4. 多张卡同时到达，你可以一次性连点确认；最终桌面端 Runs 列表立即清空。

适用场景

• 每小时/每天跑的高频 Routine（Nightly report、Hourly sync、Cron scraper 等）几个月累积大量 Session。
• Claude 桌面端加载慢、磁盘占用飙升，需要立即瘦身但又怕误删历史对话。
• 团队/外包协作里需要把 Routine 跑的历史过一遍审计，再统一清理。
• 想保留至少一份每个 Routine 的早期会话作为参考资料，只清无人回复的冗余 Run。
• 运维定期巡检，把 Routine 清理纳入周期性维护脚本。

适用人群

• Claude Code 桌面端重度用户，跑大量 Scheduled Task 的开发者与研究人员。
• 关注磁盘空间与客户端响应速度的桌面端用户。
• 想保留「我真正回复过」的会话、又懒得手动一条条删的工程师。
• Claude Code 生态 Skill 作者（这是学习 MCP 标准 delete 流程的好范例）。

工作原理

Skill 内部走两层：第一层 planner 用 Python 标准库扫描各 Routine 的 Run 元数据，按是否有人工回复分桶并生成删除计划；第二层执行走 Claude 桌面应用的 delete_session 工具，每次最多 25 条、必须人工审批。不直接删磁盘文件——直接 rm 会留下桌面端内存里的「Session not found」幽灵条目，必须由应用自己写回 Run 记录。同时 Skill 检测 Claude Code 自带的 cleanupPeriodDays 过期策略，建议把窗口拉长到 1 年以上再用本 Skill 主动清理。

官方链接

• GitHub 仓库：https://github.com/naw103/claude-routine-cleanup
• Claude Code 文档：https://code.claude.com/docs/en/claude-directory
• 许可证：MIT