Skill Cleaner
在修剪技能提示预算、发现重复技能、审计已启用/禁用的技能根目录,或决定移除哪些技能/插件时,使用此工具。
工作流程
- 从此技能目录或仓库根目录运行分析器:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3
有用的变体:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-live --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 6 --max-log-mb 800 --deep-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --context-tokens 272000 --budget-percent 2 --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/Dropbox/boxd/skills --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/.agents/skills --root-only --no-logs
- 按以下顺序阅读报告:
Skill Budget:实时 Codex 清单,2% 预算,预算使用情况,以及完整描述压力。Description candidates:描述过长的技能,精简语法可节省提示预算。Duplicates:跨 Codex、插件缓存、仓库同级目录和个人技能根目录的相同技能名称或近乎相同的描述/主体。Unused candidates:在最近的 Codex/OpenClaw 日志中,没有用户提及或实际读取SKILL.md的技能。Root summary:技能来源以及配置是否标记为禁用。
- 在删除或编辑之前:
- 确认保留的副本存在且已加载。
- 如果 Codex 内置技能已覆盖,优先删除仓库本地或
agent-scripts的重复项。 - 当仓库本地 OpenClaw 维护技能编码了仓库策略或实时操作时,保留它们。
- 保留描述中的触发名词:产品、工具、动作、对象。
分析器说明
- 默认情况下,
codex debug prompt-input提供模型可见的精确技能列表、顺序、名称和别名路径。--no-live强制使用更广泛的文件系统后备方案。 - 广泛的文件系统扫描仍用于重复、禁用和归档缓存诊断;它不被视为已加载的清单。
- 脚本镜像 Codex 模型可见的行形式:
- name: description (file: path)。 - 它应用 Codex 类似的前置元数据规则:仅 YAML 前置元数据,默认名称来自父目录,单行清理后的
name和description。 - 它遵循 Codex
core-skills/src/render.rs:原始context_window的 2%,token 成本ceil(utf8_bytes / 4),然后完整描述 -> 等量描述截断 -> 省略最小行数。别名表的行成本已包含在内。 - 它读取
~/.codex/models_cache.json以获取 GPT-5.5context_window;后备方案为 272,000 个 token 和 2%。 - 默认情况下,仅扫描普通的 Codex/插件/仓库技能根目录。额外的文件夹(如 Dropbox 归档)仅通过
--root <path>包含。 --root-only需要至少一个--root <path>,跳过实时 Codex 清单,仅扫描提供的根目录。- 它对根目录进行 realpath 去重,因此符号链接根目录(如
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills)不会造成虚假重复。 - 对于重复名称,它报告描述/主体相似度,并仅当主体接近副本时才建议删除候选。保留优先级默认为直接 Codex 系统技能,然后是直接 Codex 技能,再是插件技能,最后是个人/仓库副本。
- 默认情况下,它扫描
~/.codex/history.jsonl和最近的~/.codex/sessions/**/*.jsonl。添加--deep-logs可扫描归档会话和常见的 OpenClaw/Clawd 日志文件夹。 - 使用证据是启发式的:用户
$skill/use skill提及以及在工具调用参数中观察到的路径。
输出策略
- 先建议;仅在用户要求时进行编辑。
- 如果要求应用清理,则进行小型分组提交:描述、删除、配置禁用。
- 在不指明目标或确认它们是可丢弃的情况下,不要删除被忽略/未追踪的技能目录。