用途：在编码智能体工作过程中维护可持久化、人类可读的会话记录，便于其他智能体在断连后以最少上下文丢失继续工作。
主要能力：创建按时间戳命名的会话目录并维护四类文件：session_state.md（总体目标、当前子任务、已加载技能、状态、计划、假设、阻塞与下一步）、timeline.md（追加式记录主要操作、命令、结果与决策）、files.md（已检查、已修改及生成文件及其原因）、handoff.md（供下一个智能体恢复的简洁指令）。可按需增加 experiments.tsv、review_notes.md 等。
使用方式：每个工作会话创建一个目录，命令为 mkdir -p session、date +%Y%m%d_%H%M%S、mkdir -p session/<session_date_time>。开始时用 ls -dt session/* 2>/dev/null | head 检查已有会话；若为恢复工作则读取最新的 session_state.md、timeline.md 和 handoff.md。检查点写入时机包括：形成计划后、重大代码修改前后、长时间运行命令或切换分支前、用户改变方向时、最终回复前，以及长任务期间至少每 30 分钟一次，优先更新同一批文件。恢复流程为先读 handoff.md，再读 session_state.md 与近期 timeline.md，用 git status --short、git branch --show-current 等做轻量验证，并从最近验证过的下一步继续，同时追加恢复记录。
适用场景：用户要求保留、恢复、检查点或管理智能体记忆；工作可能跨越断连；即将做非平凡修改、运行长任务、切分支或暂停等待用户输入；在已有 session 目录的仓库中恢复工作。
限制与质量规则：笔记应简洁事实化，记录重要命令结果；不将笔记当作唯一事实来源，行动前需对照 git 状态、文件与命令输出验证；不存储密钥、令牌、私有凭据或大型日志；会话文件过大时应概括旧细节并保持 handoff.md 顶部为最新下一步。未提供安装方式与平台兼容范围。