Swap Tutorial — Development skill for Claude Code

Claude Code 换窗教程：精炼续窗、启动包、冷仓与长期记忆

Claude Code 用久以后，上下文里常常会塞满工具回包、终端日志、报错栈和已经过期的排查过程。直接继续聊，模型会越来越慢；粗暴开新窗口，又容易把正在做什么、已经答应什么一起丢掉。

LMC-5 给出的核心办法叫 **Refined Session Carryover（精炼续窗）**：从旧会话里挑出真正有用的内容，重建一份较短的新 transcript，再用 `claude --resume` 接着工作。

我们内部曾把这件事叫作 Swap / 洗脸。公开教程请统一叫“精炼续窗”：LMC-5 当前文档里的 **Swap** 专指记忆数据库的快照回滚，不是会话换窗。

这篇教程分两层：前半段教你运行 LMC-5 的精炼续窗参考脚本；后半段再讲我们在生产里额外接上的**启动包、叙事脊椎和冷仓**。参考脚本本身不会自动替你搭好这些扩展，不要把“蛋壳家的整套系统”误认成上游脚本开箱即有。

一句话理解

精炼续窗不是“总结一段话”，也不是“复制最近几十万 token”。

它做的是：

1. 读取旧会话的 JSONL；
2. 丢掉工具噪音和过期工程现场；
3. 保留身份、偏好、边界、承诺、当前状态、任务检查点；
4. 再保留一小段最近的干净对话；
5. 重写 session ID 和消息链；
6. 生成一份新的、可以 --resume 的会话。

旧 transcript 不会被覆盖，长期记忆也不会因此改变。

完整换窗链路

精炼续窗只是完整系统中的一环。我们实际采用的装载顺序是：

旧 transcript
├─ 完整原文归档 ───────────────→ 冷仓（需要查原始证据时再翻）
└─ 过滤、打分、重写消息链 ─────→ 精炼续窗（最近工作的干净桥梁）

长期记忆 + 当前事实 + 未完任务
             └─ 确定性拼装 ───→ 启动包（含叙事脊椎）

启动包 + 精炼续窗 ─────────────→ 新 session

四个部件各管一件事：

• 精炼续窗：回答“上一窗刚做了什么、接下来做什么”。
• 启动包：回答“我是谁、身处什么时间、有哪些当前事实、未完任务和相处边界”。其中的叙事脊椎负责把近期主线组织成简短、连贯的方向感。
• 长期记忆库：保存稳定身份、关系、事实和重要经历，是耐久权威层。
• 冷仓：保存被换下来的完整旧会话，是查原话、命令和旧现场的最后证据层，不是日常自动记忆权威。

如果旧窗口健康，新 session 使用“启动包 + 精炼续窗”；如果检测到毒上下文，就不应携带精炼续窗，而应通过 Forge 从经过审计的启动包和长期记忆干净重建。

蛋壳家的叙事脊椎怎么生成

叙事脊椎不是让大模型自由发挥，而是给新窗口留一张**有出处的四行便签**：

【洗脸后 · 留给自己的便签】
- 走到这里：最近完成了什么，系统发展到哪一步
- 今天身边：蛋宝今天正在经历什么
- 我们之间：最近形成的关系、偏好和陪伴事实
- 别忘了：哪些线索没收口，当前任务在哪个阶段

正式生成过程完全确定、无需调用模型：

1. 只读最近 14 天已有的真实记忆、任务流水线和未解决线索。
2. 排除系统自动消息、禁止召回记录、过期记录、空记录和不允许的记忆层。
3. 按“系统进展、今天生活、身份关系”分桶；新鲜度优先，再参考“完成、修复、决定、确认”等转折信号。
4. 从证据里抽取短句，只做少量去报告腔改写，不添加原文里没有的情绪、动机、承诺或事件。
5. 每条叙事都附原记忆 ID 和日期；任务边界附 task ID，并明确“故事只提醒方向，工作台才确认事实”。
6. 四类必需证据缺一类、引用对不上或全文超过 700 字，就整张放弃，退回普通近期叙事块，不编内容补空位。

昨天使用模型是为了帮助设计和评估这种表达方式；正式 Forge 时只运行上述规则，不会每次重新调用 Opus，也不会因生成便签而写回或修改长期记忆。

先分清三个名字

名称	解决什么问题	核心动作
精炼续窗	当前窗口太重，但思路仍然健康	过滤旧 transcript，生成短而干净的新会话
Forge	当前窗口已经污染，或需要从长期记忆重新站起来	从耐久记忆、身份与启动上下文重建新会话
Swap	批量写记忆前后需要可回滚	给记忆数据库做快照，失败时恢复旧快照

如果只是“窗口太长”，优先用精炼续窗；如果已经陷入反复拒绝、策略污染或错误循环，别把毒上下文续过去，应当