用途:记录当前工作会话的持久、人类可读状态,使另一智能体在断线后以最小上下文丢失继续工作。
主要能力:在 session/ 下按时间戳创建会话目录,维护四类文件:session_state.md(总体目标、当前子任务、加载技能、状态、计划、假设、阻塞与下一步)、timeline.md(追加式记录操作、命令、结果与决策)、files.md(检查、修改与生成的文件及原因)、handoff.md(给下一智能体的简洁续接说明)。可另加 experiments.tsv、review_notes.md 等。
使用方式:创建目录:mkdir -p session;查看最新会话:ls -dt session/* 2>/dev/null | head。开始时检查已有会话,恢复时读最新相关 session_state.md、timeline.md、handoff.md;无则新建带时间戳目录并写初始状态。在形成计划后、重大编辑前后、长任务/切分支/硬重建内容前、用户改方向时、最终回复前,以及长时工作中至少每 30 分钟写检查点。优先更新同一组文件而非碎片化创建。恢复时先读 handoff.md,再读 session_state.md 与近期 timeline,运行 git status --short、git branch --show-current 等轻量校验,再追加恢复记录。
限制与质量规则:不把会话记录当唯一事实来源,重要结论需对照 git 状态、文件与命令输出验证。记录简洁事实而非聊天全文,记录关键命令结果(尤其失败测试或跳过验证)、未提交改动及其来源。不存密钥、令牌、凭据或大日志。文件过大时总结旧细节,将最新下一步置顶。
适用场景:用户要求保存、恢复、检查点或管理智能体记忆;长时、实验性或易跨断线的任务;即将做重大编辑、运行长任务、切分支或等待用户输入;或进入已有 ./session/ 目录的仓库继续工作。