用途：在编码智能体处理大型上下文时减少 token 使用，同时不丢失对完成任务至关重要的证据，并保持可完整恢复。适用于工具输出、日志、差分等体积较大的内容。
主要能力：不被压缩的内容包括用户当前请求、验收标准、活动约束、未解决的错误以及未提交更改警告。需要保留精确命令、文件路径、行引用、失败测试名称、错误信息、决策与最新任务状态。省略内容前先归档完整来源；若无法检索归档，则视为有损。
使用方式：偏好定向读取（rg、行范围、结构化查询），而非读取整个文件。对成功输出优先摘要，对失败输出逐字保留。当压缩包声明省略了证据且缺失细节可能影响正确性时，先检索归档行再行动。不要为了节省 token 而削弱验证、跳过测试、缩短必需代码或提前停止。
压缩大型材料：从项目根目录运行捆绑的 CLI： TOKENOP_SCRIPT="${CLAUDE_SKILL_DIR:-$HOME/.agents/skills/token-budget}/scripts/tokenop.py" test -f "$TOKENOP_SCRIPT" || TOKENOP_SCRIPT="$HOME/.codex/skills/token-budget/scripts/tokenop.py" python3 "$TOKENOP_SCRIPT" compact PATH
Claude Code 会设置 ${CLAUDE_SKILL_DIR}。Skills CLI 将共享的 Codex 副本安装到 ~/.agents/skills 下；回退方案支持直接旧式安装。若命令已知或预计噪音较大，首次运行即压缩，而非先消耗原始输出再压缩。标准输入方式：COMMAND 2>&1 | python3 "$TOKENOP_SCRIPT" compact -。常规输出使用 --max-chars 8000，当关键证据无法容纳时增大该值。读取生成的压缩包，而非原始大量输出。
高效工作：先搜索，再仅打开相关范围；并行运行独立读取；不重新读取未更改的文件或重复成功命令；维护简短任务台账（目标、约束、更改文件、未解决失败、下一步行动）；每个里程碑后，用已验证发现替换陈旧的探索细节；保持用户更新简短，把 token 花在实现与验证上。
恢复被省略的证据：使用压缩包的来源哈希：python3 PATH_TO_SKILL/scripts/tokenop.py retrieve SHA256 --lines START-END；省略 --lines 可检索完整来源。
完成前确认：所需行为已实现；相关测试已实际运行；失败与限制已说明；压缩过程中没有需求消失。仅在更改保留规则或评估质量时阅读 references/policy.md。
限制：资料未提供具体平台支持范围、性能指标或费用信息。压缩包缺少可检索归档时会产生信息损失。