技能介绍

要解决的问题

Agent 会话一长，两类成本同时上涨：要么把同样的问答反复喂给模型，要么撞上上下文上限后历史被静默截断。即便愿意缓存，也常遇到三种失败——存了找不到、找到了不敢用、用过已过时；此外 API key、token 常随原文直接落盘，形成泄露面。这个技能处理的是「可回忆的历史」这层横切基础设施，不替模型作答。

核心能力

五层结构：L1 滑动窗口保留最近 N 轮全文，L2 结构化原文，L3 抽取式摘要，L4 本地哈希向量，L5 上下文压缩与预算。条目滑出窗口时降级写入下层，而不是丢弃。

确定性写入逻辑（scripts/cache_ops.py）：

提问归一化后取 SHA-256 前 16 位作 cache_key，已存在只更新 hit_count 与 last_accessed；
SECRET_PATTERN 命中密钥模式即替换为 ***REDACTED***，命中过多（默认 ≥3）跳过缓存；
按意图 L2 查差异化 TTL 表，I11/I12/I17-I20/M01-M04 一律不缓存；
复用策略分档：I01-I02 直接复用，I03-I10 参考注入并标注「历史缓存，请核实」。

触发方式：下游 skill 作答完由 cache-hook 触发 CACHE_WRITE；用户显式请求分别激活 CACHE_LOOKUP、CACHE_INIT、CACHE_ADMIN、CONTEXT_COMPACT。tri-coding/tri-fix 改文件后，相关编码类缓存被标记 status=stale，检索时提示可能过时。向量计算全部本地完成，零 token 开销。

适用边界

意图识别归 tri-intent，本技能只消费快照 §三的元数据；缺少上游时进入降级模式，退化为纯内存滑动窗口，无元数据、不持久化，精度下降会在输出中显式声明。
编码与调试类意图（I11/I12）不缓存，文件随时可能变更，复用旧答案比没有答案更危险。
版本检查是第零步硬门：state=A/B/C/D 才放行，BLOCK 拒绝执行，判定全部交给脚本，prompt 层不做版本推断。
压缩只做抽取式摘要并写五段式检查点，绝不发明内容；仍超预算则报错，不静默截断。