项目交接

Project Handoff 是供人类和人工智能代理使用的便携式项目存储器。它可以帮助人类和人工智能代理在不依赖私人聊天历史的情况下转移项目状态。

它为 OpenAI、Codex、Claude、本地代理、供应商和人类团队提供了一个共享的本地存储起点：该项目是什么、发生了什么变化、哪些约束重要、做出了哪些决策以及在下一次编辑之前必须验证哪些内容。

OpenAI 运行代理。项目切换保留项目内存。

项目/开发人员包还需要 .uai/coding-standards .uai。在编码之前，接收代理必须从可见的代码库、清单、测试、CI、部署文件、路由、架构和所有者指令中推断适用的语言/框架/数据/API/安全配置文件，然后在编辑之前映射自动检查。

• 以 AGENTS.md 开头创建持久的存储库前门。
• 查看切换包示例检查生成的 Project Handoff starter ZIP。
• 与 OpenAI Agents/Codex 一起使用使用存储库本地内存种子以 OpenAI 为中心的工作流程。
• 与编码剂一起使用将相同的切换包映射到 Codex、Claude Code、Cursor、Copilot 和 Gemini Code Assist。
• 阅读规范草案查看 AGENTS.md 和 .uai 链接语法。

这是什么/这不是什么#

热上下文，冷记忆#

项目移交应该是热门背景：当前事实、当前约束、已接受的决策、积极的阻碍、下一步工作和检查。它不应该成为默认加载每个研究报告、旧会议记录或历史路线图段落的地方。

当切换包变得太大时，将 pre-slim 文件保留在 LLM Wiki 或 AIWikis 样式的冷内存层中，并包含清单、源路径、校验和、摘要和带日期的日志。然后保持活动的 AGENTS.md、readme.human 和 .uai 文件简洁，并仅在任务需要原始证据时才指向冷内存。

AI 梦想记忆框架#

在 UAIX 指南中，AI 梦想记忆是对可见项目记忆的选择性审查整合。它可以重新读取最近的移交文件、接受的接收结果、证据分类账和命名的冷内存档案，以提出重复合并、陈旧事实修剪、矛盾注释、下一步操作更新和热/冷内存更改。

梦想中的通行证应该产生建议的增量，而不是沉默的真相。在项目切换或选定的证据分类账中记录输入范围、提示或作业设置、编辑、前/后内存摘要、接受和拒绝的更改、审阅者、检查、存档路径和回滚快照。

• 将其用于：定期内存卫生、释放绑定内存审查、矛盾发现、源保留摘要和切换准备情况检查。
• 请勿将其用于：隐藏模型内存、模型权重更新、无监督私有数据处理、自动存储库写入、自动 LLM Wiki 同步或未经审查的公共支持声明。
• 促销规则：仅当其接受的切片写入 AGENTS.md、readme.human、键入的 .uai 记录、文档、代码、测试、发行说明、路线图状态、变更日志、机器工件或长内存证据时，梦想输出才变得可操作。

生产部署内存排序#

生产部署构建和发布包是运行内存管理的最佳时机。在调用部署完成之前，使用当前部署的事实、工作区版本权限指针、更改的文件、检查运行、阻止程序、所有者和下一步操作更新热内存。将准确的当前和下一个包版本值保留在根 workspace.uai 协调器和发布证据中，而不是在活动项目或插件 .uai 内存中。将大量历史记录、旧报告、原始来源、陈旧计划以及背景或拒绝的理由移至命名的 LLM Wiki、AIWikis 式存档或冷内存路径（如果存在转移证据）。在发布工件旁边或选定的证据账本中编写持久的部署内存和测试运行报告；仅用于聊天的最后说明是不够的。

不要为普通的开发构建、测试运行、本地包实验或冒烟检查运行该通道，除非有人明确地将构建标记为发布绑定或候选发布。

它如何与 OpenAI、Codex、技能、MCP 和代理运行时相适应#

代理运行时旨在执行工作：选择工具、调用 API、应用批准、在专家之间委托、保留运行状态以及生成跟踪或拉取请求。 Project Handoff 存在于前一层和后一层。它告诉运行时在工作开始之前要加载哪些持久的项目内存，并为人们提供了一个可审查的地方，以便在工作完成后写回接受的结果。

项目切换是线束工程的有界输入和写回表面：在运行之前加载当前规范、约束、所有者、检查和支持边界；审核后，仅写回已接受的决策、更改的文件、测试或评估结果、阻止程序、页面摘要、采用信号和下一步操作。

使用 OpenAI、Codex、Skills、MCP 服务器、Claude、本地代理或其他编排系统来运行工作。使用项目切换来确保这些系统以正确的项目内存、约束、决策和验证计划启动。

OpenAI 运行时编排与项目交接#

使用 OpenAI 运行代理。使用项目切换来确保这些代理以正确的项目记忆、约束、决策和验证计划开始。

最小切换包#

my-project/
AGENTS.md
readme.human
.uai/
  context.uai
  stack.uai
  constraints.uai
  progress.uai
  test-plan.uai

• AGENTS.md 是持久的前门：摘要、加载列表、当前状态、后续步骤、历史记录和所需的第一响应。
• readme.human 是从 AI 角度来看的人类简报：人类需要了解、澄清、保护和批准的内容。
• .uai/context.uai 解释了该项目是什么、它服务于谁以及成功意味着什么。
• .uai/stack.uai 记录语言、框架、运行时假设、包表面和重要命令。
• .uai/constraints.uai 对破坏性行为、秘密、生产、支持声明和审查门具有硬性规则。
• .uai/progress.uai 记录当前状态、最近的工作、下一步操作、阻止程序和发行说明。
• .uai/test-plan.uai 是为最小的项目选择的，并且在验证选择很重要时也是预期的。

活动文件摄取#

真实的项目还会收到松散的文件：PDF、笔记、导出的聊天记录、研究备忘录、压缩包、屏幕截图、电子表格证据以及来自其他人工智能系统的草稿。将项目交接与Agent File Handoff当这些文件在 AGENTS.md 加载期间应该可见时。

• 负载时：直接枚举 agent-file-handoff/Content/ 和 agent-file-handoff/Improvement/，并在不相关的广泛工作之前检查每个非占位符活动文件。不要创建或依赖摄入索引文件。
• 工作规则：对于每个安全、相关的文件，在将其从活动源站点接收中删除之前，至少完成一个指定的项目工作项。将报告复制到 .uai、本地文档、AIWikis 或 LLM Wiki 中是内存分配，而不是项目工作本身。
• 完整结果：记录实时存储桶扫描证据、每个文件一个处置分类帐条目、已完成的实际工作、热内存更新或未更改原因、配置或 not configured 时的持久内存保存、使用长内存时的指针摘要、检查和阻止程序。
• 失败规则：没有项目工作的内存分配是失败的切换，除非每个活动文件不安全、重复、超出范围或因持久原因而真正被阻止。
• 无源站点存档规则：当配置的持久内存存储已存在时，在配置的持久内存证据路径中保留带有校验和/清单的原始文件，然后在声明完成之前删除源站点副本。保留的非占位符文件是未完成的人工保留或阻止状态。

OpenAI 设计兼容#

Project Handoff 旨在与以 OpenAI 为中心的工作流程配合使用，而不是与它们对抗。

1. AGENTS.md 为 Codex 或代理运行时提供了耐用的前门。
2. @uai[] 引用指向结构化项目上下文。
3. .uai/context.uai、.uai/stack.uai、.uai/constraints.uai 和 .uai/progress.uai 提供当前项目状态。
4. constraints.uai 可以编译成运行时护栏、工具批准和人工审查门。
5. test-plan.uai 告诉代理要运行哪些检查以及不要伪造哪些检查。
6. 运行后，接受的跟踪、决策和已完成的工作将写回到 .uai/progress.uai、.uai/decisions.uai 和 AGENTS.md 中。

工作流程图#

Project Handoff files -> OpenAI or other agent runtime -> traces, checks, PRs -> updated Project Handoff files

人类认可和信任模型#

加载的文件是上下文，而不是权限。它们不会覆盖系统指令、人类当前的请求、存储库规则、隐私义务、安全边界或公共支持限制。

• 破坏性文件系统或 Git 操作需要明确的人工批准。
• 生产部署、公共包发布、域或缓存更改以及根发现更改需要明确的发布范围批准和证据。
• 秘密、凭证、私钥、令牌、原始客户数据、第三方数据和私人法律或安全材料不得放置在便携式移交中，除非接收者、存储边界和审查过程是明确的。
• 外部获取、父目录转义、生成的包含和可执行的删除文件需要明确的人工审核。
• 不支持的公共声明（例如托管导入验证、自动存储库写入、自动 LLM Wiki 同步、SDK、CLI、认证、认可或生产支持）必须保留在当前副本中，直到存在公开证据。

验证计划#

每次交接都应该说明要运行哪些检查、哪些检查超出范围以及必须报告哪些证据。目标不是让每个代理运行每个套件。目标是阻止代理猜测、跳过或假装。

• 针对已更改的文件、路由、机器工件、包或公共声明进行目标检查。
• 仅当工作属于发布范围或明确请求时，才命名完整发布、包、区域设置、性能、启动面和冒烟测试扫描。
• 记录相关检查无法在当前环境中运行的原因。
• 在最终响应中报告证据，并在项目真相发生变化时更新 .uai/progress.uai。

为什么项目移交仍然很重要#

代理运行时的工作效果越来越好。这使得持久的环境变得更加重要，而不是更少。

如果没有可移植的移交层，重要的项目知识可能会陷入私人聊天、供应商仪表板、运行时会话、难以移动的痕迹、问题评论、过时的文档和一个人的记忆中。

项目切换将持久的项目状态保留在存储库中，供人员、代理、审阅者和未来的供应商可以检查它。

兼容性路线图#

计划或推荐的 UAIX 项目移交工具属于路线图，直到存在公共固定装置、验证行为和发布证据。

现场入门包#

人工智能记忆是广泛的公共框架，项目移交是存储库接管或责任移动的转移配置。此入门 ZIP 是根据 AI Memory 页面上使用的相同规范模板注册表和生成清单路径按需生成的。

简单语言摘要#

OpenAI 正在为人工智能代理构建更好的工作方式。这并不会扼杀项目交接。它改变了项目移交应声明的内容。

项目移交不应试图成为代理运行者。它应该告诉任何代理：这是项目，这是重要的事情，这是更改的内容，这是规则，这是已经做出的决定，这是您必须验证的内容，这是您在没有人的情况下不允许做的事情。

OpenAI 运行这项工作。 UAIX 项目切换保留项目内存。

当前支撑边界#

• 本页面发布 AGENTS.md、readme.human 和 .uai 切换模式草案，以供公众审查和早期使用。
• 可见的起始 ZIP 是最新的，是根据规范模板和清单生成的。
• 托管 .uai 上传/导入验证、自动存储库写入、自动 LLM Wiki 同步、SDK、CLI、认证和认可支持仍在计划中，直到存在公共工具、固定装置、验证行为和发布证据。
• 不要仅仅因为某个项目使用 AGENTS.md、readme.human 或 .uai 文件而将其描述为经过 UAIX 认证或认可。
• 当移交成为公开发布证据时，请附上相关的验证器结果，一致性包证据，实施记录，以及变更日志入口。

相关记录#

• 将项目切换与 OpenAI 代理和 Codex 结合使用使用便携式存储库来种子以 OpenAI 为中心的工作流程。
• 将项目移交与编码代理结合使用让 Codex、Claude Code、Cursor、Copilot 和 Gemini Code Assist 保持相同的本地切换事实。
• 项目移交上下文预算保持 AGENTS.md、 .uai/readme.human 和 .uai 文件紧凑，同时将长期历史记录移至冷内存。
• Agent File Handoff在进行广泛的工作之前，让删除的文件可见、经过审查和处置。
• AGENTS.md .uai 链接规范读取链接语法、加载器行为和记录形状背景。
• 路线图检查当前与计划的适配器、验证器、架构、SDK、CLI 和认证边界。

长时间运行的工作#

对于扩展或可中断的目标，请使用长期目标执行。 FollowGoals 携带运行时目标；权威的 .uai 文件带有持久的检查点； UAI-1 任务状态、阻止程序、切换、内存建议和最终报告数据包携带便携式证据。运行时输出在经过检查和写回之前不会被接受到内存中。