SuperAPI AI 工具集

maintenance

办公与效率

查看项目

更新于 10-15 17:33

技能介绍

用途:这是一个用于文件清理与归档的单一目的技能,在 auto-cleanup-hook 发出警告时,或作为定期家务调用,用于整理散乱、膨胀的文件。

主要能力(子命令):maintenance plans 将 Plans.md 中已完成任务归档;maintenance session-log 按月份拆分 session-log.md;maintenance logs 删除 .claude/logs/ 中过期文件;maintenance state 裁剪 agent-trace.jsonl 与 harness-usage.json;maintenance all 依次执行上述四项。

使用方式:加 --dry-run 只列出将要执行的操作而不实际执行。自由描述的指示(如“连旧归档也删掉”“只保留这个 session-log”)会在 Step 1 接收并反映到后续处理参数。步骤为:解析用户指示(子命令加排除对象、保存位置、天数阈值等自由描述);SSOT 同步检查(若 .claude/state/.ssot-synced-this-session 不存在则提示先运行 /memory sync,仅涉及 Plans.md 时必需);打开 ${CLAUDE_SKILL_DIR}/references/cleanup.md 执行对应章节;报告 Before/After(显示行数与删除条数)。

与 auto-cleanup-hook 联动:PostToolUse hook(scripts/auto-cleanup-hook.sh 或 Go 版 auto_cleanup_hook.go)检测到 Plans.md、session-log.md、CLAUDE.md 行数超限时,会反馈提示用 /maintenance 归档旧任务,看到警告后执行相应子命令。

限制与注意事项:进行中任务不移动,cc:WIP、pm:依頼中、cursor:依頼中 不在归档范围内;归档目录固定为 .claude/memory/archive/,移到别处需向用户确认;编辑超过 200 行的文件前用 cp <file> <file>.bak.$(date +%s) 做本地备份;CLAUDE.md 仅警告不自动编辑,只提出拆分建议。相关技能:memory(整理 Plans.md 前的 SSOT 升格)、harness-setup、session-init。各对象的具体步骤、阈值与归档位置见 cleanup.md。