项目交接应该小到能启动、准到可信任。 当 AGENTS.md、readme.human 或 .uai 文件开始吞进旧研究、聊天历史、审计报告、路线图细节或预精简快照时，请用这页重新分层。
UAIX、LLM Wiki 和 AIWikis 的经验很简单：热上下文保存当前操作真相；冷记忆保存长期记录。一个交接包如果同时想做启动包和完整机构档案，就会变慢、变旧、变难审查。
解决的问题
- 新代理在看到当前约束前，先耗费大量上下文读取旧背景。
- 过时支持声明、路线图猜测和已替代决定与当前事实混在一起。
- 大型报告被复制进
AGENTS.md或.uai/progress.uai，因为没有命名冷记忆位置。 - 团队删除或覆盖大块资料，却没有清单、校验和、来源摘要或恢复路径。
热上下文放什么
| 位置 | 内容 |
|---|---|
AGENTS.md |
入口、读取顺序、当前状态、硬约束和任务相关的即时指令。 |
readme.human |
人和代理都需要的项目介绍、运行方式和维护路径。 |
.uai 文件 |
当前上下文、架构、约束、决策、进度、操作、测试计划、公共表面和文件交接状态。 |
| 公共页面或机器资产 | 已经审查并适合发布的规范、工具、路线图、变更日志和发现文件。 |
冷记忆放什么
- 长篇研究、历史提案、旧审计、旧交接快照和需要保留但不应每次启动都读取的材料。
- 原始来源、编译节点、概念节点、转移日志、校验和清单和恢复说明。
- 只有在当前工作明确需要原文或旧来源时，才从冷记忆取回并重新审查。
维护循环
- 启动时只加载当前交接包和任务需要的文件。
- 发现大块历史材料时，先复制到冷记忆并记录校验和。
- 在热上下文中留下简短摘要、稳定指针、当前结论和恢复路径。
- 如果旧资料再次变成当前事实，把它审查后提升回公共页面、测试、代码或
.uai当前记录。 - 每次发布或交接后，删除重复叙述，保留可执行的当前真相。
不要这样做
- 不要把整个聊天记录、原始报告或未审查 Wiki 内容塞进启动文件。
- 不要把冷记忆副本当成当前支持证据。
- 不要用自动同步、后台服务或计划任务替代人工审查和明确处置。
- 不要在没有公开证据前扩大托管导入、自动写入、SDK、CLI、认证、背书或官方适配器声明。
相关记录
- 项目交接定义热上下文的仓库本地形状。
- AI 记忆解释可携带项目上下文的总体概念。
- 报告保存公开分析和长期背景入口。
- 指南返回其他采用指南。
- AGENTS.md 与 .uai 指南说明入口和链接文件的结构。
- OpenAI 与 Codex 指南说明运行层与记忆层怎样分工。
- 编程代理指南说明多个工具怎样共享同一个交接包。