项目移交应保持足够小以便加载，并且足够精确以值得信任。当 AGENTS.md、readme.human 或 .uai 文件开始吸收旧研究、聊天历史记录、SEO 报告、审计、路线图详细信息或预精简快照时，请使用本指南。
UAIX、LlmWikis 和 AIWikis 的教训很简单：热门上下文应该承载当前的操作真相；冷记忆应该保存长期记录。当切换包试图同时成为启动数据包和整个机构档案时，它就会失败。
这解决了什么问题
- 新代理在看到当前限制之前会花费启动代币来阅读旧背景。
- 旧的支持声明、路线图猜测和被取代的决策与当前事实并存，没有晋升规则。
- 大型报告被复制到
AGENTS.md或.uai/progress.uai中，因为没有命名冷内存主目录。 - 团队删除或覆盖没有清单、校验和、源摘要或恢复路径的大量注释。
此页面适合谁
- 使用的存储库的维护者项目交接.
- 团队配对紧凑人工智能记忆数据包带有LLM 维基、AIWikis 风格的存档，或内部研究 wiki。
- 人工智能代理要求在不丢失来源的情况下精简移交文件。
- 审阅者检查公开声明是否来自当前的来源状态或旧的背景说明。
热上下文与冷记忆
| 层 | 默认加载？ | 属于这里 | 不属于这里 |
|---|---|---|---|
| 热点项目交接 | 是的 | AGENTS.md、readme.human、当前 .uai 上下文、约束、堆栈、公共表面、决策、进度、操作、测试计划、文件摄入和样式。 |
完整的研究报告、旧的聊天记录、之前的路线图段落、原始审计、过时的实施想法或精简前的快照。 |
| 温馨参考 | 仅当任务需要时 | 当前规范文档、公共页面、变更日志、路线图、发行说明、重点源摘要和注明日期的报告页面。 | 未经审查的已删除文件或旧的原始注释被视为活动指令。 |
| 冷记忆 | 不 | LLM Wiki 页面、AIWikis 原始档案、传输清单、校验和记录、源摘要、被拒绝的想法、旧快照和长源跟踪。 | 主张应在不进行审查和升级的情况下管理当前的工作。 |
上下文预算循环
- 检测堆积：查找比当前操作更多地解释旧历史记录的启动文件，或者使新代理在命名约束之前读取大量报告的文件。
- 瘦身前截图：将 pre-slim 文件复制到冷内存中并记录源路径、最终路径、SHA-256 哈希、参与者、时间戳、摘要和处置。
- 总结一下冷记录：创建源摘要、概念节点、日志条目、分类帐注释或等效索引，以便未来的维护人员可以找到原始源，而无需默认加载它。
- 精简热门文件：保留当前事实、主动决策、已知阻碍因素、下一步检查以及指向冷内存位置的简洁指针。
- 刻意宣传：当存档的事实再次变为最新时，请在活动的
.uai、文档、代码、测试、发行说明、路线图状态或机器工件中重述它。 - 验证拆分：运行本地切换 lint、空格检查以及冷内存端所需的任何 wiki/archive lint。
热门文件中应保留哪些内容
AGENTS.md：前门指令、负载列表、当前状态、所需的第一响应、硬红线和简短的代理历史记录。readme.human：面向人的简报，人工智能需要人们澄清什么，以及人工智能将捍卫什么。.uai/context.uai：目的、当前公开真相、受众和成功标准。.uai/constraints.uai：红线、支持声明边界、秘密政策和破坏性操作限制。.uai/progress.uai：最近完成的工作、当前焦点、阻碍因素、下一步工作和完成标准。.uai/decisions.uai：具有效果和边界的持久决策，而不是所有导致该结果的讨论。.uai/test-plan.uai：有针对性的检查、全面扫描触发器和最终检查报告期望。
什么可以转移到冷记忆中
- 长篇研究报告、供应商比较研究、旧提案草案、广泛的 SEO 审核、探索性路线图和过时的实施叙述。
AGENTS.md、readme.human和.uai记录的预精简快照。- 处理和捕获有用信息后的原始摄入文件。
- 被拒绝的选项、被取代的建议、历史理由和仅需要出处的源措辞。
促销规则
冷记忆是可恢复的来源，而不是活跃的项目真相。仅当事实被审查并提升到指定的当前表面时，它才会成为当前事实：AGENTS.md、readme.human、.uai 记录、规范文档、公共页面、代码、测试、发行说明、路线图状态、变更日志条目、验证器证据或机器工件。
可复制的 AGENTS.md 上下文预算块
## 上下文预算
Keep startup context concise. AGENTS.md, .uai/readme.human, and loaded .uai files carry current operating truth only.
Move long research, old progress detail, raw audits, proposal history, and pre-slim snapshots into cold memory before slimming active files.
Every cold-memory transfer should record source path, final path, sha256, actor, timestamp, summary, and disposition. 冷记忆 memory is provenance, not active project truth, until a fact is reviewed and promoted back into current files, docs, code, tests, release notes, roadmap state, or machine artifacts.维护清单
- 新的 AI 能否在不打开原始档案的情况下用 3-5 个要点解释该项目？
- 热点文件是否命名当前约束、当前公共路线、下一步检查、阻止者和支持边界？
- 每个冷内存指针是否都包含足够的来源来恢复原始源？
- 公开声明是否得到当前 UAIX 页面、机器工件、验证器行为、发行说明、路线图状态或实施证据的支持？
- 入门包、清单、可见样本和公共页面仍然一致吗？
- 最终响应是否指定了运行的检查和故意跳过的发布/包检查？
要避免什么
- 如果没有清单或等效的转移证据，请勿删除旧的转移历史记录。
- 不要让
AGENTS.md成为研究档案。 - 默认情况下，请勿将 LLM Wiki、AIWikis、原始报告或旧聊天视为主动支持证据。
- 不要仅从该模式中声明自动 LLM Wiki 同步、托管导入验证、存储库写入、SDK、CLI、认证、认可或官方适配器。
- 请勿将机密、凭证、私人客户数据、隐藏提示或未经审查的生产日志放入便携式存储器中。
UAIX 如何对此进行测试
UAIX 在本地使用相同的分割。例行代理加载热项目切换包。大量的 UAIX 研究、提案历史、路线图背景和预精简交接快照都存在于 AIWikis 冷内存中，并带有转移证据。 LlmWikis 在其手册上下文中使用了相同的教训，而 UAIX.org 仍然是 UAI-1 和公众支持声明的规范权威。
相关 UAIX 记录
- 项目交接创建 AGENTS.md、 .uai/readme.human 和 .uai 启动包。
- 人工智能记忆对可接受的项目环境使用紧凑的工作包。
- 将 UAI 包与 LLM Wiki 一起使用将紧凑的数据包与深度内存配对，而不会使维基注释自动成为事实。
- 代理文件交接在删除的文件成为存档或冷内存之前对其进行摘要。
- OpenAI / Codex 指南将运行时跟踪与持久项目内存分开。
- 编码剂指南将许多工具集中在一个紧凑的包中。
- 路线图检查当前与计划的自动化和支持边界。
- 变更日志遵循已注明日期的公共变更轨迹。
- 报告使用带日期的报告页面作为背景，而不是自动当前支持。
- AGENTS.md .uai 链接规范更深入的链接语法和记录形状背景。
长期运行的分支
长时间运行的分支、重试、广泛的研究和被拒绝的路径都属于冷记忆，除非经过选择和审查。使用长期目标执行当热内存必须保留当前状态、阻止程序、检查以及跨中断时准确的下一个操作时。
分层目标记忆
分层目标记忆通过将已接受的子目标折叠到源链接记录中，同时在冷内存或档案中保留原始证据，来保持热点上下文较小。