用途:管理 Codex Skill 的可见性与加载开销,支持列出、审计未使用技能、禁用未使用或低频技能、验证结果以及从备份恢复。不卸载插件,也不通过编辑 SKILL.md frontmatter 禁用技能。
主要能力:脚本会启动临时本地 codex app-server,调用 skills/list 与 skills/config/write。支持 list 查看总数、启用与禁用数量;audit-unused 审计近期使用证据;disable-unused 禁用未使用技能,默认 dry-run,加 --apply 才写入;verify 验证;restore 从备份恢复;set 针对特定技能切换启用状态。apply 模式备份保存在 ${CODEX_HOME:-$HOME/.codex}/backup/skill-disable-unused-YYYYMMDD-HHMMSS/。
使用方式:先设置 SKILL_DIR,再运行脚本,例如 python3 "$SKILL_DIR/scripts/codex_skill_admin.py" list --cwd "$PWD",审计用 audit-unused --cwd "$PWD" --days 30,禁用用 disable-unused --cwd "$PWD" --days 30 --apply。可用 --max-uses N 纳入低频技能,用 --exclude-session PATH 排除会话。系统技能默认保留,仅在明确要求时用 --include-system。
限制:审计基于本地证据,非产品 Profile 页面的服务端分析;仅统计有实际文件读取操作且结果成功的记录,失败、未知或不支持的读取意图会单独报告并保护相关技能不被禁用。桌面 Skills 标签计数为发现总数,禁用后预期不变,应以 enabledCount 与 availableSkillCount 作为 token 加载成功指标。备份文件含本地路径与使用证据,应视为私有诊断数据。若脚本失败或协议变更,可参考 references/app-server-protocol.md。