Codex-Skill-AutoClean 是做什么的?
本地优先的 Codex 插件,用于安全审计并淘汰未使用的技能。
概述
AutoClean 帮助用户识别并安全移除 Codex 环境中已不再使用的技能,从而保持工作区干净且高效。
功能
- 扫描技能目录:分析指定目录下的所有技能文件。
- 审计报告:基于使用频率和最后活动日期生成未使用技能的列表。
- 安全清理:支持手动确认或自动删除未使用的技能。
- 回滚机制:删除前创建备份,确保可恢复操作。
- 时间戳过滤:仅考虑在特定天数内未使用的技能(默认 30 天)。
用法
# 启动交互式审计
codex run autoscan --dir ./skills
# 自动清理超过 60 天未使用的技能
codex run autoclean --age 60 --force
# 从审计报告中恢复已删除的技能
codex run restore --backup ./backups/2025-01-01
配置
通过环境变量或 YAML 配置文件: autoclean.yml
| 变量 | 描述 | 默认值 |
|---|---|---|
AUTOCLEAN_DAYS | 未使用天数阈值 | 30 |
AUTOCLEAN_BACKUP_DIR | 备份目录路径 | ./backups |
AUTOCLEAN_DRY_RUN | 如果为 true 则仅模拟运行 | false |
实现细节
AutoClean 使用 Python 编写,利用 Codex 的本地文件系统 API 来扫描技能目录,并使用日志文件或元数据确定最后使用时间。它遵守 .codexignore 文件以跳过不想处理的技能。
依赖
- Python >= 3.8
- Codex CLI (本地安装)
许可证
MIT