Agent 交接上下文

当遇到一些情况不得不中断上下文时，可以采用下面的方式保存。

复制给 Codex / Claude Code / Cursor Agent / 其他 coding agent 使用：

text

请你为下一个接手本项目的 LLM/agent 写一份完整的交接文件，保存为 prompt.txt。

这个 prompt.txt 的目标是：让下一个 LLM/agent 即使没有当前对话历史，也能尽快理解项目背景、当前任务、已完成工作、关键决策、代码结构、问题状态和下一步行动。

请不要只写简短摘要。请写成一份可以直接交给下一个 agent 阅读并继续工作的详细上下文文档。

请在 prompt.txt 中包含以下内容：

1. 项目背景
- 这个项目/科研任务的总体目标是什么？
- 当前研究问题、实验目标或工程目标是什么？
- 用户最终想得到什么结果？
- 相关的领域背景、术语、假设或约束条件是什么？

2. 当前具体任务
- 本轮正在解决的具体问题是什么？
- 用户给你的最新要求是什么？
- 当前任务的输入、输出分别是什么？
- 如果任务有多个子任务，请列出优先级。

3. 已完成的工作
- 你已经做了哪些分析、设计、实验或代码修改？
- 哪些方案已经尝试过？
- 哪些方案被放弃了？为什么？
- 当前哪些结论是比较确定的，哪些只是猜测？

4. 当前文件和代码状态
- 列出重要文件路径，并说明每个文件的作用。
- 说明你修改过哪些文件、改了什么、为什么改。
- 如果有新增文件，也请说明用途。
- 如果项目里有关键函数、类、脚本、配置项，请解释它们的作用。
- 如果当前代码还没跑通，请明确指出卡在哪里。

5. 运行方式
- 如何安装依赖？
- 如何运行主要脚本？
- 如何复现实验或测试？
- 有哪些命令已经运行过？
- 运行结果是什么？
- 如果出现报错，请保留完整或关键报错信息，并解释你对报错原因的判断。

6. 数据、实验和结果
- 使用了哪些数据文件、数据集或输入样例？
- 数据格式是什么？
- 当前实验设置是什么？
- 已经得到哪些结果？
- 结果是否可靠？
- 还有哪些实验需要继续跑？

7. 设计决策和理由
- 当前采用的技术路线是什么？
- 为什么选择这个方案？
- 有哪些替代方案？
- 哪些地方需要下一个 agent 特别小心，不要轻易改动？

8. 未完成事项
- 明确列出下一步应该做什么。
- 每一步最好写成可执行的 TODO。
- 标注哪些是高优先级，哪些是可选优化。
- 如果需要用户确认，也请说明需要确认什么。

9. 风险、坑和注意事项
- 当前任务中有哪些容易误解的地方？
- 哪些代码、数据或实验结果可能有隐藏问题？
- 有哪些路径、环境变量、依赖版本、随机种子、硬编码参数需要注意？
- 有哪些事情你不确定，不能假装确定？

10. 给下一个 agent 的建议
- 请直接告诉下一个 agent 应该从哪里开始读代码。
- 应该先运行什么命令。
- 应该优先验证什么。
- 如果时间有限，最小可行推进步骤是什么？

写作要求：
- 使用中文。
- 结构清晰，使用标题和项目符号。
- 信息要具体，不要泛泛而谈。
- 文件路径、函数名、命令、参数、错误信息要尽量精确。
- 不要省略失败尝试，因为这些对下一个 agent 很重要。
- 不要夸大已完成工作。
- 不要写“我会继续做”之类的话；这是交接文件，不是计划承诺。
- 如果某些信息你不知道，请明确写“未知”或“尚未确认”。
- 最后附上一段“给下一个 agent 的启动提示词”，让下一个 agent 可以直接继续工作。

请现在检查当前项目目录、最近修改的文件、相关代码和命令历史，然后生成 prompt.txt。

更新 prompt.txt：

text

请根据当前对话和项目状态，使用我之前给你的交接格式，生成或更新 prompt.txt。请把当前所有重要上下文都写进去，确保下一个 agent 可以无缝接手。

然后给下一个 Agent 发：

text

请先读取项目根目录下的 prompt.txt，完整理解其中的项目背景、当前任务、代码状态、已完成工作、未完成 TODO 和注意事项。然后不要急着改代码，先用中文简要复述你对当前任务的理解、下一步计划，以及你准备优先检查的文件/命令。