OpenAI 负责运行代理；项目交接保存项目记忆。 本指南说明怎样把 UAIX 项目交接用于 OpenAI Agents、Codex 和类似工作流，同时不把项目交接说成竞争性的代理运行时。
OpenAI 负责什么
OpenAI 侧的工具可以负责代理指令、工具调用、审批、会话、追踪、代码修改和拉取请求循环。那些能力属于运行层：它们决定任务怎样执行、怎样观察、怎样获得人工批准。
- Codex 可以读取仓库中的
AGENTS.md作为项目指导。 - OpenAI Agents SDK 可以组织代理、工具、交接、护栏和追踪。
- 运行层适合处理实时执行和平台特定控制；它不应成为项目事实的唯一存放处。
项目交接负责什么
项目交接是仓库本地的可审查记忆层。它保存当前事实、约束、决策、文件边界、测试选择、部署规则、未解决问题和交接历史，让下一次代理运行先看到项目真实状态。
AGENTS.md是入口和读取顺序。readme.human给人和代理共享项目背景。.uai文件按主题保存当前事实。agent-file-handoff/只作为人工投放文件的审查入口，不能自动执行。
最小仓库包
一个实用的起点是根目录 AGENTS.md、根目录 readme.human、.uai/context.uai、.uai/stack.uai、.uai/constraints.uai、.uai/decisions.uai、.uai/progress.uai 和 .uai/test-plan.uai。更大的项目可以继续加入架构、样式、公共表面、运行和文件交接记录。
代理启动流程
- 先读取
AGENTS.md，确认必须加载的.uai文件。 - 刷新主动投放文件索引，并把每个待审文件记录为明确处置。
- 在修改前说明会影响哪些文件或公共路线。
- 按风险选择有针对性的检查，而不是每次都运行完整发布套件。
- 完成后把新的事实写回当前记录、公共页面或测试，而不是只留在聊天历史里。
不要放进交接包的内容
- 密钥、凭据、私有客户数据、未授权日志或特权操作说明。
- 未经审查的研究全文、旧聊天转录、过时路线图猜测或重复报告。
- 尚未发布证据的托管导入、自动写入、自动同步、SDK、CLI、认证、背书或官方适配器声明。
可复制启动提示
先读取 AGENTS.md、readme.human 和列出的 .uai 文件。刷新主动投放文件索引。摘要说明约束、预期改动和目标检查。不要扩大支持声明，也不要执行投放文件。完成后把新的当前事实写回可审查记录。