SuperAPI AI 工具集

codex-hygiene-skill

通用与其它

查看项目

更新于 10-15 23:24

技能介绍

用途:codex-hygiene 是 Codex Skills 集合中的诊断技能,用于审计和调优 Codex Desktop 的上下文面、工具可用性与 token 消耗。它通过查询本地 SQLite 遥测数据库,测量近期 token 使用情况,并帮助将长时间运行的目标工作流限定在当前任务范围内。

主要能力:按线程和窗口统计输入、输出及总 token;区分实际工具调用与工具可用性、启用状态与缓存清单;识别用量升高的可能原因,如应用面过大、MCP/插件状态、快照复用、过期项目段落、长线程重放或后台扇出;给出不删除日志、缓存或项目的可逆清理建议。

使用方式:安装到 Codex 技能目录后,用 $codex-hygiene 调用。核心命令为 measure_codex_context.sh,可传入近期条目数和可选线程 ID,例如 "$HOME/.agents/skills/codex-hygiene/scripts/measure_codex_context.sh" 5。可用 CODEX_HOME 指定自定义数据位置,用 SKILL_DIR 指定安装目录。脚本只读,不导出完整日志、配置、工具模式、密钥或环境变量。

适用场景:Codex Desktop 变慢或无响应、token 用量异常偏高、需要审计实际被调用的工具、长线程上下文累积、调试 MCP 服务器配置、大型编码会话前优化,以及需要了解 Codex 内部状态时。

限制:面向带本地遥测数据库的 Codex Desktop,支持 macOS、Linux 及类 Unix 系统,依赖 Bash、sqlite3、Perl、awk、sort,jq 与 codex CLI 为可选增强。遥测模式可能随 Codex 版本变化;数据库被占用时可能报锁;无近期使用则无数据。修改 ~/.codex/config.toml 前应备份。收费、价格等信息暂未提供。