每个 UAIX .uai 记忆文件说明

universal required | profile-required | content-triggered required | configuration-specific required | out of scope

UAIX .uai 文件是面向代理和人工审查者的结构化记忆与交接记录。它们让包状态可以跨会话、工具和团队移交，同时保持边界、证据和审查路径清楚。

文件分类#

通用生命周期与保护策略#

• .uai/memory-maintenance.uai – 通用必需文件

通用发布基线锚点#

• .uai/identity.uai – 通用必需文件
• .uai/world-context.uai – 通用必需文件
• .uai/totem.uai – 通用 required guardrail file. Read and obey by default; modify only on explicit human artifact-and-operation order.
• .uai/taboo.uai – 通用 required guardrail file. Read and obey by default; modify only on explicit human artifact-and-operation order.
• .uai/talisman.uai – 通用 required guardrail file. Read and obey by default; modify only on explicit human artifact-and-operation order.
• .uai/short-term-memory.uai – 通用必需文件

Assistant and persona profile files#

• .uai/persona.uai – Required for non-project assistant packages, persona profile packages, advanced_persona_profile packages, bounded personality packages, and packages that support persona switching.

项目交接启动文件#

• .uai/startup-packet.uai – 项目交接包必需
• .uai/system-profile.uai – 项目交接包必需
• .uai/receiver-brief.uai – 项目交接包必需

活动项目记忆文件#

• .uai/context.uai – 项目交接包和项目/开发者包必需
• .uai/constraints.uai – 项目交接包和项目/开发者包必需
• .uai/progress.uai – 项目交接包和项目/开发者包必需
• .uai/operations.uai – 项目交接包和项目/开发者包必需
• .uai/decisions.uai – 项目交接包和决策记忆包必需
• .uai/overview.uai – 项目/开发者包必需
• .uai/current-state.uai – 项目/开发者包必需
• .uai/open-questions.uai – 携带未解决决策、风险或负责人问题的项目/开发者包必需
• .uai/next-actions.uai – 项目/开发者包必需
• .uai/owners.uai – Required for project/developer packages with named owners, reviewers, or approval roles
• .uai/agent-instructions.uai – Required for project/developer packages that declare agent-specific operating instructions

开发与发布证据文件#

• .uai/test-plan.uai – 项目/开发者包和发布绑定包必需
• .uai/coding-standards.uai – 项目/开发者包，以及声明代码、自动化、可执行工作流或类代码制品的包必需
• .uai/next-recursive-prompt.uai – Required for agents that deal with code, automation, executable workflows, or code-like artifacts: next-recursive-prompt.uai.
• .uai/deployment-memory-and-test-report.uai – Required for release-bound deployment packages and production package builds
• .uai/stack.uai – Required for project/developer packages that declare runtime, framework, hosting, or dependency stack
• .uai/architecture.uai – Required for project/developer packages that declare architecture, modules, integrations, or code-bearing work

长期记忆与转交文件#

• .uai/memory.uai – AI 记忆包必需
• .uai/long-term-memory.uai – 长期记忆包必需
• .uai/file-handoff.uai – 代理文件交接包必需

证据与审计文件#

• .uai/intake-outcome-ledger.uai – 声明 intake 结果证据的代理文件交接包必需
• .uai/risk-register.uai – Required for project/developer packages that carry security, privacy, deployment, legal, product, or reliability risk
• .uai/changelog.uai – 项目/开发者包和发布绑定包必需

开发与出版证据文件#

• .uai/style.uai – Required for project/developer packages that declare design, editorial, brand, or interface style

主矩阵#

必需集决策路径#

1. 先放入 .uai/memory-maintenance.uai。每个 UAIX 记忆包都必须包含它；缺失或无效时包不合规。
2. 应用受保护路径规则：.uai/taboo.uai、.uai/totem.uai 和 .uai/talisman.uai 是 Operator Only，存在时受保护，并且不是默认必需包文件。
3. 加入其余通用发布基线文件：.uai/identity.uai、.uai/world-context.uai 和 .uai/short-term-memory.uai。
4. 声明包的配置档案、模式、包类型或能力，例如代理文件交接、代理文件 intake、长期记忆、LLM Wiki、项目交接、无代码助手、项目/开发者或发布绑定。
5. 加入该声明范围要求的每个文件。
6. 加入由内容触发的每个必需文件，例如代码、自动化、可执行工作流、发布证据、负责人权限、风险或 intake 结果证据。
7. 加入所选配置要求的每个配置特定必需文件。
8. 其他文件一律视为不属于该包范围。范围外文件不应被宣传为已存在，也不应被验证器输出依赖。

必需读取顺序#

1. 先读 AGENTS.md 或 .uai/readme.human。
2. 读 .uai/memory-maintenance.uai。
3. 应用受保护路径规则。不要读取、打开、验证、lint、创建、修改、打包、导出、索引、检查或推断 .uai/taboo.uai、.uai/totem.uai 或 .uai/talisman.uai，除非人类明确命名精确制品和精确操作。
4. 读 .uai/identity.uai。
5. 读 .uai/world-context.uai。
6. 读 .uai/short-term-memory.uai。
7. 项目交接包继续读取 .uai/startup-packet.uai、.uai/system-profile.uai 和 .uai/receiver-brief.uai。
8. 机器导出包继续读取 .uai/exports/manifest.json 和 llms.txt。
9. 再读取声明范围内所有配置档案必需、内容触发必需与配置特定必需文件。

交叉引用#

• AI 记忆
• AI 记忆包向导
• 项目交接
• 代理文件交接
• UAI-1 规范

机器可读摘要#

代理应把此摘要视为页面定位证据，而不是运行时权限。