SuperAPI AI 工具集

ai-prune

智能体与模型

查看项目

更新于 10-16 03:16

技能介绍

用途:清理仓库中代理产生的临时目录。它审查 .ai/ 和 .cache/ 下的内容,判断哪些条目相对仓库当前状态已明确过时,然后归档或删除。

主要能力:将过时的 .ai/ 条目移动到 .ai/archive/YYYY-MM-DD/,保持原有目录结构;将过时的 .cache/ 条目用 /usr/bin/trash -s 移入 macOS 废纸篓;删除 .ai/ 下变空的目录;输出结果表格(Path、Action、Reason)。

使用方式:仅限 macOS,若 uname -s 不是 Darwin 或缺少 /usr/bin/trash 则停止并报告。可传入可选参数 path(仓库根或仓库内路径,默认当前目录)和 --dry-run(只报告计划,不改动文件系统)。在 Git 内用 git -C "$start_dir" rev-parse --show-toplevel 解析根目录。用 fd 列出文件清单,不逐文件执行命令。

限制与保护:绝不触碰 .ai/todos/、.ai/archive/、任何位置的 TODO.md 和 PROMPT.md、活跃代理状态(如 .ai/coord/、.cache/job-leases/)、仓库配置仍在使用的工具缓存,以及 24 小时内修改过的内容。只有存在具体证据(如工作已完成、引用的文件或分支已不存在、任务已结束的临时目录、仓库不再配置的工具缓存)才判定为过时,否则保留并列为不确定。归档时若目标路径已存在则保留源文件并报告冲突,不覆盖。验证需在文件系统上检查,而非 git diff。