SuperAPI AI 工具集

token-saver-codex

编程与开发

查看项目

更新于 10-29 16:15

技能介绍

用途

Token Saver for Codex 是一个针对 OpenAI Codex(CLI、IDE 扩展、云端)的技能,目标是在保持输出质量的前提下,拉伸 5 小时与每周用量限制或积分的使用效率。它有两个职责:一是在激活期间按精简规则工作;二是在用户请求审计、设置或持续触限时,调整配置。

核心规则

技能强调每个请求都会重发完整上下文,成本随上下文大小与请求数量增长;输出 token 比输入 token 贵数倍;返工成本最高。因此只在不引发返工的前提下削减前两项。

  • 行动前:若请求歧义会改变结果,先问一个简短问题;多文件或高风险改动先列计划;信息足够即停止探索,不为窄需求浏览整个代码库。
  • 读取:先用 grep、glob、符号搜索、LSP 定位,再只读大文件的相关范围;不重复读取已在上下文中且未变的文件;不读锁文件、生成物、压缩或构建输出、第三方依赖或整份日志,改为搜索。
  • 工具输出:优先摘要形式,如 git status -s、git diff --stat、git log --oneline -n 20;运行最窄的验证检查并加安静标志,长输出用 tail 或 grep 过滤;独立的工具调用放在同一轮,同一文件的编辑一次完成。
  • 委派:默认自己做。仅在需要读约十个以上文件或大量输出、有三个以上独立只读任务可并行、或需要干净上下文的独立审查时才委派;委派时用更便宜的模型并给出精确简报,要求带 path:line 的结论,且不重复子代理的阅读。
  • 回答:先给结果,不复述请求或罗列未变内容;按问题规模控制篇幅,可选附加项用一行提出。
  • 不为省 token 跳过验证:针对困难缺陷、安全、数据丢失风险或架构问题,按需充分阅读和推理;一次正确比两次廉价错误更省。

会话提示

在自然停顿处至多给出一行建议:切换到无关任务时建议新会话;长会话同一任务建议带焦点提示压缩;旗舰模型或高推理强度跑常规任务时建议更便宜设置,小模型跑难题时建议升级。

Codex 相关事项

本地与云端共享同一额度,云端任务并非免费容量;推理强度是单任务最大杠杆,范围明确的编辑用低,调试和多文件改动用中或高,xhigh 仅用于长时重推理工作;AGENTS.md 受 project_doc_max_bytes(默认 32 KiB)限制,超出部分会被静默丢弃,应保持精简并把目录级指导放入嵌套 AGENTS.md。

用户可自行运行的命令包括:/new 开始无关工作、/compact 在自然停顿压缩、/fork 尝试替代方案而不丢线程、/model 选择更小模型或更低强度、/status 查看剩余量并可把 5 小时与每周限制加入状态栏;不需要速度时关闭 fast mode(每次请求消耗更多积分)。

审计与设置

当用户请求审计、设置、削减用量或持续触限时:从项目根运行 node <技能目录>/scripts/audit.mjs --agent codex,该脚本只读并打印带修复建议的警告;无 Node.js 时按 references/levers.md 手工检查相同项目。按预期节省排序报告发现,每条几行;用 references/levers.md 中的键提出对 ~/.codex/config.toml 或项目 .codex/config.toml 的具体修改,配置属于用户,先展示 diff 并经同意再应用;提议把 assets/always-on.md 追加到项目 AGENTS.md 或 ~/.codex/AGENTS.md(除非已有等效段落),因为技能只在触发时加载,精简规则需要常驻位置。

参考文件

references/levers.md 记录影响用量的 config.toml 键、命令和习惯及精简示例配置,改配置前阅读;references/facts.md 记录限制、积分与定价事实及来源和日期,回答相关问题时阅读并在重要时到链接页核实;references/budget.md 说明如何按 5 小时与每周窗口安排工作节奏。

适用场景与限制

适用于 Codex 用户接近或达到用量上限、希望降低 token 消耗、需要审计配置或建立常驻精简规则的情况。具体限制、积分与定价数值暂未在资料中给出,需查阅 references/facts.md 并核实。