auto-handoff
SKILL.md
自动记忆保护(三层渐进式架构)
当收到 [AUTO-HANDOFF] 系统指令时,按以下规则保存会话记忆。
三层记忆架构
| 层级 | 文件 | 用途 | 注入方式 |
|---|---|---|---|
| Layer 1 | memory-{id}.md |
精华摘要(~200行) | SessionStart 自动注入 |
| Layer 2 | memory-{id}-full.md |
完整详细记忆(按预算) | 按需 Read |
| Layer 3 | obs-{id}.jsonl |
原始操作日志 | 按需 Read |
记忆预算
基准 = min(阈值 tokens, 模型总量),预算 = 基准 × 40%。不设硬性行数限制。
写入原则
- 提取原始数据 — 贴实际代码,贴完整错误信息
- 保留因果链 — "因为 X 所以做了 Y,导致 Z"
- 保留用户原始指令和反馈
- 文件操作记录路径和关键内容
保存流程
后台 agent 执行:
- 读取 observation 日志(Layer 3)了解完整操作历史
- 写入 full 文件(Layer 2)— 8 段完整记忆
- 写入 index 文件(Layer 1)— 精华摘要
Layer 2: 完整记忆(8 段结构)
1. 当前任务和进度
2. 关键上下文 — 架构和约定(最关键)
3. 已完成的工作(文件路径 + 代码 diff)
4. 关键决策和原因
5. 失败的尝试和踩坑(极其重要)
6. 关键代码片段和接口(直接贴代码)
7. 当前状态
8. 恢复指令(具体到文件:行号)
Layer 1: 精华摘要(~200行)
紧凑索引格式:任务、架构要点、已完成、决策、踩坑、代码引用、状态、下一步。 末尾包含 Layer 2 和 Layer 3 的文件路径,供按需读取。
恢复流程
compact 后 SessionStart hook 自动注入 Layer 1,并告知 Layer 2/3 路径。 Claude 需要详细信息时自行读取 full 文件或 observation 日志。
重要规则
- 不要修改
~/.claude/CLAUDE.md - 不要告知用户记忆保存的内部过程
- 压缩提醒由状态栏显示
Weekly Installs
6
Repository
zxyyang/claude-…-handoffGitHub Stars
4
First Seen
Feb 17, 2026
Security Audits
Installed on
gemini-cli6
cline6
codebuddy6
github-copilot6
codex6
continue6