一个很实用的 AI 长会话收尾三件套|codex、claude都适用

每次 AI 长会话快结束，你是不是也会担心：“这次聊了这么多，下次还能接着干吗？”

真正容易丢掉的，不只是上下文，还有踩过的坑、验证过的方法。
用这套「AI 长会话收尾三件套」，把进度、反思和经验分开保存，让 AI 越用越顺手。

1. HANDOFF.md：只交接“项目现在在哪”

适用：跨天任务、复杂项目、准备换会话或换人继续时。

它不是项目日志，也不是把整个聊天记录复制进去；只写让新会话能立刻接手的信息：

• 任务目标：最终要做成什么。
• 当前状态：已经完成、正在做、尚未做。
• 关键文件/命令：文件在哪、怎么运行、重要配置是什么。
• 当前问题：卡点、报错、待确认事项。
• 下一步：按优先级列出 1～3 个可执行动作。
• 已踩的坑：只保留会导致重复返工的关键问题。
• 注意：不要写密码、Token、隐私数据或完整密钥。

可直接输入：

这个会话即将结束。请创建或更新 HANDOFF.md，写给一个完全不了解背景的新会话。 请包含： 1. 任务目标 2. 当前进度（已完成 / 进行中 / 未开始） 3. 关键文件、运行命令与配置 4. 当前问题或阻塞点 5. 下一步计划（按优先级列出） 6. 已踩过的坑与避免方式 要求：简洁、可执行、不复制聊天记录；不要记录密码、Token 或隐私信息。

下次开新会话时：

请先读取 HANDOFF.md，先用 5 条以内总结你理解到的项目状态；确认后，再继续推进下一步。

这里多加“先总结再继续”，能避免 AI 读了文件却理解偏题。

2. 反思机制：把“被纠正”变成规则

原思路正确，但“信息不足 / 判断逻辑有问题”两类不够用。实际常见原因还包括：

• 需求表达有歧义；
• AI 忽略了已有约束；
• 技术知识、工具或环境限制；
• 执行时验证不足；
• 用户临时改变了目标。

适用：出现返工、反复纠正、结果明显不符合预期时。
不必每次小修改都做，否则反思会变成额外负担。

推荐提示词：

请回顾这次协作中我纠正过、否定过或要求重做的内容。 用表格输出： 1. 修改内容 2. 原先做法 3. 为什么不符合要求 4. 错误归因（信息不足 / 需求歧义 / 忽略约束 / 判断逻辑问题 / 工具或环境限制 / 验证不足） 5. 下次开始前应补充的指令或检查项 6. 是否值得沉淀为长期经验 要求：不要泛泛而谈；只记录真实发生过的纠正，不要把正常迭代误判为错误。

它的价值不只是“复盘 AI”，也是帮助你发现：下次提示词里究竟该补什么约束。

3. 经验记录 / 错题本：保存“以后会复用的规律”

核心正确，但建议把经验写进实际文件，例如：

PROJECT_LEARNINGS.md

或：

docs/lessons-learned.md

因为“系统记忆”不一定跨项目、跨账号或跨会话稳定保留；文件才是可控、可检查、可迁移的长期资产。

只收录以下内容：

• 高频踩坑；
• 被验证有效的工作流程；
• 可复用提示词模板；
• 审查清单；
• 项目特定的技术约束。

不收录：

• 一次性的琐碎修改；
• 已过期的信息；
• 密码、Token、个人隐私；
• 已在固定规范中完整覆盖、且没有新增价值的重复内容。

推荐提示词：

请把本次协作中可长期复用的纠错经验和有效方法更新到 PROJECT_LEARNINGS.md。 规则： - 只记录已验证有效、未来可能复用的内容； - 如果已有相似条目，更新旧条目，不重复创建； - 每条包含：触发场景、错误或经验、正确做法、检查方法； - 已经被完整写入项目规范或提示词模板的内容，不重复抄写，只在需要时链接或注明来源； - 不记录密码、Token、隐私信息和一次性琐事。

推荐结构：

最终顺序可以记成一句话：

HANDOFF 保存进度，反思定位原因，经验记录沉淀规则，长期高频规则再写进项目规范或开场提示词。