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

每次 AI 长会话快结束你是不是也会担心“这次聊了这么多下次还能接着干吗”真正容易丢掉的不只是上下文还有踩过的坑、验证过的方法。用这套「AI 长会话收尾三件套」把进度、反思和经验分开保存让 AI 越用越顺手。1. HANDOFF.md只交接“项目现在在哪”适用跨天任务、复杂项目、准备换会话或换人继续时。它不是项目日志也不是把整个聊天记录复制进去只写让新会话能立刻接手的信息任务目标最终要做成什么。当前状态已经完成、正在做、尚未做。关键文件/命令文件在哪、怎么运行、重要配置是什么。当前问题卡点、报错、待确认事项。下一步按优先级列出 13 个可执行动作。已踩的坑只保留会导致重复返工的关键问题。注意不要写密码、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再复述理解用户确认后执行生成内容忽略已有格式约束先提取硬性要求输出前逐项自检调试问题未验证就直接改代码先定位根因再修复用复现步骤验证最终顺序可以记成一句话HANDOFF 保存进度反思定位原因经验记录沉淀规则长期高频规则再写进项目规范或开场提示词。