token-saver-codex

Codex 的 Token 节省指南

此技能有两项职责：

1. 精简工作：在启用期间，每一步都遵循以下核心规则。
2. 优化设置：当用户要求审查或设置，或持续遇到限制时，运行“审查与设置”工作流。

核心规则：精简工作，确保正确

这些规则的原因：每个请求都会重新发送完整上下文，因此成本会随着上下文大小和请求次数的增加而增长。输出 Token 的成本是输入 Token 的数倍。返工的成本最高。只有在绝不导致第三项成本增加的前提下，才减少前两项成本。

开始操作前

• 如果请求存在歧义，且不同理解会导致结果不同，请提出一个简短问题，不要猜测。对于涉及多个文件或风险较高的更改，请先概述计划再进行编辑。
• 一旦掌握了足够的信息，就停止探索。针对范围较窄的请求，不要检查整个代码库。

阅读

• 先定位（grep、glob、符号搜索、LSP），再阅读大型文件中相关的范围。已在上下文中且没有变更的文件，不要重复阅读。
• 不要读取锁文件、生成文件、压缩文件或构建输出、供应商依赖项或完整日志。改为在其中搜索。

工具输出

• 优先使用摘要形式：git status -s、在查看完整差异前运行 git diff --stat、git log --oneline -n 20，以及查看单个目录的 ls，而不是递归列出目录树。
• 运行能够验证更改的最小范围检查（单个测试文件或用安静标志对涉及的文件进行类型检查）。将较长的输出通过 tail -n 40 或 grep -E "FAIL|Error|error:" 管道处理。若有必要，在最后运行一次完整测试套件。
• 在同一轮中并行发送互不依赖的工具调用，并一次性完成对单个文件的所有编辑。

默认亲自处理，不要委派

• 子 Agent 并非零成本。它会从全新的上下文开始，重新加载说明文件，重新发现你已掌握的信息，增加延迟，而且它使用的 Token 也会计入同一限制。它的摘要还可能省略你之后需要的细节。
• 仅在以下任一情况下委派：答案需要阅读许多文件（约 10 个或更多）或大量输出（测试运行、日志、长文档），且你之后不需要这些内容，只需一份简短摘要；存在 3 项或更多可并行执行的独立只读任务；或者你需要在全新上下文中进行独立审查。
• 小型或快速任务、依赖上一步输出的任务、需要来回沟通的工作，以及所有编辑，都应由主线程处理。写入操作应集中在一个线程中，绝不要让两个 Agent 编辑同一个文件。
• 委派时使用成本较低的模型，提供明确的任务说明（目标、路径、返回内容、长度上限），要求结论附带 path:line 引用，并且不要重新阅读子 Agent 已查看的内容。

回答

• 先给出结果。不要复述请求、回顾未更改的内容，或在编辑结果或 path:line 引用足够时贴出整个文件。
• 回答长度应与问题相称。跳过可选的额外内容（文档、重构、额外测试），并用一句话说明可以提供这些内容。

不要为了省 Token 而做得不足

• 对于难以解决的错误、安全问题、数据丢失风险或架构问题，应充分阅读和推理。一次正确的尝试比两次草率且错误的尝试更省成本。
• 绝不要为了节省 Token 而跳过验证。应有针对性地进行验证。

会话建议（仅在自然间隙时用一行提出，每个间隙最多一次）

• 切换到不相关的任务时，建议开启新会话。围绕单项任务进行长时间会话时，建议进行上下文压缩，并提示聚焦方向。
• 对旗舰模型或高推理强度下的常规工作，建议选择成本更低的设置。对小模型上的难题，建议升级模型。

Codex 特定说明

在核心规则的基础上应用以下规则。

• 本地和云端共用同一额度。 云端任务不会带来免费容量；只有在确实能节省工作量时才启动。
• 推理力度是影响单项任务用量的最大杠杆。 范围明确的编辑用 low；调试和多文件更改用 medium 或 high；只有耗时且需要大量推理的工作才用 xhigh。
• AGENTS.md 的大小上限为 project_doc_max_bytes（默认 32 KiB）。超过上限后，Codex 会静默丢弃其余内容，因此请保持文件精简，并将目录专属指导放入嵌套的 AGENTS.md 文件中。
• 向用户提供的建议（由用户执行；你无法代为执行）：

情况	建议
开始处理无关工作	/new
同一任务的会话持续较久	在自然的间歇使用 /compact
想尝试其他方案，但不想丢失当前进度	/fork
在高推理力度或大型模型上处理常规任务	使用 /model 并选择较小的模型或较低的推理力度
不确定还剩多少额度	使用 /status；在状态栏中加入 5 小时和每周限额
不需要速度	关闭快速模式（每次请求会消耗更多额度）

审计和设置

当用户要求审计、设置或减少用量，或者持续触及限额时：

1. 从项目根目录运行 node <this skill's directory>/scripts/audit.mjs --agent codex。该脚本只读，并会输出警告及修复建议。如果没有 Node.js，请参照 references/levers.md 手动检查相同项目。
2. 用几行内容按预期节省量从高到低报告结果。
3. 提议对 ~/.codex/config.toml（或项目的 .codex/config.toml）进行具体修改，使用 references/levers.md 中的键。配置属于用户：展示差异，并且仅在用户同意后应用。
4. 提议添加始终生效的片段：技能仅在触发时加载，因此精简工作规则需要一个简短且永久的位置。将 assets/always-on.md 追加到项目的 AGENTS.md 或 ~/.codex/AGENTS.md，除非其中已包含等效内容。

参考资料

• references/levers.md：影响用量的 config.toml 键、命令和习惯，以及精简配置示例。更改配置前请先阅读。
• references/facts.md：包含来源和日期的限额、额度与定价信息。用户询问限额或定价时请阅读；如果答案很重要，请在链接页面上核实。
• references/budget.md：如何根据 5 小时和每周时间窗口安排工作。