SuperAPI AI 工具集

skill-cleanup

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:作为 skill-usage-stats 的配套工具,读取相同的 HTML 使用统计报告,按标记或用户自选条件把技能归档,过程中不删除任何文件。

主要能力:对选中的技能目录,移动到 ~/.claude/skills-archive/<source>/<skill-name>/(或 ~/.codex/skills-archive/...);在归档目录内把 SKILL.md 改名为 SKILL.md.archived,使工具链不再视其为活跃技能;同时写入 .archived-meta.json,记录原始路径、归档日期和来自统计报告的原因。restore <name> 可还原并改回 SKILL.md。

使用方式:先运行 python3 ~/.claude/skills/skill-usage-stats/analyze.py --no-open 生成统计;再以默认干跑方式运行 python3 ~/.claude/skills/skill-cleanup/archive.py 查看将归档内容;确认后加 --apply 执行。常用参数:--verdict DELETE(默认,仅归档 DELETE 类)、--verdict DELETE,REVIEW、--days 90(归档计数大于 0 但超过 N 天未用的技能)、--source claude-global(仅归档单一来源)、--dry-run(默认,不实际移动)。还原与查看:python3 ~/.claude/skills/skill-cleanup/archive.py restore、python3 ~/.claude/skills/skill-cleanup/archive.py list-archive。

适用场景:清理不再使用或过期的 Claude/Codex 技能,保持技能库整洁且可追溯、可还原。

限制:默认干跑;从不删除,归档完全可逆;跳过不在统计报告中的技能,避免误归档未扫描技能;拒绝操作插件缓存路径(~/.claude/plugins/cache/...),因为该处由插件市场管理,重命名会被重新安装。