Token Saver 是一个面向 AI 编程智能体的技能,目标是在不牺牲输出质量的前提下降低 token 消耗、延长各类使用额度(5 小时、每周和每月上限、credits、API 花费)。该技能有两个职责:在激活时按核心规则精简工作;当用户要求审计/设置或持续触顶时,运行“审计与设置”流程。对于 Claude Code、Codex、GitHub Copilot、Cursor 和 OpenCode,另有 token-saver-<agent> 专用技能携带对应命令与设置;本技能是智能体中立版本。
核心规则强调“精简且正确”:每次请求都会重发整个上下文,成本随上下文大小与请求数增长;输出 token 比输入 token 贵数倍;返工成本最高,因此只在前两者上做不会引发返工的削减。行动前,若请求歧义会改变结果,先问一个简短问题而非猜测;多文件或高风险改动先列计划;知道足够行动即停止探索,不为窄需求扫描整个代码库。读取时先定位(grep、glob、符号搜索、LSP),再只读大文件的相关范围;不重复读取已在上下文中且未变化的文件;不读取锁文件、生成/压缩/构建产物、vendored 依赖或整份日志,改为搜索。工具输出优先摘要形式,如 git status -s、git diff --stat、git log --oneline -n 20,只列一个目录而非递归树;运行能证明改动的最窄检查(单个测试文件或用例、触碰文件的类型检查)并加静默标志;长输出通过 tail -n 40 或 grep 过滤;必要时最后跑一次全量测试;独立工具调用同一轮并发,同一文件的编辑一次完成。
委派方面默认自己做:子智能体有成本,需新上下文、重载指令、重新发现已知信息、增加延迟且 token 计入同一限额,其摘要还会丢失细节。仅在需要读约十个以上文件或大输出且只需短摘要、有三个以上可并行的独立只读任务、或需要干净上下文的独立审查时才委派;小任务、依赖上一步输出、需来回沟通及所有编辑留在主线程;写入保持单线程,禁止两个智能体编辑同一文件。委派时用更便宜模型、给精确简报(目标、路径、返回内容、长度上限)、要求带 path:line 引用的结论,且不重复子智能体的阅读。
回答以结果开头,不复述请求、不罗列未变内容、不整文件倾倒;答案大小与问题匹配,可选附加项一行提出。不为省 token 牺牲正确性:困难 bug、安全、数据丢失风险或架构问题该读多少读多少,一次正确胜过两次廉价错误;绝不跳过验证,而是做针对性验证。会话辅导仅在自然断点给一行建议:切换无关任务建议新会话,长会话建议带焦点提示压缩,旗舰模型做常规工作建议更便宜设置,小模型遇难题建议升级。
每个智能体都有的杠杆包括:新会话、压缩、模型选择、推理强度、常驻指令精简、工具与 MCP 服务器按需禁用、子智能体限制、忽略文件配置。审计与设置流程:在项目根运行 node <技能目录>/scripts/audit.mjs,可检测 Claude Code、Codex、Copilot、Cursor 和 OpenCode 配置(--agent <name> 或 --agent all),只读并打印警告与修复建议;其他智能体手动检查上述杠杆。按预期节省排序报告发现,常驻内容通常最重要;提出具体修改,配置与指令文件属于用户,展示 diff 并在同意后应用;可提议把 assets/always-on.md 追加到智能体常驻指令文件(如 AGENTS.md),除非已有等价段落。参考文件 references/levers.md 说明各杠杆在常见智能体中的位置及官方来源,改配置前阅读;references/budget.md 说明如何按 5 小时、每周和每月窗口安排工作,在用户询问何时用昂贵模型或如何避免用尽时阅读。