技能介绍

它解决什么问题

编码代理在接手大型仓库时，很容易把宝贵的上下文窗口耗在重复劳动上：为了定位一个符号，它会反复 grep、rg 或 find；为了确认一行改动是否安全，它会把整段 pytest / cargo test 输出原样带回对话；一个 10 万行的项目，光工具回显就能吃掉数千甚至上万 token，真正的推理空间反而被挤占。当代理需要跨会话回忆“上周改过哪个配置文件”时，这些历史信息往往随着对话结束就丢失了，导致重复探查。

技能如何工作

核心能力：通过 MCP 服务器为编码代理提供四项底层支持。

结构化代码导航：基于符号和调用关系跳转，而不是整文件灌入。代理可以先看函数签名、依赖边，再决定是否深入读体。
持久召回：把关键决策、路径、命令结果写入可回查的存储。下次会话问“上次为什么改 settings.json”，可以直接命中，而不是重新 git log。
紧凑命令输出：对测试、构建、lint 等高噪声命令做裁剪。例如 pytest 回显原本很长，这里只保留失败摘要、首个堆栈片段和退出码。
Token 感知的上下文重用：把项目结构、常用命令、约定等稳定信息缓存起来，跨任务复用，避免每个新问题都从头解释一遍。

关键步骤：在 MCP 兼容的编码代理中配置 Token Savior 服务器端点；允许其访问本地项目文件与可选的 shell/test 钩子；代理发起导航、召回或命令执行时，走 MCP 工具而非直接读文件或跑终端。

适用边界与注意点

需要 MCP 兼容的编码代理，纯 CLI 或无 MCP 支持的环境无法直接接入。
依赖 Python 环境与 token-savior-recall 包，pip 或 uv 任选其一。
可选的 shell/test 钩子必须显式配置，否则只享受导航和召回，无法获得输出裁剪。
测试正则已支持 python3 -m pytest、uv run pytest、venv 前缀、poetry/hatch/pdm/rye run pytest 等常见变体，但极特殊的调用方式仍可能匹配不到。
改动 settings.json 等文件时会先生成统一 diff 并备份，重复执行是幂等的，可安全回滚。