一个交接包可以服务多种代理表面。 UAIX 项目交接把持久项目记忆放在仓库本地文件中，让 Codex、其他编程代理、本地工具、供应商和人工协作者在开始工作前读取同一份当前状态。
当前支持边界
- 当前支持的是本地仓库记忆模式：
AGENTS.md、根目录readme.human、类型化.uai记录，以及可选的agent-file-handoff/投放文件夹。 - 工具专用指针文件可以指向这套包，但应该保持很薄，不能复制政策、路线图状态或项目事实。
- 这些映射是兼容使用模式，不是官方适配器、认证集成、SDK、CLI、托管导入验证、自动仓库写入或背书声明。
- 代理运行时可以执行任务、请求批准、调用工具或产生追踪；项目交接保存项目记忆和审查边界。
工具映射
| 表面 | 建议做法 | 不要做什么 |
|---|---|---|
Codex |
使用根目录 AGENTS.md 作为入口，并加载列出的 .uai 文件。 |
不要把一次聊天里的临时判断当作项目事实。 |
Claude Code、Cursor、GitHub Copilot、Gemini Code Assist |
使用很薄的工具指针文件，把读者带回 AGENTS.md、readme.human 和 .uai 记录。 |
不要在多个工具文件中复制不同版本的规则。 |
| 本地代理或供应商流程 | 在启动脚本或运行说明中读取同一个交接包，并把完成后的事实写回可审查记录。 | 不要把项目交接变成后台守护进程、队列、调度器或总线。 |
在仓库中采用
- 把
AGENTS.md放在根目录，并声明它是入口文件。 - 把当前事实拆到小而有类型的
.uai文件中。 - 把工具专用文件写成重定向指针，不复制完整规则。
- 把人类或其他系统投放的文件放进主动审查文件夹，并为每个文件记录处置。
- 用有针对性的本地检查验证改动，再把新的当前事实写回交接包或公共记录。
薄指针示例
先读取根目录 AGENTS.md。然后读取 readme.human 和其中列出的所有 @uai[] 文件。此文件只是指针，不是第二个事实来源。相关记录
- 项目交接定义仓库本地记忆包。
- AGENTS.md 与 .uai 指南定义入口和链接规则。
- 代理文件交接定义投放文件审查流程。
- OpenAI 与 Codex 指南说明 OpenAI 工作流怎样读取同一个交接包。
- AI 记忆说明更宽的可携带上下文模式。