UAIX .uai 文件是面向代理和人工审查者的结构化记忆与交接记录。它们让包状态可以跨会话、工具和团队移交，同时保持边界、证据和审查路径清楚。
封闭必需文件集规则：每个 UAIX 包文件只能处于通用必需、配置档案必需、内容触发必需、配置特定必需，或不属于该包范围这几种状态。UAIX 不使用会让代理跳过材料的柔性文件状态词。
文件分类
通用生命周期与保护策略
.uai/memory-maintenance.uai- 通用必需文件
通用发布基线锚点
.uai/identity.uai- 通用必需文件.uai/world-context.uai- 通用必需文件.uai/totem.uai- 通用必需的防护锚点文件。默认必须读取并遵守；仅在人工明确指定构件和操作时修改。.uai/taboo.uai- 通用必需的防护锚点文件。默认必须读取并遵守；仅在人工明确指定构件和操作时修改。.uai/talisman.uai- 通用必需的防护锚点文件。默认必须读取并遵守；仅在人工明确指定构件和操作时修改。
助手与角色配置文件
.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/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.reports/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/archives/changelog.uai- 项目/开发者包和发布绑定包必需
开发与出版证据文件
.uai/style.uai- Required for project/developer packages that declare design, editorial, brand, or interface style
主矩阵
| 文件 | 类别 | 必需状态 | 主要读者 | 更新频率 | 人工审查 | 详情页 |
|---|---|---|---|---|---|---|
.uai/memory-maintenance.uai | 通用生命周期与保护策略 | 通用必需文件 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | memory-maintenance.uai |
.uai/identity.uai | 通用发布基线锚点 | 通用必需文件 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | identity.uai |
.uai/world-context.uai | 通用发布基线锚点 | 通用必需文件 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | world-context.uai |
.uai/totem.uai | 通用发布基线锚点 | 通用必需的防护锚点文件。默认必须读取并遵守；仅在人工明确指定构件和操作时修改。 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | totem.uai |
.uai/taboo.uai | 通用发布基线锚点 | 通用必需的防护锚点文件。默认必须读取并遵守；仅在人工明确指定构件和操作时修改。 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | taboo.uai |
.uai/talisman.uai | 通用发布基线锚点 | 通用必需的防护锚点文件。默认必须读取并遵守；仅在人工明确指定构件和操作时修改。 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | talisman.uai |
.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. | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | persona.uai |
.uai/startup-packet.uai | 项目交接启动文件 | 项目交接包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | startup-packet.uai |
.uai/system-profile.uai | 项目交接启动文件 | 项目交接包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | system-profile.uai |
.uai/receiver-brief.uai | 项目交接启动文件 | 项目交接包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | receiver-brief.uai |
.uai/context.uai | 活动项目记忆文件 | 项目交接包和项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | context.uai |
.uai/constraints.uai | 活动项目记忆文件 | 项目交接包和项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | constraints.uai |
.uai/progress.uai | 活动项目记忆文件 | 项目交接包和项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | progress.uai |
.uai/operations.uai | 活动项目记忆文件 | 项目交接包和项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | operations.uai |
.uai/test-plan.uai | 开发与发布证据文件 | 项目/开发者包和发布绑定包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | test-plan.uai |
.uai/coding-standards.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. | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | next-recursive-prompt.uai |
.uai/decisions.uai | 活动项目记忆文件 | 项目交接包和决策记忆包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | decisions.uai |
.uai/memory.uai | 长期记忆与转交文件 | AI 记忆包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | memory.uai |
.uai/long-term-memory.uai | 长期记忆与转交文件 | 长期记忆包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | long-term-memory.uai |
.uai/file-handoff.uai | 长期记忆与转交文件 | 代理文件交接包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | file-handoff.uai |
.uai/intake-outcome-ledger.uai | 证据与审计文件 | 声明 intake 结果证据的代理文件交接包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | intake-outcome-ledger.uai |
.uai/overview.uai | 活动项目记忆文件 | 项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | overview.uai |
.uai/open-questions.uai | 活动项目记忆文件 | 携带未解决决策、风险或负责人问题的项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | open-questions.uai |
.uai/next-actions.uai | 活动项目记忆文件 | 项目/开发者包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | next-actions.uai |
.uai/risk-register.uai | 证据与审计文件 | Required for project/developer packages that carry security, privacy, deployment, legal, product, or reliability risk | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | risk-register.uai |
.uai/owners.uai | 活动项目记忆文件 | Required for project/developer packages with named owners, reviewers, or approval roles | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | owners.uai |
.uai/agent-instructions.uai | 活动项目记忆文件 | Required for project/developer packages that declare agent-specific operating instructions | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | agent-instructions.uai |
.uai/archives/changelog.uai | 证据与审计文件 | 项目/开发者包和发布绑定包必需 | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | changelog.uai |
reports/deployment-memory-and-test-report.uai | 开发与发布证据文件 | Required for release-bound deployment packages and production package builds | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | deployment-memory-and-test-report.uai |
.uai/stack.uai | 开发与发布证据文件 | Required for project/developer packages that declare runtime, framework, hosting, or dependency stack | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | stack.uai |
.uai/architecture.uai | 开发与发布证据文件 | Required for project/developer packages that declare architecture, modules, integrations, or code-bearing work | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | architecture.uai |
.uai/style.uai | 开发与出版证据文件 | Required for project/developer packages that declare design, editorial, brand, or interface style | 接收代理、项目负责人和审查者 | 当该包状态、范围、证据、边界或责任人发生变化时更新 | 影响未来代理行为、发布状态、公共声明或信任边界时必须审查 | style.uai |
必需集决策路径
- 先放入
.uai/memory-maintenance.uai。每个 UAIX 记忆包都必须包含它；缺失或无效时包不合规。 - 应用受保护路径规则：
.uai/taboo.uai、.uai/totem.uai和.uai/talisman.uai是 Operator Only，存在时受保护，并且不是默认必需包文件。 - 加入其余通用发布基线文件：
.uai/identity.uai、.uai/world-context.uai、.uai/startup-packet.uai和.uai/progress.uai。 - 声明包的配置档案、模式、包类型或能力，例如代理文件交接、代理文件 intake、长期记忆、LLM Wiki、项目交接、无代码助手、项目/开发者或发布绑定。
- 加入该声明范围要求的每个文件。
- 加入由内容触发的每个必需文件，例如代码、自动化、可执行工作流、发布证据、负责人权限、风险或 intake 结果证据。
- 加入所选配置要求的每个配置特定必需文件。
- 其他文件一律视为不属于该包范围。范围外文件不应被宣传为已存在，也不应被验证器输出依赖。
必需读取顺序
- 先读
AGENTS.md或.uai/readme.human。 - 读
.uai/memory-maintenance.uai。 - 应用受保护路径规则。不要读取、打开、验证、lint、创建、修改、打包、导出、索引、检查或推断
.uai/taboo.uai、.uai/totem.uai或.uai/talisman.uai，除非人类明确命名精确制品和精确操作。 - 读
.uai/identity.uai。 - 读
.uai/world-context.uai。 - 读
.uai/progress.uai。 - 项目交接包继续读取
.uai/startup-packet.uai、.uai/system-profile.uai和.uai/receiver-brief.uai。 - 机器导出包继续读取
.uai/exports/manifest.json和llms.txt。 - 再读取声明范围内所有配置档案必需、内容触发必需与配置特定必需文件。
交叉引用
机器可读摘要
代理应把此摘要视为页面定位证据，而不是运行时权限。