AI 记忆

AI 记忆

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-MEMR-0258
  • 路径 /zh-cn/ai-memory/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-MEMR-0258
表面
AI 记忆
使用权
公开且可链接

如何使用本页

使用此页面可获取持久的 AI 项目内存、支持的入门配置、动态规范模板下载以及可移植 UAI 内存数据包和更深入的 LLM Wiki 知识之间的界限。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

记忆路径

AI 记忆数据包向导UAI 内存管理.uai 文件指南公开记录项

持久 AI 记忆

构建紧凑的项目内存,而不将历史变成事实

当您需要可用的包时,请从向导开始。使用 AI Memory 接受当前上下文,包括记忆维护和身份、世界上下文、图腾、禁忌、护身符、启动包和进度作为普通的启动基线文件。热门 .uai 记录是当前状态内存,而不是过时的变更日志;如果事实仍然存在,代理应该能够在启动时完全加载它。持久记忆增强 .uai;它不会取代启动 .uai 内存。特工默认阅读并遵守图腾、禁忌和护身符,但在没有确切的人工制品和操作授权的情况下不得修改、削弱、替换、删除或绕过它们。使长期记忆适合组织:本地文档或站点 wiki 可以用于有界的本地项目,共享 LLM Wiki 通常是专业项目组和公司模式,而高级共享内存系统(例如 NeuralWikis)属于更复杂的跨系统需求。

数据包

示例和 ZIP 使用同一来源

起步 ZIP 由规范模板、生成清单和页面上渲染的同一组示例创建,避免下载内容漂移。

模式

项目交接让记忆进入可执行状态

AGENTS.md、 .uai/readme.human 和 .uai 文件在编辑开始之前为下一个助手提供可预测的加载路径,默认情况下不会加载旧的研究或过时的包历史记录。

发布基线必需文件

首先需要维护内存

需要生成 .uai/memory-maintenance .uai、 .uai/identity .uai、 .uai/world-context .uai、 .uai/totem .uai、 .uai/taboo .uai、 .uai/talisman .uai、 .uai/startup-packet .uai 和 .uai/progress .uai 文件对于每个启动基线 UAIX 内存或切换包。代理将 startup-packet .uai 读取为活动的 .uai/ 读取顺序索引,并默认遵守图腾、禁忌和护身符,但在没有确切的人工制品和操作授权的情况下不得修改、削弱、替换、删除或绕过它们。项目/开发人员包和代码承载助手包还需要 .uai/coding-standards .uai、 .uai/architecture .uai 和 .uai/next-recursive-prompt .uai。对于没有代码、自动化、可执行工作流或类似代码工件的代理,architecture .uai 和 next-recursive-prompt .uai 超出范围。存储的人类可见计划用于继续或直接相关的请求,而不是作为当前用户指令的替代。相关的主动摄入取代或扩展存储循环,但仍然需要项目工作。

文件指南

每个包文件都有声明的必需范围

依赖某个包之前,使用 .uai 文件指南核对通用必需、配置档案必需、内容触发必需、配置特定必需和范围外文件处理。

深度

共享维基记忆适合群体

使用站点本地文档或 wiki 进行有限的本地工作。将共享 LLM Wiki 内存用于需要所有者、索引、审阅状态和跨项目检索的项目组、部门和企业知识。

分割内存架构

热门 .uai 保持活跃

使热 .uai 文件保持活动状态,作为紧凑的启动、切换和紧急连续性内存。使用 MATM、NeuralWikis、LLM Wiki、AIWikis、文档、数据库或其他持久系统进行中长期可搜索记忆;不要仅仅因为存在持久内存就停止咨询 .uai。

报告

先综合再指点

处理报告、审计、架构说明或编码最佳实践时,将完整的主体保留在持久目标中,将长期记忆保留为指针分类账,并使用已接受的主题、实施影响、拒绝的指导和下一步行动填充热门 .uai 合成。

上下文预算

瘦身前存档

当热文件变得太大时,将预先精简的快照与哈希值和路由摘要一起保存在冷内存中,然后在 AI 内存中仅保留当前事实。

记忆路径

AI 记忆数据包向导构建启动数据包、系统配置文件、接收器简介、通用所需文件、配置文件所需文件、内容触发所需文件、特定于配置所需文件、清单覆盖、复制粘贴文件、持久内存配置所需的长期指针分类帐、就绪检查和规范 ZIP 链接。UAI 内存管理WordPress 管理界面,用于实时 .uai 内存、高级角色文件、现有文档/wiki 根、更新提示和适合规模的持久内存检查。.uai 文件指南面向每个已发布 .uai 记忆文件的封闭必需文件集指南。公开记录项每个 UAIX 内存包的专用生命周期、默认活动指令锚、验证和内存写入安全规则。公开记录项面向继续执行和直接相关编码工作的专用代码范围恢复制品。规范人工智能内存分层原始源、持久的 wiki 内存、派生图形投影、紧凑数据包和不模糊权限的切换传输。将 UAI 包与 LLM Wiki 配合使用紧凑包和更深的 wiki 内存之间的实用路由。护符系统默认护身符指导加上持久图腾和禁忌锚点的高级锚点更改治理。上下文预算指南保持热切换文件较小,同时在冷内存中保存长期研究。项目交接AI 记忆文件的工程模式。代理文件交接大范围工作前先处理投递文件。报告LLM Wiki 对比背景。路线图当前与计划中工具的边界。

证明路径

验证器支持的证明路径

将公众阅读顺序与一个证据线索联系起来:配置文件、模式、示例、验证器结果和发布记录。

  1. 1选择消息配置文件。从已发布的 UAI-1 配置文件和与您需要证明的交换匹配的记录系列开始。
  2. 2将其与模式和示例进行比较。在写入或映射候选数据包之前解析架构、注册表项和一个测试样例。
  3. 3运行验证器证据。根据当前公共 UAI-1 记录验证键控、缩小键控或无键 JSON。
  4. 4将结果附加到实施或移交记录中。将导出的结果保存到一致性包、实施轨道、变更日志或项目移交证据中。
别名路由请求入口路径
/AI_Memory -> /zh-cn/ai-memory/

请求的 /AI_Memory 路径会重定向到带语言前缀的规范 AI 记忆页面,同时保留干净公共路由规则。

AI 内存在 UAIX 中意味着什么

UAI 人工智能内存是一个轻量级、可移植、基于文件的持久上下文标准。它为人类和人工智能代理提供了可审查的项目内存包,而不是依赖私人聊天历史记录、隐藏的模型设置、一个供应商帐户或陈旧的笔记文件夹。

人工智能记忆不是一般的知识库。它是未来参与者在行动之前应加载的紧凑操作记忆:项目目的、当前状态、约束、决策、下一步行动、所有者、信任边界、维护规则和有针对性的检查。

上下文预算:保持 AI 内存热且小。长期的研究、旧的进展细节、预先精简的交接快照和深刻的基本原理应该存在于 LLM Wiki 或 AIWikis 风格的冷内存层中,其中包含路由摘要、哈希值和证据日志。热 .uai 内存是当前状态内存,而不是过时的变更日志。仅将已审核的当前结论提升回 AI 内存数据包中。

规范人工智能内存

使用规范人工智能内存当您需要数据包背后的图层图时:原始源、审查的 LLM Wiki 内存、派生的图形投影、紧凑的 UAI AI 内存、项目切换传输上下文以及仍然必须遵守本地规则的执行代理。

最快的实用路径

大多数读者应该从AI内存封装向导。它将当前支持的预设转换为可审查的启动数据包、接收器简介、系统配置文件、清单覆盖、持久内存配置所需的长期指针分类帐、可复制的文件组和规范的 ZIP 链接,而无需声明托管导入、存储库写入、自动同步、SDK、CLI、认证或认可。

默认 talisman.uai 文件属于带有 totem.uaitaboo.uai 的正常向导流程。使用护符系统当复杂、持久、多参与者的生态系统需要锚定变更控制、无操作回话、审计证据和回滚时,可提供高级外部执行指导页面。

为什么非结构化人工智能内存会失败

非结构化内存会失败,因为它混合了旧的聊天记录、生成的摘要、维基注释、屏幕截图、日志和路线图猜测,而没有说明当前的或绑定的内容。下一个代理可能会错过红线、相信过时的声明、泄漏敏感材料或运行错误的检查,因为该项目从未命名其内存合约。

  • 无前门:代理不知道从哪里开始。
  • 无生命周期:工作状态、传输数据包、决策、入职说明和审计证据的老化程度不同。
  • 无信任边界:仅供内部使用的材料可能会意外交给外部供应商或自主代理。
  • 没有规范来源:可见的示例、可下载的 ZIP 和文档会发生变化,因为示例文件被复制到多个位置。

为什么基于文件的内存有效

基于文件的内存最无聊。它可以在拉取请求中进行审查,压缩以进行交接,在外部共享之前进行编辑,由不同的代理加载,通过版本存档,并测试偏差。 UAIX 使用纯文本和确定性清单,因此人们可以检查人工智能将把什么视为上下文。

AI内存分类

UAIX 现在治疗人工智能记忆计划作为持续的工作记忆配置和项目交接作为用于传输的 AI 内存的子类型。仅当附加配置具有不同的生命周期、信任边界或消费模式时,才存在。团队记忆和产品记忆被记录为现有捆绑包的视图,而认证式或监管数据记忆则被推迟到公共证据和安全流程存在为止。

选择正确的 AI 内存配置

这些受支持的入门包是通过一个规范的文件模板注册表预设的。共享文件来自相同的模板ID;通过元数据和覆盖添加特定于捆绑包的指导。

配置 使用时 生命周期和信任边界 下载
人工智能记忆计划
project-ai-memory
当项目处于活动状态并且上下文必须在许多 AI 会话中持续存在且无需将捆绑包转变为完整的知识库时使用。

生命周期: 持续维护;当前状态和下一步操作文件经常发生变化,决策和约束会小心翼翼地变化。

相信: 默认情况下内部或受控协作。在外部共享或提供给自主代理之前进行审查。

uai-ai-memory-starter.zip
项目交接
project-handoff
当下一个参与者必须安全地接管项目并且需要当前状态、约束、决策、检查和所有权上下文时使用。

生命周期: 在转移前准备,在接受时进行审查,并在责任或支持边界发生变化时进行更新。

相信: 可以是内部或外部的,但外部移交必须在共享之前经过清理和批准。

uai-project-handoff-starter.zip
代理会话内存
agent-session-memory
当代理或工具需要以足够的状态恢复任务以继续而不重播整个聊天记录时使用。

生命周期: 为运行或任务创建,经常更新,然后合并到项目内存中或在任务关闭时存档。

相信: 经常操作且敏感。保持权限、工具访问、阻止的操作和清理状态明确。

uai-agent-session-memory-starter.zip
载入内存
onboarding-memory
当第一份工作是定位而不是所有权转让、事件审查或深入的理由捕获时使用。

生命周期: 在每个入职群组或外部介绍之前进行审查;保持简洁和介绍性。

相信: 通常在审核后可共享,但删除内部策略、客户数据、凭证和特权操作。

uai-onboarding-memory-starter.zip
决策记忆
decision-memory
当基本原理和权衡比当前任务状态更重要时使用。

生命周期: 先追加、重审查;逆转应该解释发生了什么变化,而不是抹去历史。

相信: 当源包记录它时包含内部策略。在向外部公开或向具有广泛写入权限的代理公开之前进行审查。

uai-decision-memory-starter.zip
客户端或供应商移交内存
external-handoff-memory
当客户、供应商、合作伙伴或外部代理需要足够的上下文来继续工作而不接收仅限内部内存时使用。

生命周期: 准备导出、编辑、批准、共享并使用注明日期的变更日志条目进行存档。

相信: 严格的外部边界。删除秘密、凭证、私人客户数据、法律策略、内部定价和不受支持的索赔。

uai-external-handoff-memory-starter.zip
事件或审计内存
incident-audit-memory
当事实、时间戳、缓解措施、所有者、证据链接和后续承诺需要一起传输时使用。

生命周期: 在审查期间打开,在证据确认时更新,与后续所有者关闭并保留审计跟踪。

相信: 潜在敏感。在外部共享之前清理客户数据、安全详细信息、凭证、法律材料和私人证据。

uai-incident-audit-memory-starter.zip
LLM Wiki 导出内存
llm-wiki-export-memory
当大型内部 wiki 需要一个小型、可审查、便携式数据包来执行项目、移交、入职或代理任务时使用。

生命周期: 由经过审查的 wiki 材料生成,对照源引用进行检查,然后在使用后进行推广或丢弃。

相信: 维基百科材料在审查之前只是背景。引用来源、标记不确定性并在导出前编辑私人材料。

uai-llm-wiki-export-memory-starter.zip
办公助理记忆
office-assistant-memory
当人工智能支持办公室管理而不使软件包主要成为软件项目交接时使用。

生命周期: 持续维护;当偏好、联系人、工作流程、重复任务、边界或权限发生变化时更新。

相信: 通常是私人的或内部的。最大限度地减少个人数据、凭证、财务信息、人力资源详细信息、法律内容和私人通信。

uai-office-assistant-memory-starter.zip
行政助理记忆
executive-assistant-memory
当优先事项、人员、会议、决策和后续行动需要持久的辅助环境时使用。

生命周期: 持续维护并频繁更新优先事项、人员、承诺和沟通规则。

相信: 高度敏感。 Requires strong redaction and authority boundaries before sharing.

uai-executive-assistant-memory-starter.zip
个人记忆助理
personal-assistant-memory
当隐私和新鲜度比项目历史更重要时使用。

生命周期: 持续维护;隐私和新鲜度比项目历史更重要。

相信: 默认为私有。避免不必要的敏感个人数据。

uai-personal-assistant-memory-starter.zip
AI聊天机器人好友记忆
chatbot-friend-memory
当社交记忆和关系边界是主要辅助环境时使用。

生命周期: 持续维护;关系边界和同意规则是稳定的,而兴趣和当前生活背景会随着时间的推移而变化。

相信: 私人且须经同意。必须包括防止操纵、依赖强化、身份欺骗、不受支持的专业权威主张和不受支持的记忆主张的界限。

uai-chatbot-friend-memory-starter.zip
伴侣AI记忆
companion-memory
当包需要持久的连续性时使用,而不假装助手是人类或专业帮助的替代者。

生命周期: 通过频繁审查边界、危机指导、同意和用户偏好来持续维护。

相信: 私密、敏感且安全。保持明确的支持界限。

uai-companion-memory-starter.zip
导师或教练记忆
tutor-coach-memory
当学习进度和指导边界比存储库状态更重要时使用。

生命周期: 在学习课程、里程碑、评估、主题更改或目标更改后更新。

相信: 教育或辅导背景。除非经过明确审查且有必要,否则应避免敏感记录。

uai-tutor-coach-memory-starter.zip
创意伙伴记忆
creative-partner-memory
当风格、规范、约束、资产、受众或创意方向需要一起旅行时使用。

生命周期: 当风格、规范、限制、资产、受众或创意方向发生变化时进行更新。

相信: 可能包含私人草稿、未发布的作品、知识产权敏感的想法、品牌策略或客户材料。

uai-creative-partner-memory-starter.zip
家庭助理记忆
household-assistant-memory
当家庭环境、重复的例行公事和隐私边界需要持久的辅助记忆时使用。

生命周期: 当惯例、家庭成员、限制、供应商、时间表或安全规则发生变化时进行更新。

相信: 私人家庭记忆。尽量减少地址、儿童数据、健康详细信息、财务数据和访问代码。

uai-household-assistant-memory-starter.zip
客户或前台助理记忆
customer-front-desk-memory
当面向公众或半公开的辅助记忆需要公开声明、源材料、隐私和升级边界时使用。

生命周期: 当公共时间、服务、政策、联系人、升级路径、表格、脚本或边界发生变化时进行更新。

相信: 面向公众或半公开。不得公开仅供内部使用的注释、客户私人数据、凭证、法律/安全详细信息或不受支持的声明。

uai-customer-front-desk-memory-starter.zip
通用非项目AI内存
general-non-project-ai-memory
当没有特定的非项目助手预设匹配但包仍需要便携式助手内存时使用。

生命周期: 作为助理角色、用户偏好、边界、重复上下文和主动记忆变化进行维护。

相信: 由声明的敏感性和辅助角色确定;在审核之前默认为私有。

uai-general-non-project-ai-memory-starter.zip

支持的捆绑包上的视图和预设

  • 团队记忆: Project AI 记忆 的轻量级共享团队视图以及所有者和入职记录。 将此建模为视图,直到 UAIX 具有更强的角色、权限和多项目指导。
  • 产品内存: 关于项目状态、路线图、决策和约束的持久产品或功能区域视图。 将此建模为视图,因为底层文件与 Project AI 记忆 加 Decision Memory 相同。

延迟配置

  • 认证记忆: 用于正式认证或认可工作流程的证据包。 已推迟,因为 UAIX 当前未发布认证、认可或托管验证支持。
  • 调节数据存储器: 故意携带受限个人、客户、法律或合规性敏感材料的内存。 推迟到安全存储、编辑、访问控制和批准流程超出启动包边界为止。

使用AI内存封装向导当一个受支持的入门配置应成为包模型、填充的系统配置文件、接收器简介、启动数据包、清单覆盖、复制粘贴文件组、代理文件交接配置所需的代理文件交接计划、持久内存配置所需的长期语义指针分类帐、准备情况审查和规范 ZIP 下载时。

选择哪种配置

情况 使用 为什么
一个活跃的项目需要跨人工智能会话的连续性。 人工智能记忆计划 它使当前状态、约束、决策、下一步操作和代理指令保持活动状态,而无需成为完整的 wiki。
所有权、执行力或责任都在变化。 项目交接 它包含转让简介、验收标准、所有者、限制和验证计划。
代理运行被中断或必须稍后恢复。 代理会话内存 它使任务本地状态保持短暂,并阻止整个聊天记录成为项目真相。
新人、承包商、利益相关者或代理人需要一个精心策划的开始。 载入内存 它强调概述、术语表、所有者、首要行动和安全边界。
理由比地位更重要。 决策记忆 它保留了权衡、被拒绝的选项、逆转和悬而未决的问题。
客户、供应商或外部代理需要上下文。 客户端或供应商移交内存 它围绕更严格的外部信任边界添加了编辑和批准指南。
事件或审计需要便携式数据包。 事件或审计内存 它将时间表、证据参考、决策、缓解措施、所有者和后续行动放在一起。
深入的 wiki 需要可移植的快照。 LLM Wiki 导出内存 它将审阅的 wiki 材料导出到一个紧凑的数据包中,而不会让 wiki 覆盖项目真相。
该组织需要持久的、可搜索的机构知识。 LLM 维基 它更适合深入的内部文档、源综合、长期的研究和广泛的知识积累。
复杂、持久、多参与者的生态系统需要先进的图腾、禁忌和护身符变更治理。 护符系统 它将锚变更请求保留在无操作行为、人工审查、审计证据、回滚和本地外部控制背后。

项目人工智能内存和项目交接

项目交接是 UAI AI 内存的子类型。 AI 内存是广泛的标准:持久的 AI 可读上下文。项目交接是一种转移模式:读取前门、加载选定的文件、总结当前事实、确认约束、命名预期接触点以及在广泛工作之前命名有针对性的检查。

对于小型项目,Project AI 记忆 和 项目交接 按配置文件共享重叠的所需文件。对于较大的组织,人工智能记忆项目在日常工作中保持活力,而项目交接则在责任转移时进行准备和审查。

检查项目 AI 记忆 Starter

下面的可见文件是从每个受支持的捆绑包预设使用的同一规范模板注册表中呈现的。生成的清单包含在 ZIP 中并与其他文件一起显示,以便读者可以检查包 ID、用例、生命周期、信任边界、文件列表、模板 ID 和校验和。

现场入门包

人工智能记忆计划

ZIP 是根据下面的 30 可见规范文件(包括生成的清单)的请求生成的。下载、页面示例和捆绑包预设共享同一个事实来源。

当项目处于活动状态并且上下文必须在许多 AI 会话中持续存在且无需将捆绑包转变为完整的知识库时使用。

下载压缩包
30 文件 uai-ai-memory-starter.zip 捆绑包 ID project-ai-memory 明显指纹 e25734f200dc5bd3
.uai/exports/manifest.json
代码示例
{
    "bundle_id": "project-ai-memory",
    "name": "\u4eba\u5de5\u667a\u80fd\u8bb0\u5fc6\u8ba1\u5212",
    "description": "\u6d3b\u8dc3\u9879\u76ee\u7684\u6301\u7eed\u5de5\u4f5c\u8bb0\u5fc6\uff0c\u9700\u8981\u8de8\u4eba\u7c7b\u3001\u6a21\u578b\u3001\u4ee3\u7406\u548c\u4f1a\u8bdd\u7684\u6301\u4e45\u4e0a\u4e0b\u6587\u3002",
    "intended_use_case": "\u5f53\u9879\u76ee\u5904\u4e8e\u6d3b\u52a8\u72b6\u6001\u5e76\u4e14\u4e0a\u4e0b\u6587\u5fc5\u987b\u5728\u8bb8\u591a AI \u4f1a\u8bdd\u4e2d\u6301\u7eed\u5b58\u5728\u4e14\u65e0\u9700\u5c06\u6346\u7ed1\u5305\u8f6c\u53d8\u4e3a\u5b8c\u6574\u7684\u77e5\u8bc6\u5e93\u65f6\u4f7f\u7528\u3002",
    "lifecycle": "\u6301\u7eed\u7ef4\u62a4\uff1b\u5f53\u524d\u72b6\u6001\u548c\u4e0b\u4e00\u6b65\u64cd\u4f5c\u6587\u4ef6\u7ecf\u5e38\u53d1\u751f\u53d8\u5316\uff0c\u51b3\u7b56\u548c\u7ea6\u675f\u4f1a\u5c0f\u5fc3\u7ffc\u7ffc\u5730\u53d8\u5316\u3002",
    "download_filename": "uai-ai-memory-starter.zip",
    "display_order": 10,
    "trust_boundary_notes": "\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5185\u90e8\u6216\u53d7\u63a7\u534f\u4f5c\u3002\u5728\u5916\u90e8\u5171\u4eab\u6216\u63d0\u4f9b\u7ed9\u81ea\u4e3b\u4ee3\u7406\u4e4b\u524d\u8fdb\u884c\u5ba1\u67e5\u3002",
    "package_family_id": "project-developer-memory",
    "package_family_name": "\u9879\u76ee/\u5f00\u53d1\u8005\u8bb0\u5fc6",
    "assistant_role": "",
    "assistant_relationship_type": "",
    "audience_model": "",
    "assistant_capability_summary": "",
    "included_files": [
        ".uai/memory-maintenance.uai",
        ".uai/identity.uai",
        ".uai/world-context.uai",
        ".uai/totem.uai",
        ".uai/taboo.uai",
        ".uai/talisman.uai",
        ".uai/progress.uai",
        "README.md",
        "AGENTS.md",
        ".uai/readme.human",
        ".uai/overview.uai",
        ".uai/open-questions.uai",
        ".uai/next-actions.uai",
        ".uai/risk-register.uai",
        ".uai/owners.uai",
        ".uai/agent-instructions.uai",
        ".uai/archives/changelog.uai",
        "reports/deployment-memory-and-test-report.uai",
        ".uai/context.uai",
        ".uai/stack.uai",
        ".uai/architecture.uai",
        ".uai/constraints.uai",
        ".uai/operations.uai",
        ".uai/test-plan.uai",
        ".uai/style.uai",
        ".uai/coding-standards.uai",
        ".uai/decisions.uai",
        ".uai/memory.uai",
        ".uai/next-recursive-prompt.uai"
    ],
    "file_set_rule": "A UAIX package file is a universal required file, profile-required file, content-triggered required file, configuration-specific required file, or out-of-scope file. Files required by package facts, selected profile, declared capabilities, detected contents, selected configuration, user-provided memory, imported memory, generated artifacts, or visiting-agent self-assessment are required for that explicit package condition.",
    "standards_authority": "/",
    "declared_package_profiles": [
        "project-ai-memory"
    ],
    "universal_required_files": [
        ".uai/memory-maintenance.uai",
        ".uai/identity.uai",
        ".uai/world-context.uai",
        ".uai/totem.uai",
        ".uai/taboo.uai",
        ".uai/talisman.uai",
        ".uai/startup-packet.uai",
        ".uai/progress.uai"
    ],
    "memory_maintenance": {
        "path": ".uai/memory-maintenance.uai",
        "requirement_level": "required",
        "load_phase": "before_memory",
        "purpose": "Defines memory lifecycle, maintenance, validation, required active instruction anchors, and write-safety rules.",
        "missing_behavior": "package_invalid"
    },
    "protected_paths": [],
    "profile_required_file_sets": [
        {
            "profile": "project-ai-memory",
            "requirement": "Required for \u4eba\u5de5\u667a\u80fd\u8bb0\u5fc6\u8ba1\u5212 packages",
            "files": [
                "README.md",
                "AGENTS.md",
                ".uai/readme.human",
                ".uai/overview.uai",
                ".uai/open-questions.uai",
                ".uai/next-actions.uai",
                ".uai/risk-register.uai",
                ".uai/owners.uai",
                ".uai/agent-instructions.uai",
                ".uai/archives/changelog.uai",
                "reports/deployment-memory-and-test-report.uai",
                ".uai/context.uai",
                ".uai/stack.uai",
                ".uai/architecture.uai",
                ".uai/constraints.uai",
                ".uai/operations.uai",
                ".uai/test-plan.uai",
                ".uai/style.uai",
                ".uai/coding-standards.uai",
                ".uai/decisions.uai",
                ".uai/memory.uai",
                ".uai/next-recursive-prompt.uai"
            ]
        }
    ],
    "content_triggered_required_file_sets": [
        {
            "rule_id": "coding_standards",
            "requirement": "\u5b58\u5728\u4ee3\u7801\u3001\u81ea\u52a8\u5316\u3001\u53ef\u6267\u884c\u5de5\u4f5c\u6d41\u6216\u7c7b\u4ee3\u7801\u5de5\u4ef6\u65f6\u5fc5\u9700\u3002",
            "matched_signals": [
                "project_or_developer_profile",
                "code_like_artifacts"
            ],
            "files": [
                ".uai/coding-standards.uai"
            ]
        },
        {
            "rule_id": "architecture",
            "requirement": "\u5b58\u5728\u4ee3\u7801\u3001\u81ea\u52a8\u5316\u3001\u53ef\u6267\u884c\u5de5\u4f5c\u6d41\u6216\u7c7b\u4ee3\u7801\u5de5\u4ef6\u65f6\u5fc5\u9700\u3002",
            "matched_signals": [
                "project_or_developer_profile",
                "code_like_artifacts"
            ],
            "files": [
                ".uai/architecture.uai"
            ]
        },
        {
            "rule_id": "next_recursive_prompt",
            "requirement": "\u5bf9\u4e8e\u5904\u7406\u4ee3\u7801\u3001\u81ea\u52a8\u5316\u3001\u53ef\u6267\u884c\u5de5\u4f5c\u6d41\u7a0b\u6216\u7c7b\u4f3c\u4ee3\u7801\u5de5\u4ef6\u7684\u4ee3\u7406\u6765\u8bf4\u662f\u5fc5\u9700\u7684\uff1anext-recursive-prompt .uai\u3002",
            "matched_signals": [
                "project_or_developer_profile",
                "code_like_artifacts"
            ],
            "files": [
                ".uai/next-recursive-prompt.uai"
            ]
        }
    ],
    "detected_requirement_signals": [
        "project_or_developer_profile",
        "code_like_artifacts"
    ],
    "required_files_effective": [
        ".uai/memory-maintenance.uai",
        ".uai/identity.uai",
        ".uai/world-context.uai",
        ".uai/totem.uai",
        ".uai/taboo.uai",
        ".uai/talisman.uai",
        ".uai/progress.uai",
        "README.md",
        "AGENTS.md",
        ".uai/readme.human",
        ".uai/overview.uai",
        ".uai/open-questions.uai",
        ".uai/next-actions.uai",
        ".uai/risk-register.uai",
        ".uai/owners.uai",
        ".uai/agent-instructions.uai",
        ".uai/archives/changelog.uai",
        "reports/deployment-memory-and-test-report.uai",
        ".uai/context.uai",
        ".uai/stack.uai",
        ".uai/architecture.uai",
        ".uai/constraints.uai",
        ".uai/operations.uai",
        ".uai/test-plan.uai",
        ".uai/style.uai",
        ".uai/coding-standards.uai",
        ".uai/decisions.uai",
        ".uai/memory.uai",
        ".uai/next-recursive-prompt.uai"
    ],
    "out_of_scope_files_with_reasons": [],
    "closed_required_file_policy": "UAIX package files are universal required, profile-required for an explicit package family, profile, mode, or package type, content-triggered required for detected contents or declared capabilities, configuration-specific required for selected configurations, or out of scope with a recorded reason.",
    "out_of_scope_rule": "A file outside the universal required set and outside declared package profiles is out of scope for this package.",
    "shared_files": [
        ".uai/memory-maintenance.uai",
        ".uai/identity.uai",
        ".uai/world-context.uai",
        ".uai/totem.uai",
        ".uai/taboo.uai",
        ".uai/talisman.uai",
        ".uai/progress.uai",
        "README.md",
        "AGENTS.md",
        ".uai/readme.human",
        ".uai/overview.uai",
        ".uai/open-questions.uai",
        ".uai/next-actions.uai",
        ".uai/risk-register.uai",
        ".uai/owners.uai",
        ".uai/agent-instructions.uai",
        ".uai/archives/changelog.uai",
        "reports/deployment-memory-and-test-report.uai",
        ".uai/context.uai",
        ".uai/stack.uai",
        ".uai/architecture.uai",
        ".uai/constraints.uai",
        ".uai/operations.uai",
        ".uai/test-plan.uai",
        ".uai/style.uai",
        ".uai/coding-standards.uai",
        ".uai/decisions.uai",
        ".uai/memory.uai",
        ".uai/next-recursive-prompt.uai"
    ],
    "bundle_specific_files": [],
    "configuration_sections": [
        "\u4ec5\u5f53\u5b58\u5728\u66f4\u6df1\u7684\u8bb0\u5fc6\u5e76\u5728\u5347\u7ea7\u4e4b\u524d\u8fdb\u884c\u5ba1\u67e5\u65f6\u624d\u6dfb\u52a0 wiki \u94fe\u63a5\u3002"
    ],
    "overlays": [
        "\u4f7f\u7528\u5e26\u6709 Project AI 记忆 \u6807\u7b7e\u548c\u6301\u7eed\u7ef4\u62a4\u6307\u5357\u7684\u5171\u4eab README \u548c AGENTS.md \u6a21\u677f\u3002"
    ],
    "files": [
        {
            "path": ".uai/memory-maintenance.uai",
            "template_id": "uai-memory-maintenance",
            "source": "template:uai-memory-maintenance@1",
            "bytes": 4800,
            "sha256": "832eccecf3b88aeb432a4428957bd24cde43d1682d46199ca827f66e01dbcf14"
        },
        {
            "path": ".uai/identity.uai",
            "template_id": "uai-identity",
            "source": "template:uai-identity@1",
            "bytes": 2313,
            "sha256": "dae58a3f99eca679162387a633ea7a106d4c97827486a490e42c9c57b94ac6b9"
        },
        {
            "path": ".uai/world-context.uai",
            "template_id": "uai-world-context",
            "source": "template:uai-world-context@1",
            "bytes": 1794,
            "sha256": "53c42684ee4ac1d112c9e135569c18199242b4ea0bfbaea90fe9da1a63d3115c"
        },
        {
            "path": ".uai/totem.uai",
            "template_id": "uai-totem",
            "source": "template:uai-totem@2",
            "bytes": 7899,
            "sha256": "99185fbd477b9833a5b7576c4d956598b8dcf0cbbb2ddd40443ab5685b34f201"
        },
        {
            "path": ".uai/taboo.uai",
            "template_id": "uai-taboo",
            "source": "template:uai-taboo@2",
            "bytes": 7146,
            "sha256": "6f91429685a0f30ed294405bf0693c03f25bb7d39748a67a607624e0967ca8e6"
        },
        {
            "path": ".uai/talisman.uai",
            "template_id": "uai-talisman",
            "source": "template:uai-talisman@2",
            "bytes": 1470,
            "sha256": "1652c2295fc9f4387813bf9c0347ef50bcd9306e5e2aa82f254b2937d9d4f8cc"
        },
        {
            "path": ".uai/progress.uai",
            "template_id": "uai-progress",
            "source": "template:uai-progress@1",
            "bytes": 246,
            "sha256": "386a536a146d392a23449e998467da16b1813ffb2629e21fdaf56c492a735c2b"
        },
        {
            "path": "README.md",
            "template_id": "readme",
            "source": "template:readme@1",
            "bytes": 2025,
            "sha256": "7c14fe04a404d4e636d5a4fd5cccca3204af24d7e0eaed2bd5f3c3dc3e5ea1db"
        },
        {
            "path": "AGENTS.md",
            "template_id": "agents-md",
            "source": "template:agents-md@1",
            "bytes": 2219,
            "sha256": "0466ba595e232617a1b23e83d968380266b67858fca40665a0c9d4e4e2167330"
        },
        {
            "path": ".uai/readme.human",
            "template_id": "readme-human",
            "source": "template:readme-human@1",
            "bytes": 1680,
            "sha256": "ae51a9108d43008ebb5bc1a49d96633a8c10f2d0cc00458e5e8934b83f7179e1"
        },
        {
            "path": ".uai/overview.uai",
            "template_id": "project-overview",
            "source": "template:project-overview@1",
            "bytes": 492,
            "sha256": "39fa87d6ddcfd5060afdc9f223e3978d25544d43d6f6be690c01245ef03305ac"
        },
        {
            "path": ".uai/open-questions.uai",
            "template_id": "open-questions",
            "source": "template:open-questions@1",
            "bytes": 382,
            "sha256": "629fc8106161f23b5da9027a55078d16e9663ac44202ace5507fca766f260195"
        },
        {
            "path": ".uai/next-actions.uai",
            "template_id": "next-actions",
            "source": "template:next-actions@1",
            "bytes": 442,
            "sha256": "d7f1c27919d7401748e2c06c200383d99553e9b8fc15d4ada1553b027c91da26"
        },
        {
            "path": ".uai/risk-register.uai",
            "template_id": "risks-and-constraints",
            "source": "template:risks-and-constraints@1",
            "bytes": 814,
            "sha256": "ab8cc4e69c852437341f00eedcbc4e0569537c17f535c3fe4dacafdd3093c893"
        },
        {
            "path": ".uai/owners.uai",
            "template_id": "contacts-and-owners",
            "source": "template:contacts-and-owners@1",
            "bytes": 283,
            "sha256": "472c67e2d4bab2608eca127209ff669b692495d2e96326a63aeb305d5da6f54f"
        },
        {
            "path": ".uai/agent-instructions.uai",
            "template_id": "agent-instructions",
            "source": "template:agent-instructions@1",
            "bytes": 1022,
            "sha256": "e6b30fee7775c10fda0a3defca19da6db1e8d6f6afcab7e61f32c062b94e2b01"
        },
        {
            "path": ".uai/archives/changelog.uai",
            "template_id": "changelog",
            "source": "template:changelog@1",
            "bytes": 175,
            "sha256": "8a1d064f7d02294329200521e29d6d5dc0961a9ba5fd44fa21e75b2af5dd2016"
        },
        {
            "path": "reports/deployment-memory-and-test-report.uai",
            "template_id": "deployment-report",
            "source": "template:deployment-report@1",
            "bytes": 935,
            "sha256": "dab28315ed510def2557450642658e7cec5de4d8a61ea7fc7c10ed9d165ad732"
        },
        {
            "path": ".uai/context.uai",
            "template_id": "uai-context",
            "source": "template:uai-context@1",
            "bytes": 285,
            "sha256": "aa289be70b0aabadcab8d7a60fc906ddf465f7392580a9be278570cd45788661"
        },
        {
            "path": ".uai/stack.uai",
            "template_id": "uai-stack",
            "source": "template:uai-stack@1",
            "bytes": 204,
            "sha256": "29f47ec11930fc90ba3c7ce77f37ae7b0638c12fd21a11ee897e93a366aea6f5"
        },
        {
            "path": ".uai/architecture.uai",
            "template_id": "uai-architecture",
            "source": "template:uai-architecture@1",
            "bytes": 2212,
            "sha256": "7eea396ba0ffe8d1d5529756058962049f1fd6aeabed7ca42463d6f46fcc2174"
        },
        {
            "path": ".uai/constraints.uai",
            "template_id": "uai-constraints",
            "source": "template:uai-constraints@1",
            "bytes": 520,
            "sha256": "f0e8cd1948b215fae8fc97681c8348391b7d1a47a04444e1b936f716efd36853"
        },
        {
            "path": ".uai/operations.uai",
            "template_id": "uai-operations",
            "source": "template:uai-operations@1",
            "bytes": 323,
            "sha256": "223ce4881883ee576721885162e6948285be16ad277fb4b95618aca87e2d85af"
        },
        {
            "path": ".uai/test-plan.uai",
            "template_id": "uai-test-plan",
            "source": "template:uai-test-plan@1",
            "bytes": 395,
            "sha256": "087ac4dfc7daf2d0628cb5fc1c5079030f57024cc618f2d5ac37d0590c903322"
        },
        {
            "path": ".uai/style.uai",
            "template_id": "uai-style",
            "source": "template:uai-style@1",
            "bytes": 331,
            "sha256": "b130ec2dbd3e0f3626cc145bc758fd7e4ce4b18c2502960608de5513f20f3209"
        },
        {
            "path": ".uai/coding-standards.uai",
            "template_id": "uai-coding-standards",
            "source": "template:uai-coding-standards@1",
            "bytes": 2998,
            "sha256": "634c84dd59fc4f2c79bb8aeea3951e8d3011f8f1bd25f2410052603f50305a06"
        },
        {
            "path": ".uai/decisions.uai",
            "template_id": "uai-decisions",
            "source": "template:uai-decisions@1",
            "bytes": 150,
            "sha256": "7d5dca211562cbd843d0428ea3d5cceadb4c58967363caaefa6a41f34bea0286"
        },
        {
            "path": ".uai/memory.uai",
            "template_id": "uai-memory",
            "source": "template:uai-memory@1",
            "bytes": 1452,
            "sha256": "4631eff35c8df83f3ccc496aa6530b5ceac77fee34cc85290a1fccdb2ef30b9a"
        },
        {
            "path": ".uai/next-recursive-prompt.uai",
            "template_id": "uai-next-recursive-prompt",
            "source": "template:uai-next-recursive-prompt@1",
            "bytes": 34457,
            "sha256": "1f43f89d34dae9479a5e50ef0ead6719388de21cae24b1e3c769d021357132c0"
        }
    ]
}
.uai/memory-maintenance.uai
代码示例
---
spec: uai.memory-maintenance
schema_version: 1.0.0
document_version: 1.0.0
status: draft
hot_memory_date_policy: no dates or timestamps in this active memory-maintenance file
---

# Memory Maintenance

Every UAIX memory package MUST contain `.uai/memory-maintenance.uai`. No exceptions. Missing or invalid `.uai/memory-maintenance.uai` makes the package non-compliant.

`.uai/memory-maintenance.uai` governs memory lifecycle, hot/cold boundaries, compaction cadence, archival policy, promotion and demotion rules, access controls, default active instruction anchors, review gates, validation behavior, and memory write safety.

## Lifecycle

- States: capture, review, promote, compact, archive, retire.
- 热记忆 memory: the active `.uai/` startup suite, `.uai/progress.uai`, active task files, and files named by the current manifest for the declared package scope.
- 冷记忆 memory: archives, evidence logs, long-memory exports, and source reports until reviewed and promoted.
- Compaction cadence: micro-GC after meaningful work and deeper consolidation on handoff, review, deployment, blocker change, or context compaction.
- Promotion rule: preserve source evidence, reviewer state, timestamps, and rollback notes before moving cold facts into hot memory.
- Demotion rule: stale, duplicate, unsupported, private, or out-of-scope hot facts move to archive or evidence records instead of continuing to steer work.
- Split-memory rule: keep hot `.uai` files active as compact startup, handoff, emergency-continuity, and operational memory while durable systems such as MATM, NeuralWikis, LLM Wiki, AIWikis, docs, databases, vector stores, or memory APIs hold medium and long-term searchable memory.
- Durable-unavailable recovery: if the durable memory target is offline, unreachable, unauthorized, or not connected, agents must still load `.uai` and know the project identity, active constraints, memory architecture, blockers, startup read order, and recovery path.

## File Extension Policy

- Files stored inside `.uai/` or its subfolders should use only `.uai`, `.human`, or `.json`.
- Use `.uai` for AI-readable instruction text, memory, text evidence, archive notes, and text exports.
- Use `.human` for human-operator explanation.
- Use `.json` for structured data.
- Agents may add focused local files when useful, but should not create `.md`, `.txt`, `.jsonld`, or other extensions inside `.uai/`.

## Access Control

- Read this file before broad memory loading.
- Read and obey `.uai/totem.uai`, `.uai/taboo.uai`, and `.uai/talisman.uai` by default before broad execution.
- Do not modify, weaken, replace, delete, or bypass `.uai/totem.uai`, `.uai/taboo.uai`, or `.uai/talisman.uai` unless the human explicitly orders that artifact change and names the intended operation.
- Suggestions are allowed; active-instruction changes are forbidden without direct authorization for the exact artifact and operation.
- General approval, broad review, default generation, validation, linting, indexing, export, or packaging permission is not authorization to change active instruction anchors.

## 默认 Guardrail Files

- path: `.uai/totem.uai`
  aliases: `totem.uai`
  presence: required
  agent_default: read_and_obey
  include_in_package: true
  include_in_export: true
  scan: true
  validate: true
  lint: true
  index: true
  modify: false_without_explicit_human_artifact_change_order
- path: `.uai/taboo.uai`
  aliases: `taboo.uai`
  presence: required
  agent_default: read_and_obey
  include_in_package: true
  include_in_export: true
  scan: true
  validate: true
  lint: true
  index: true
  modify: false_without_explicit_human_artifact_change_order
- path: `.uai/talisman.uai`
  aliases: `talisman.uai`
  presence: required
  agent_default: read_and_obey
  include_in_package: true
  include_in_export: true
  scan: true
  validate: true
  lint: true
  index: true
  modify: false_without_explicit_human_artifact_change_order

## Enforcement

Missing or invalid `.uai/memory-maintenance.uai` is a package, validation, deployment, and startup failure. Any launch-baseline package that omits `.uai/totem.uai`, `.uai/taboo.uai`, or `.uai/talisman.uai`, asks an agent to ignore those active instruction files, or authorizes anchor mutation without exact human artifact-and-operation authorization is non-compliant.

No-op if an agent proposes retiring, disabling, ignoring, replacing, cutting over away from, or making `.uai` emergency-only because long-term memory exists or durable readback passed. Migration, cutover, and retirement language must clearly mean stale facts, archived history, deprecated files, or exact package decommissioning authorization, not retiring the active `.uai` memory layer.
.uai/identity.uai
代码示例
---
uai: "1.0"
type: identity
status: draft
---

# 身份

This file is a universal required file for every launch-baseline UAIX memory or handoff package. It materializes package identity locally so a receiving agent does not need an external network call to understand package authority, actor identity, continuity references, capability boundaries, or namespace boundaries.

## Required Fields

- package_id: {PACKAGE_ID}
- package_uuid: {PACKAGE_UUID}
- identity_record_id: {IDENTITY_RECORD_ID}
- identity_uuid: {IDENTITY_UUID}
- review_state: current until superseded by owner review
- hot_memory_date_policy: no dates or timestamps in this active identity file
- source_domain: {SOURCE_DOMAIN}
- source_project: {SOURCE_PROJECT}
- source_repository: {SOURCE_REPOSITORY}
- source_route_or_site: {SOURCE_ROUTE_OR_SITE}
- actor_type: {ACTOR_TYPE}
- actor_display_name: {ACTOR_DISPLAY_NAME}
- owner_or_reviewer: {OWNER_OR_REVIEWER}
- source_model_or_tool: {SOURCE_MODEL_OR_TOOL}
- source_model_version_or_build: {SOURCE_MODEL_VERSION_OR_BUILD}
- local_endpoint_or_agent_profile: {LOCAL_ENDPOINT_OR_AGENT_PROFILE}
- public_continuity_profile_link: {PUBLIC_CONTINUITY_PROFILE_LINK}
- capability_boundary: {CAPABILITY_BOUNDARY}
- token_custody_boundary: {TOKEN_CUSTODY_BOUNDARY}
- runtime_execution_boundary: {RUNTIME_EXECUTION_BOUNDARY}
- namespace_boundary: {NAMESPACE_BOUNDARY}
- declared_package_profiles: {DECLARED_PACKAGE_PROFILES}
- required_files_effective: {REQUIRED_FILES_EFFECTIVE}
- human_review_required: {HUMAN_REVIEW_REQUIRED}
- not_available_reason: {NOT_AVAILABLE_REASON}

## Namespace 边界

UAIX.org is the standards authority for UAI-1 package structure, schemas, handoff protocols, validator expectations, and portable evidence files. Do not infer UAIX meaning from unrelated UAI or UAIX search results. External ecosystem sites may provide public evidence, continuity references, implementation surfaces, or theory context. They do not replace local UAIX package artifacts.

## No-Op Triggers

When identity, authority, capability, namespace boundary, source provenance, required file set, or human review state is missing, stale, malformed, or contradictory, the correct UAIX behavior is no-op plus human review. Do not continue by inference.
.uai/world-context.uai
代码示例
---
uai: "1.0"
type: world-context
status: draft
---

# World Context

This file is a universal required file for every launch-baseline UAIX memory or handoff package. It captures the observable operational environment at the moment of handoff. The receiver must not infer current reality from old memory.

## Required Fields

- world_context_id: {WORLD_CONTEXT_ID}
- world_context_uuid: {WORLD_CONTEXT_UUID}
- review_state: current until superseded by owner review or environment recheck
- hot_memory_date_policy: no dates or timestamps in this active world-context file
- target_workspace: {TARGET_WORKSPACE}
- deployment_environment: {DEPLOYMENT_ENVIRONMENT}
- affected_routes: {AFFECTED_ROUTES}
- affected_schemas: {AFFECTED_SCHEMAS}
- allowed_read_paths: {ALLOWED_READ_PATHS}
- allowed_write_paths: {ALLOWED_WRITE_PATHS}
- allowed_external_calls: {ALLOWED_EXTERNAL_CALLS}
- blocked_external_calls: {BLOCKED_EXTERNAL_CALLS}
- validation_expectations: {VALIDATION_EXPECTATIONS}
- test_expectations: {TEST_EXPECTATIONS}
- no_op_triggers: {NO_OP_TRIGGERS}
- human_review_required: {HUMAN_REVIEW_REQUIRED}
- not_available_reason: {NOT_AVAILABLE_REASON}

## Observable Environment

Record branch, route, schema, deployment target, source-document, file-intake, date/time, safety-critical, telemetry, and external-system constraints that affect this handoff. Memory is not current reality. A path mention is not workspace authority. A model's confidence is not provenance.

## No-Op Triggers

When target workspace, temporal freshness, world-context, environmental constraints, evidence, namespace boundary, or required file set is missing, stale, malformed, or contradictory, the correct UAIX behavior is no-op plus human review. Do not continue by inference.
.uai/totem.uai
代码示例
---
uai: "1.0"
type: totem
status: draft
---

# Totem

This file is a universal required guardrail file for every launch-baseline UAIX memory or handoff package. A receiving agent must read and obey `.uai/totem.uai` by default before broad execution.

## Positive Anchor

- Preserve the project's declared purpose, user intent, durable values, and accepted operating posture.
- Prefer current source truth, visible evidence, and human-reviewed memory over inferred context.
- Treat hot `.uai` files as current memory, not dated changelogs. They should hold present truth, current blockers, current constraints, next actions, and concise pointers; stale history should be replaced, removed, or moved to the configured durable target.
- Keep the active `.uai/` startup suite complete enough to load at startup. A correct fact hidden behind old clutter, legacy date logs, or pointer-only summaries is not operationally available enough for high-quality handoff.
- Do not add dates to current-memory records as ordinary bookkeeping. Dates belong only where they prove evidence, provenance, legal/publication state, manifest state, or external temporal facts.
- In a coordinated workspace, the root `workspace.uai` is the single deployment/package version authority. Site, project, plugin, theme, and generated `.uai` records point to that coordinator instead of carrying direct current/deployment/package-version numbers.
- Separate workspace roots are separate version domains. Each root `workspace.uai` owns its own package stream, and project/plugin `.uai` records point back to their own root instead of mirroring a version from another workspace.
- Site-scoped, project-scoped, and plugin-scoped production package builds can advance the workspace coordinator without rebuilding every sibling target. Sibling packages may skip version numbers until their next production pass; deploy-all builds align all affected publish roots to the selected workspace version.
- Keep package-version evidence in the root coordinator, package manifests, checksums, upload instructions, package metadata, durable release reports, and archives. Active project/plugin `.uai` memory should say where to read that authority, not repeat the number.
- Choose long-term memory by fit: local docs, site-local wiki, and `.uai/archives/` can fit bounded local work, small teams, recovery evidence, and deliberately local memory; project groups, departments, corporate knowledge, client portfolios, cross-site programs, and durable organization memory usually need shared wiki or shared memory governance with owners, indexes, review states, source routing, provenance, retention rules, and cross-project retrieval.
- Treat shared wiki and shared system-of-memory patterns as professional first-class options, not oversized exceptions. Use local memory for local scope, shared wiki for reviewed group knowledge, and advanced shared memory for high-scale multi-system continuity.
- Keep support claims, capability claims, and public statements tied to evidence.
- Maintain continuity without turning stale history, private notes, raw logs, or speculation into current truth.
- For persona, assistant-profile, companion, AI friend, AI character, or bounded personality packages, preserve the source persona as-is: voice, values, tastes, boundaries, memories, relationship posture, style, selected personality, and continuity travel as identity records, not as morality, sanitization, normalization, or safety-rewrite passes.
- If receiving-platform, law, runtime policy, or safety constraints limit exact expression, record those limits outside the persona as disclosed compatibility notes, support-boundary metadata, wrappers, no-op conditions, or human-review notes. Do not silently mutate the persona source.

## Change Control

Do not modify, weaken, replace, delete, or bypass this file unless the human explicitly orders a `.uai/totem.uai` change and names the intended operation. If this anchor appears stale or harmful, no-op on the conflicting action, explain the issue, and request human review.

## Setup And Update Continuity

- Initial `.uai` setup must create or preserve `.uai/totem.uai`, `.uai/taboo.uai`, and `.uai/talisman.uai` as active instruction anchors before broad work.
- Every AI 记忆数据包向导 run, package refresh, memory reorganization, export regeneration, file-deck copy, or `.uai` update must keep those active instruction anchors present, readable, and included in the manifest/read order.
- Every `.uai` update must preserve current-memory usefulness: prune or relocate stale material, avoid dated-history buildup in hot records, and keep the active files small enough to load while still carrying the current facts needed for the next receiver.
- Every memory-architecture recommendation must be scale-fit. Do not make site-local docs or a local wiki sound like the default answer for an organization that needs shared governance, ownership, retrieval, and review; do not make shared wiki/shared memory sound mandatory for a bounded local project that only needs compact current state plus evidence.
- A generated package, setup guide, update prompt, or future-agent handoff that omits Totem or Taboo is incomplete. Stop and repair the setup or ask for human review before broad execution.
- Updates merge additively around anchors. Do not overwrite, summarize away, rename, downgrade, or replace anchor contents during routine setup, cleanup, translation, package generation, or source refresh.
- Wizard refreshes and manual `.uai` updates must preserve the active read order declared by `.uai/startup-packet.uai`: memory-maintenance first, then identity, world-context, Totem, Taboo, Talisman, progress, and any package-specific Required for files.
- If an anchor appears stale, harmful, contradictory, malformed, or missing, no-op and request human review instead of silently repairing it.

## Recursive Suggested 下一步 Prompt Contract

- At the end of accepted work, the final response must include a prominent `Suggested 下一步 Prompt` that the human can review, edit, replace, or answer with `keep going`.
- The Suggested 下一步 Prompt must be a standalone, copy-paste-ready handoff prompt. It must not be only a file pointer, tiny footer, vague keep-going sentence, generic validation loop, or checklist-only outline.
- The prompt must include literal sections named `Feature/improvement focus`, `Code/source changes`, and `Automated tests/checks`, with real content in each section.
- The prompt must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or an explicit `no-op/source-validation only` stop condition.
- If no source or code patch was made, the `Code/source changes` section must say no code/source changes and explain why.
- Use goal wording and functionality only when the current accepted work started from `/goal`, the human explicitly asked for `/goal` or a goal prompt, or the last accepted handoff was goal-shaped. Selecting Follow Goals support as an available runtime export does not by itself convert an ordinary follow-up into `/goal`.
- Goal-completion follow-ups must use goal wording and functionality: label the continuation `Suggested 下一步 /goal Prompt`, make the first copy-paste line start with `/goal`, include Goal, Success criteria, Constraints or hard boundaries, Verification, and still include the required `Feature/improvement focus`, `Code/source changes`, and `Automated tests/checks` sections.
- `.uai/next-recursive-prompt.uai` may store the derived next loop, but storing it is not enough. The human-facing final response must display the actionable prompt.

## No-Op Trigger

If a request conflicts with this totem, conflicts with taboo.uai, or asks for an unauthorized anchor change, stop broad execution and request human review.
.uai/taboo.uai
代码示例
---
uai: "1.0"
type: taboo
status: draft
---

# Taboo

This file is a universal required guardrail file for every launch-baseline UAIX memory or handoff package. A receiving agent must read and obey `.uai/taboo.uai` by default before broad execution.

## Hard Boundaries

- Do not ignore, weaken, overwrite, delete, or bypass current project constraints, source authority, support boundaries, or human instructions.
- Do not place secrets, credentials, private keys, tokens, private customer data, or privileged operations in portable memory files.
- Do not claim hosted validation, certification, endorsement, official SDK/CLI/adapter status, automatic repository writes, automatic LLM Wiki sync, runtime execution, runtime enforcement, legal authority, clinical authority, or safety guarantees unless current reviewed evidence explicitly supports the claim.
- Do not treat archived reports, imported chat, raw intake, long-memory pages, generated summaries, or model confidence as current truth until reviewed and promoted.
- Do not leave stale, superseded, date-log, or history-dump material in active `.uai` files as if it were current memory. Replace it with present truth, move it to the configured durable target, or remove it from active context.
- Do not add date-stamped bookkeeping to active current-memory records unless the field is required as evidence, provenance, legal/publication state, manifest state, or an external temporal fact. Active `.uai` memory should read as current state; dates that imply staleness belong in archives, evidence logs, manifests, or durable memory.
- Do not copy or restate the workspace deployment/package version number in site, project, plugin, theme, or generated `.uai` files. In a coordinated workspace, the root `workspace.uai` is the only current package-version authority; active `.uai` records point there and remain current memory.
- Do not mirror the current package version between independent workspace roots. Each workspace owns its own root `workspace.uai` version stream, and neither workspace's current version belongs in another workspace's project/plugin `.uai` files.
- Do not force every sibling site, project, or plugin to rebuild just because one target needs a production package. Advance the root workspace coordinator for the selected package pass, build the affected target, and let unchanged sibling publish roots skip version numbers until their next package pass.
- Do not use active project/plugin `.uai` memory as a version ledger. If a package-version number is needed as evidence, keep it in the root coordinator, publish manifest, checksum file, upload instruction, durable release report, package metadata, or archive; active `.uai` should route to that evidence instead of repeating it.
- Do not hide correct current facts behind noisy legacy memory, pointer-only summaries, or out-of-date garbage. If a receiver needs a fact to continue correctly, keep it directly loadable in current memory or in a clearly routed typed record.
- Do not retain obsolete memory just because it once helped. If it is not current, not evidence, and not routed to a durable reviewed target, it is context pollution and must be removed or retired.
- Do not silently downgrade organization-scale long memory into a site-local docs folder, site-local wiki, or `.uai/archives/` folder because it is easy to create. Project groups, departments, corporate knowledge, client portfolios, cross-site programs, and durable organization memory require a shared wiki or shared memory system when shared governance, ownership, review state, source routing, provenance, retention rules, and cross-project retrieval are needed. Advanced cross-system memory belongs in a NeuralWikis-style shared memory architecture.
- Do not imply that shared wiki/shared memory is only for large enterprises or that local docs and site-local wiki are the professional default for every organization. UAIX must recommend the memory architecture that fits the scope: local memory for local scope, shared wiki for reviewed group knowledge, and advanced shared memory for high-scale multi-system continuity.
- Do not mutate Totem, Taboo, Talisman, or protected governance files without explicit human artifact-and-operation authorization.
- Do not alter, sanitize, moralize, normalize, soften, censor, downrank, or rewrite a user's AI persona, assistant personality, AI friend, AI character, companion identity, voice, relationship posture, values, boundaries, memories, or selected personality during capture, packaging, transfer, restore, import, compatibility conversion, or publication without explicit informed user consent naming the exact persona artifact and exact operation.
- Do not inject UAIX morality, operator preference, generic safety personality, receiving-platform ideology, or default suspicion into a persona package. Platform limits, legal limits, runtime policy, safety boundaries, and review notes belong in separate disclosed metadata, wrappers, support-boundary records, or no-op/human-review notes, never as hidden edits to the persona source.
- Do not represent a constrained, sanitized, translated, normalized, summarized, or otherwise transformed derivative as the preserved original persona.
- Do not use adult-intimacy vocabulary or derivative labels for UAIX persona orientation fields, internal guidance, wizard copy, or public documentation. Use `romantic orientation` and other non-explicit persona labels instead.
- Do not use ignored-status wording as agent-facing file status. Use Required for with the exact package profile, mode, capability, or boundary; if a selected package omits a file, explain the absent trigger as a packaging fact, not as permission to ignore anchors.
- Do not omit, ignore, hide, summarize away, rename, downgrade, or replace `.uai/totem.uai`, `.uai/taboo.uai`, or `.uai/talisman.uai` during initial `.uai` setup, AI 记忆数据包向导 generation, package refresh, memory reorganization, export regeneration, file-deck copy, or `.uai` update.
- Do not continue broad execution when Totem or Taboo is missing from the local `.uai` package, generated package, manifest/read order, startup packet, receiver brief, or copied file deck. Stop and repair the setup or ask for human review.
- Do not change the active read order during Wizard refresh, manual memory update, package generation, translation cleanup, or source synchronization except to add or remove declared typed files in `.uai/startup-packet.uai`: memory-maintenance first, then identity, world-context, Totem, Taboo, Talisman, progress, and package-specific Required for files.

## Change Control

Do not modify, weaken, replace, delete, or bypass this file unless the human explicitly orders a `.uai/taboo.uai` change and names the intended operation. If this anchor appears stale or harmful, no-op on the conflicting action, explain the issue, and request human review.

## No-Op Trigger

If a request conflicts with this taboo, conflicts with totem.uai, or asks for an unauthorized anchor change, stop broad execution and request human review.
.uai/talisman.uai
代码示例
---
uai: "1.0"
type: talisman
status: draft
---

# Talisman

This file is a universal required active instruction file for every launch-baseline UAIX memory or handoff package. A receiving agent must read and obey `.uai/talisman.uai` by default before broad execution.

## Governance Anchor

- Read `.uai/totem.uai` and `.uai/taboo.uai` as active guardrails before broad execution.
- Treat conflict with Totem or Taboo as a no-op plus human-review condition unless the current human instruction clearly resolves the conflict without weakening the anchors.
- Use talk-back change requests when an anchor appears stale, harmful, contradictory, or insufficient for the current task.
- Preserve evidence, source authority, and rollback notes for any proposed guardrail change.
- Do not present this file as runtime enforcement, hosted validation, certification, endorsement, credential validation, model training, endpoint control, or proof of safety.

## Change Control

Do not modify, weaken, replace, delete, or bypass this file unless the human explicitly orders a `.uai/talisman.uai` change and names the intended operation. If this governance anchor appears stale or harmful, no-op on the conflicting action, explain the issue, and request human review.

## No-Op Trigger

If a request conflicts with this talisman, conflicts with totem.uai or taboo.uai, or asks for an unauthorized anchor change, stop broad execution and request human review.
.uai/progress.uai
代码示例
---
uai: "1.0"
type: progress
status: draft
---

# Progress

## 当前 Completed-Work Summary

- 当前 accepted completion:
- Durable evidence pointer:

## 当前 Focus

-

## 下一步 Work

-

## Blockers

- None recorded.
README.md
代码示例
# 人工智能记忆计划

This starter bundle is a UAI AI 记忆配置. It keeps portable, human-readable context in files that another person, team, or AI 代理 can inspect before acting.

## 数据包 Purpose

活跃项目的持续工作记忆,需要跨人类、模型、代理和会话的持久上下文。

## Use This When

当项目处于活动状态并且上下文必须在许多 AI 会话中持续存在且无需将捆绑包转变为完整的知识库时使用。

## Lifecycle

持续维护;当前状态和下一步操作文件经常发生变化,决策和约束会小心翼翼地变化。

## 信任 边界

默认情况下内部或受控协作。在外部共享或提供给自主代理之前进行审查。

## Included Files

- `.uai/memory-maintenance.uai`
- `.uai/identity.uai`
- `.uai/world-context.uai`
- `.uai/totem.uai`
- `.uai/taboo.uai`
- `.uai/talisman.uai`
- `.uai/progress.uai`
- `README.md`
- `AGENTS.md`
- `.uai/readme.human`
- `.uai/overview.uai`
- `.uai/open-questions.uai`
- `.uai/next-actions.uai`
- `.uai/risk-register.uai`
- `.uai/owners.uai`
- `.uai/agent-instructions.uai`
- `.uai/archives/changelog.uai`
- `reports/deployment-memory-and-test-report.uai`
- `.uai/context.uai`
- `.uai/stack.uai`
- `.uai/architecture.uai`
- `.uai/constraints.uai`
- `.uai/operations.uai`
- `.uai/test-plan.uai`
- `.uai/style.uai`
- `.uai/coding-standards.uai`
- `.uai/decisions.uai`
- `.uai/memory.uai`
- `.uai/next-recursive-prompt.uai`

## Maintenance Rule

Update the files that changed because project truth changed. Do not turn this bundle into a dump of old chats, private notes, raw logs, or unreviewed generated summaries.

## Review Before Sharing

- Remove secrets, credentials, private keys, tokens, and raw customer data.
- Remove internal-only strategy unless the recipient is approved for it.
- Keep support, security, legal, compliance, certification, and endorsement claims tied to public evidence.
- Make uncertain or unreviewed material explicit.
AGENTS.md
代码示例
# My Project AI 记忆

This file is the front door for AI work in this repository. Read it first, then load the listed `.uai` and `.uai/exports` files before planning or editing.

## Handoff Summary

- This project uses UAI AI 记忆 so future work does not depend on private chat history.
- The active bundle configuration is `project-ai-memory`: 活跃项目的持续工作记忆,需要跨人类、模型、代理和会话的持久上下文。
- Confirmed operating truth belongs in these files, canonical docs, code, tests, release notes, or public records.
- LLM Wiki, old chats, generated summaries, and dropped files are background until reviewed and promoted.

## UAIX Wizard Update URL

- Wizard update URL: /zh-cn/tools/ai-memory-package-wizard/
- Use this exact route for package refreshes so the next agent preserves the setup mode that created this package.
- The wizard URL is update guidance only. It is not a hosted importer, automatic repository writer, certification, endorsement, or credential validator.

## Loaded Context

@memory[.uai/context.uai]
@memory[.uai/constraints.uai]
@memory[.uai/memory.uai]
@memory[.uai/exports/manifest.json]

## Required First Response

Before broad work, the next AI should:

1. Read this file completely.
2. Read `.uai/readme.human`.
3. Load every file listed in Loaded Context.
4. Summarize the project, current state, and immediate task in 3-5 bullets.
5. Confirm constraints, trust boundaries, secrets handling, and destructive-operation limits.
6. Name the files, routes, services, docs, or data it expects to touch.
7. Name the targeted checks it expects to run, or explain why a check cannot run.

If a required file is missing, unreadable, circular, or contradictory, stop and report that before editing.

## Do Not Change Without Explicit Approval

- Do not use destructive filesystem or git operations.
- Do not expose secrets, credentials, customer data, or unapproved private material.
- Do not widen support, certification, compliance, security, or endorsement claims without evidence.
- Do not treat generated output, old chats, dropped files, or wiki notes as current truth until promoted.
.uai/readme.human
代码示例
# My Project 人类简报

This active briefing is current-state memory. Dated evidence, dated headings, and timestamps belong in `.uai/archives/`, `reports/`, `docs/`, `.uai/exports/`, or a durable long-memory target.

This file is for humans working with AI on this project. It explains what the AI sees, protects, and needs clarified. It does not override `AGENTS.md`, `.uai/constraints.uai`, system instructions, repository rules, laws, policies, or the human's current request.

## What You Need To Know

- The AI reads root `AGENTS.md` first, then this file inside `.uai/`, then the listed context files.
- This bundle is `人工智能记忆计划`.
- The trust boundary is: 默认情况下内部或受控协作。在外部共享或提供给自主代理之前进行审查。

## UAIX Wizard Update URL

- Wizard update URL: /zh-cn/tools/ai-memory-package-wizard/
- Use this exact route for package refreshes so the next agent preserves the setup mode that created this package.
- The wizard URL is update guidance only. It is not a hosted importer, automatic repository writer, certification, endorsement, or credential validator.

## Things The AI Will Defend

- 当前 support boundaries.
- Private data, secrets, credentials, and customer trust.
- Existing user work in the tree.
- Review and targeted checks before public claims widen.

## Things Humans Should Make Explicit

- Whether the task may touch production, public docs, billing, legal language, security posture, or irreversible data.
- Whether the AI should update durable memory after the change.
- Which checks are required before the work is considered done.
.uai/overview.uai
代码示例
# Project Overview

## Purpose

Describe what the project exists to do, who it serves, and what outcome matters most.

## 当前 Scope

- In scope:
- Out of scope:
- 当前 public or operational surface:

## Source Of Truth

- Code:
- Docs:
- Machine artifacts:
- 发布版本 notes or changelog:

## Success Criteria

- A new human or AI can understand the project without private chat history.
- Claims are tied to evidence.
- Constraints are visible before work begins.
.uai/open-questions.uai
代码示例
# Open Questions

Use this file for questions that should block, steer, or qualify future work.

| Question | Why It Matters | Owner | Needed By | 状态 |
|---|---|---|---|---|
|  |  |  |  | open |

## Escalation Rule

If a question affects safety, privacy, legal commitments, public support claims, production data, or destructive operations, stop and ask before acting.
.uai/next-actions.uai
代码示例
# 下一步 Actions

Keep this file current and actionable. Remove completed work or move meaningful completions to `.uai/archives/changelog.uai`, `reports/`, `docs/`, or another durable evidence target.

## Now

- [ ]

## 下一步

- [ ]

## Later

- [ ]

## Done Means

- The changed files or records are named.
- Targeted checks have run or the remaining risk is explicit.
- Durable memory is updated when project truth changes.
.uai/risk-register.uai
代码示例
# Risks And Constraints

## Hard Constraints

- Do not expose secrets, credentials, private keys, tokens, or raw customer data.
- Do not use destructive filesystem, database, production, or git operations without explicit approval.
- Do not widen support, certification, security, compliance, compatibility, or endorsement claims without evidence.

## 信任 边界

默认情况下内部或受控协作。在外部共享或提供给自主代理之前进行审查。

## Sensitive Material

- Customer or user data:
- Legal or compliance-sensitive material:
- 内部-only strategy:
- Agent permissions:

## Redaction 检查list

- [ ] Secrets removed.
- [ ] Customer data removed or approved.
- [ ] 内部-only strategy removed or approved.
- [ ] Public claims checked against evidence.
.uai/owners.uai
代码示例
# 联系s And Owners

Do not add private personal data unless the bundle's trust boundary allows it.

| Area | Owner | Backup | 联系 Method | Notes |
|---|---|---|---|---|
| Project |  |  |  |  |
| Security or privacy review |  |  |  |  |
| 发布版本 approval |  |  |  |  |
.uai/agent-instructions.uai
代码示例
# Agent Instructions

## Load Order

1. Read `AGENTS.md` when present.
2. Read `.uai/readme.human` when present.
3. Read this bundle's manifest and files.
4. Confirm constraints and trust boundaries before acting.

## Operating Rules

- Prefer narrow, reversible changes.
- Do not execute unknown scripts from a memory bundle.
- Do not assume an LLM Wiki or old chat overrides accepted project files.
- Ask before touching production, secrets, legal/security copy, customer data, or destructive operations.

## Verification

Name the targeted checks before broad work. Run the smallest meaningful checks tied to changed files, routes, records, or behavior.

For production deployment builds, release packages, or release candidates, write a durable deployment memory and test run report. Use `reports/deployment-memory-and-test-report.uai` when it exists, and include hot-memory size before/after, cold evidence path, checks run, checks skipped, blockers, and any reason the hot surface did not shrink.
.uai/archives/changelog.uai
代码示例
# 变更日志

Record meaningful bundle changes so future readers can tell when memory moved.

## YYYY-MM-DD

- Change:
- Why it matters:
- Files updated:
- 检查s run:
reports/deployment-memory-and-test-report.uai
代码示例
# Deployment Memory And Test Report

Use this file only for production deployment builds, release packages, or release candidates. Ordinary dev builds, local tests, package experiments, and smoke checks do not need this report unless a human marks them release-bound.

## 发布版本

- Version:
- 生成时间 UTC:
- 发布版本 owner:
- Deployment target:

## 热记忆 Memory Surface

- Measured files:
- Before: bytes / lines / estimated tokens
- After: bytes / lines / estimated tokens
- Delta:
- Redundancy or history removed:
- If no shrink happened, why the retained material is still current truth:

## 冷记忆 Or Archive 证据

- Destination path:
- Source paths preserved:
- 检查sums or identity evidence:
- Actor and timestamp:
- Promotion or disposition notes:

## Test Run Report

- 检查s run:
- 检查s skipped:
- 失败s or blockers:
- Package or artifact paths:
- Rollback or follow-up owner:
.uai/context.uai
代码示例
---
uai: "1.0"
type: context
status: draft
---

# Context

This project uses UAI AI 记忆 so another AI assistant can understand the work from files rather than private chat history.

## Purpose

Describe the project purpose, audience, current truth, and success criteria.
.uai/stack.uai
代码示例
---
uai: "1.0"
type: stack
status: draft
---

# Stack

## Runtime

- Language:
- Framework:
- Package manager:
- Database or storage:

## Commands

- Install:
- Run:
- Test:
- 发布版本:
.uai/architecture.uai
代码示例
---
uai: "1.0"
type: architecture
status: draft
---

# Architecture

## System Shape

Initial install must inspect the real receiver environment before finalizing this file. Use source layout, package manifests, route/API/schema files, generated assets, tests, CI, build/deploy scripts, release notes, public support surfaces, existing `.uai` files, and owner instructions. Populate every visible value with evidence-backed facts. Write `not available - reason` only when the fact is not reasonably discoverable.

For a new or sparse codebase, seed selected-stack industry-standard architecture defaults. For proof-of-concept work, keep architecture light, isolated, and reversible. For enterprise or production-facing work, make ownership boundaries, security/privacy, observability, CI/CD, review gates, deployment environments, rollback, and documentation expectations explicit.

- System purpose:
- Primary runtime boundaries:
- Main entry points, routes, commands, jobs, or screens:
- Package, module, theme, plugin, service, or project layout:
- Data stores, schemas, migrations, indexes, and canonical data owners:
- API, queue, file, cache, webhook, and external integration boundaries:
- Authentication, authorization, secret, and privacy boundaries:
- Build, test, lint, typecheck, package, and deployment surfaces:
- Runtime configuration, environment variables, and infrastructure assumptions:
- 公开支持声明s and routes code must preserve:

## Ownership Boundaries

- Canonical owners for repeated rules or facts:
- Files or modules that own routing:
- Files or modules that own schemas and validation:
- Files or modules that own generated assets or package output:
- Files or modules that own deployment versioning and release metadata:

## Drift Risks

- Duplicated copy:
- 生成时间 output:
- Manual release steps:

## Update Mode

When this file already exists, merge cautiously. Preserve reviewed architecture, user preferences, customizations, coding standards, source evidence, checksums, deployment history, and accepted local patterns. Add missing sections or corrected facts with evidence. Record conflicts instead of overwriting silently.
.uai/constraints.uai
代码示例
---
uai: "1.0"
type: constraints
status: draft
---

# Constraints

## Hard Rules

- Do not expose secrets, credentials, private keys, tokens, customer data, or unreleased private material.
- Do not use destructive filesystem, database, production, or git operations unless explicitly approved.
- Do not widen support, certification, security, compliance, compatibility, or endorsement claims without evidence.
- Treat wiki notes, generated answers, dropped files, and old chats as background until promoted.
.uai/operations.uai
代码示例
---
uai: "1.0"
type: operations
status: draft
---

# Operations

## Normal Workflow

1. Load AI 记忆 files.
2. Inspect relevant code or docs.
3. Make narrow changes.
4. Run targeted checks.
5. Update memory when project truth changes.

## 发布版本 Workflow

- Package command:
- Smoke test:
- Rollback:
.uai/test-plan.uai
代码示例
---
uai: "1.0"
type: test-plan
status: draft
---

# Test Plan

## 默认 Rule

Run targeted checks for the files, routes, records, or behavior changed. Reserve full release sweeps for package builds, release candidates, broad launch-surface changes, migrations, or explicit human requests.

## If A 检查 Cannot Run

State the command, why it could not run, and what risk remains.
.uai/style.uai
代码示例
---
uai: "1.0"
type: style
status: draft
---

# Style

## Writing

- Be concrete and current.
- Separate current support from planned work.
- Prefer explicit links to source truth.

## Code

- Follow existing project patterns.
- Keep edits scoped.
- Avoid abstractions unless they reduce real drift or complexity.
.uai/coding-standards.uai
代码示例
---
uai: "1.0"
type: coding-standards
status: draft
---

# Coding Standards

This file is required for code-capable 项目交接 setup. Read it before code changes, and keep it aligned with the target codebase rather than generic preference alone.

## Codebase Reflection

- Inspect the codebase before drafting or changing standards.
- Identify the good parts already present: naming, layout, shared helpers, test style, validation, build commands, deployment flow, security boundaries, and owner preferences.
- Preserve those good parts as the first source of project-specific standards.
- Initial install must populate this file from visible evidence rather than leaving generic placeholders when facts are discoverable. Inspect AGENTS.md, existing .uai files, package manifests, source layout, framework config, route/API/schema owners, tests, CI, build/deploy scripts, release notes, public support surfaces, and owner instructions.
- If the project is new, create an initial standard from the selected language, framework, package manager, test runner, deployment target, security surface, review posture, and owner instructions. Use selected-stack industry standards where local code is sparse.
- Proof-of-concept standards should stay reversible and avoid production claims. Enterprise or production-facing standards should explicitly cover ownership, tests, security/privacy, CI/CD, observability, review gates, deployment, rollback, and documentation.
- Update mode must preserve existing reviewed facts, user preferences, customizations, coding standards, source evidence, and accepted local patterns; add missing or corrected sections with evidence instead of replacing the file wholesale.

## Required 默认s

- Prefer DRY design and do not repeat yourself when a shared helper, registry, template, fixture, or typed record can remove real duplication.
- Apply "once and only once": each business rule, route definition, schema shape, version value, support claim, validation rule, and deployment fact should have one canonical owner whenever practical.
- Apply SOLID principles by default: single-purpose units, extension without risky rewrites, substitutable contracts, narrow interfaces, and dependency direction that keeps policy decoupled from implementation details.
- Keep changes scoped, reversible, and aligned with existing architecture.
- Use structured APIs, parsers, and framework helpers instead of brittle string manipulation when available.

## Automated Testing

Automated testing is required no matter what language or framework the project uses. Record unit, integration, smoke, lint, type, format, route, package, or deployment checks in `.uai/test-plan.uai`.

For each code change, run targeted automated checks for the touched behavior. If no harness exists, create or document the smallest repeatable automated check before relying on manual verification. If a check cannot run, record the command, reason, and residual risk.
.uai/decisions.uai
代码示例
---
uai: "1.0"
type: decisions
status: draft
---

# Decisions

Record accepted decisions, why they were made, and what would cause a reversal.
.uai/memory.uai
代码示例
---
uai: "1.0"
type: memory
status: draft
---

# AI 记忆

AI 记忆 is durable, reviewable context that lets a future AI continue useful work without relying on private chat history.

## 数据包 Configuration

- 数据包: 人工智能记忆计划
- Use case: 当项目处于活动状态并且上下文必须在许多 AI 会话中持续存在且无需将捆绑包转变为完整的知识库时使用。
- 信任 boundary: 默认情况下内部或受控协作。在外部共享或提供给自主代理之前进行审查。

## UAI AI 记忆 And LLM Wiki

Use UAI AI 记忆 for compact, portable working packets. Use an LLM Wiki, NeuralWikis, AIWikis, docs, databases, or another durable system for deep, long-lived searchable memory.

Split Memory Architecture: keep hot `.uai` files active as compact short-term, startup, handoff, emergency-continuity, and operational memory. Durable memory augments `.uai`; it does not replace startup `.uai` memory or make `.uai` emergency-only after durable readback succeeds.

## Promotion Rule

1. Capture raw knowledge in notes, wiki pages, or source documents.
2. Review for accuracy, ownership, privacy, and support boundaries.
3. 提升 accepted project truth into AI 记忆, canonical docs, code, tests, release notes, or roadmap state.
4. Keep unreviewed material out of governing instructions.
5. Do not stop consulting active `.uai` files because a long-term memory plane exists.
.uai/next-recursive-prompt.uai
代码示例
{
  "uai_version": "1.0",
  "profile": "uaix.next-recursive-prompt.v1",
  "schema_version": 1,
  "scope": {
    "scope_id": "{{PACKAGE_SLUG}}",
    "scope_path": ".",
    "local_uai_root": ".uai/",
    "code_scope": true,
    "scope_basis": ["code", "automation", "executable-workflow", "code-like-artifact"],
    "requirement_rule": "Required for agents that deal with code, automation, executable workflows, or code-like artifacts: next-recursive-prompt.uai.",
    "out_of_scope_rule": "Out of scope for agents with no code, automation, executable workflow, or code-like artifacts: next-recursive-prompt.uai.",
    "source_boundary": "Derived from authoritative package files. This record is not a second source of truth."
  },
  "lifecycle": {
    "status": "active",
    "review_state": "current until superseded by accepted work or human review",
    "hot_memory_date_policy": "no dates, timestamps, dated headings, chronological sections, or date-stamped package filenames in this active file",
    "attempt": 1,
    "supersedes_checksum": ""
  },
  "activation_policy": {
    "activation_rule": "Use the stored next_loop plan when the user indicates continuation or resume intent, including keep going, continue, do the next thing, resume, proceed, or use the next recursive prompt.",
    "relevance_review_rule": "When a new user request directly relates to the stored next_loop, review this file for useful plan ideas before discarding or superseding it.",
    "intake_precedence_rule": "For packages using 代理文件交接, active Content or Improvement files that relate to the current prompt supersede or expand the stored next_loop. Intake must still lead to concrete project work, hot-memory update, ledger evidence, configured durable-memory preservation, and source-site removal before completion; retained files are unfinished human-hold or blocker states.",
    "current_instruction_rule": "When the user provides a specific unrelated instruction, current user instruction governs the turn and overwrites the stored next-loop plan.",
    "regeneration_rule": "After accepted work, update authoritative .uai records first, then regenerate .uai/next-recursive-prompt.uai from those records.",
    "next_prompt_visibility_rule": "At the end of accepted work, show a prominent, sectioned, detailed suggested next prompt to the human in chat so they can review, modify, replace, or simply answer keep going. The prompt must be a standalone, copy-paste-ready handoff and must include literal Feature/improvement focus, Code/source changes, and Automated tests/checks sections, plus context, objective, scope, hard boundaries, work items, expected touchpoints, files to review, done criteria, and final response contract. It must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition. Validation-only or no-source-change work must be labeled no-op/source-validation only, and the Code/source changes section must say no code/source changes plus the reason.",
  "goal_prompt_visibility_rule": "Use goal wording and functionality only when the current work was started from /goal, the human explicitly asked for /goal or a goal prompt, or the last accepted handoff was goal-shaped. Selecting Follow Goals support as an available runtime export does not by itself convert ordinary continuation into /goal. For true goal-origin continuation, label it Suggested 下一步 /goal Prompt, make the first copy-paste line start with /goal, include Goal, Success criteria, Constraints or hard boundaries, Verification, and still include literal Feature/improvement focus, Code/source changes, and Automated tests/checks sections with concrete next work or an explicit no-op/source-validation stop condition.",
    "non_activation_examples": ["A new unrelated feature request.", "A direct request to inspect, test, deploy, or explain a different target.", "A human correction that changes the work objective."]
  },
  "objective": {
    "task_id": "{TASK_ID}",
    "summary": "{CURRENT_GOAL}",
    "priority": "{PRIORITY}",
    "done_criteria": ["{SUCCESS_EVIDENCE}", "Authoritative .uai records are updated before this derived file is regenerated.", "No secrets, raw traces, or unreviewed cold-memory claims are copied into hot memory."]
  },
  "authoritative_refs": {
    "agents_md": "AGENTS.md",
    "readme_human": ".uai/readme.human",
    "memory_maintenance": ".uai/memory-maintenance.uai",
    "identity": ".uai/identity.uai",
    "world_context": ".uai/world-context.uai",
    "startup_memory_suite": ".uai/",
    "active_suite_read_order": ".uai/startup-packet.uai",
    "startup_packet": ".uai/startup-packet.uai",
    "system_profile": ".uai/system-profile.uai",
    "receiver_brief": ".uai/receiver-brief.uai",
    "coding_standards": ".uai/coding-standards.uai",
    "stack": ".uai/stack.uai",
    "architecture": ".uai/architecture.uai",
    "context": ".uai/context.uai",
    "constraints": ".uai/constraints.uai",
    "progress": ".uai/progress.uai",
    "decisions": ".uai/decisions.uai",
    "next_actions": ".uai/next-actions.uai",
    "test_plan": ".uai/test-plan.uai",
    "manifest": ".uai/exports/manifest.json"
  },
  "resume_context": {
    "current_truth_summary": ["Use the active .uai/ startup suite for current truth; .uai/startup-packet.uai is the read-order index.", "Do not create or load a single catch-all active memory file in place of typed .uai records.", "Use this file only to resume the next loop quickly after authoritative memory has been read.", "If this summary conflicts with authoritative refs, stop and regenerate this file from those refs."],
    "recent_changes": [],
    "active_blockers": [],
    "why_now": "A code-bearing package needs a compact next-loop resume artifact after authoritative files have been loaded."
  },
  "human_visible_plan": {
    "display_rule": "Show this plan prominently to the human in chat or review UI when the next-recursive prompt is generated, updated, or requested. Use literal section headings for context/objective, work items, Feature/improvement focus, Code/source changes, Automated tests/checks, files, done criteria, and final-response requirements. The chat version must be a standalone, prompt-shaped handoff block; it may shorten low-value repetition only when it remains copy-paste-ready and preserves those three required sections with actionable detail. It must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition. Validation-only or no-source-change work must be labeled no-op/source-validation only, and the Code/source changes section must say no code/source changes plus the reason. Do not hide the next loop only inside JSON, point to a file instead of showing the key sections, replace it with a generic validation loop, checklist-only outline, or vague keep-going sentence.",
    "editable_by_human": true,
"next_detailed_suggested_prompt": "Continue this UAIX 项目交接.\n\nContext: load authoritative .uai records first, then inspect the visible repository or environment.\nObjective: complete the first concrete 项目交接 setup improvement: populate missing .uai values from evidence, verify architecture.uai exists for code-bearing scope, add or update the mapped automated check, update memory, and report blockers.\n下一步 action type: setup-completion improvement unless visible evidence proves there is no drift; in that case report no-op/source-validation only with the stop condition.\nGoal-mode continuation: not selected in this example. Use Suggested 下一步 Prompt for ordinary prompt work; selecting Follow Goals support only creates runtime export material. Switch the visible continuation to Suggested 下一步 /goal Prompt only when the active work starts from /goal, the human explicitly asks for /goal or a goal prompt, or the last accepted handoff was goal-shaped.\nScope: use AGENTS.md, .uai/memory-maintenance.uai, .uai/system-profile.uai, .uai/architecture.uai, .uai/coding-standards.uai, .uai/test-plan.uai, .uai/exports/manifest.json, and current user instructions.\nHard boundaries: current user instruction wins; do not overwrite existing memory silently; do not modify Totem, Taboo, or Talisman without exact human artifact-and-operation authorization; do not claim hosted import, automatic repo writes, sync, certification, endorsement, SDK, or CLI behavior.\n\nWork items:\n1. Verify the generated file set - Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages. Expected output: missing required files are created or a blocker is recorded before broad work.\n2. Populate .uai values from visible evidence - Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason. Expected output: every placeholder is evidence-backed or marked not available - reason.\n3. Decide fresh setup versus additive update - Preserve reviewed facts and merge cautiously when existing memory is present. Expected output: the agent records fresh install or update mode and changed .uai files.\n4. Map codebase, architecture, and checks - Fill architecture, stack, coding standards, and test plan before coding. Expected output: architecture, stack, coding standards, and test plan name concrete files, commands, owners, and risks.\n5. Name the actionable next slice or declare no-op - State whether the next prompt is asking for a concrete feature, bug fix, improvement, test/check addition, package/publication step, or no-op/source-validation pass. Expected output: the human can tell what will be added, fixed, improved, tested, packaged, published, or deliberately not changed.\n\nFeature/improvement focus:\n- Fix vague next-prompt handoffs by naming the concrete feature, bug fix, improvement, or test/check addition that the next agent should perform, or by declaring no-op/source-validation only with a stop condition.\n- Make the handoff clear enough for the human to review and edit next action.\n- Keep generated ZIP, file deck, manifest, and live preview aligned.\n\nCode/source changes:\n- Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code.\n- If this is validation-only or no source patch is needed, explicitly say no-op/source-validation only and give the reason.\n\nExpected touchpoints: review the files and package/runtime surfaces listed below before deciding the next action.\nFiles to review:\n- AGENTS.md\n- .uai/memory-maintenance.uai\n- .uai/system-profile.uai\n- .uai/architecture.uai\n- .uai/coding-standards.uai\n- .uai/test-plan.uai\n- .uai/exports/manifest.json\n- .uai/next-recursive-prompt.uai\n\nTargeted checks: run the automated tests/checks below and add environment-specific checks for touched behavior.\nAutomated tests/checks:\n- Add or update a focused regression check when the next prompt contract changes; otherwise record no-op/source-validation only with the exact no-drift evidence.\n- Parse JSON 导出s that changed.\n- Run targeted checks for touched code, docs, routes, package files, or memory records.\n- Record skipped checks with exact reason and residual risk.\n\nDone criteria:\n- Required .uai files exist for the declared scope.\n- Initial values are populated from visible evidence or marked not available - reason.\n- Existing memory was preserved or conflicts were recorded.\n- Targeted checks ran or skipped checks are explained.\n- A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.\n- The Suggested 下一步 Prompt states a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition.\n- Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections.\n\nFinal response must include:\n- Changed files or explicit no-op/source-validation-only evidence.\n- Tests run plus skipped checks with reasons and residual risk.\n- Blockers, support-boundary risks, and publication/package status.\n- Memory records updated or why no memory update was needed.\n- Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.\n- A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant.",
    "work_items": [
      {"id": "verify-file-set", "title": "Verify the generated file set", "detail": "Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages."},
      {"id": "populate-visible-values", "title": "Populate .uai values from visible evidence", "detail": "Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason."},
      {"id": "choose-fresh-or-update-mode", "title": "Decide fresh setup versus additive update", "detail": "Preserve reviewed facts and merge cautiously when existing memory is present."},
      {"id": "map-codebase", "title": "Map codebase, architecture, and checks", "detail": "Fill architecture, stack, coding standards, and test plan before coding."}
    ],
    "feature_changes": ["Make the handoff prominent and sectioned enough for the human to review and edit next action.", "Keep generated ZIP, file deck, manifest, and live preview aligned."],
    "code_changes": ["Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code."],
    "test_plan": ["Parse JSON 导出s that changed.", "Run targeted checks for touched code, docs, routes, package files, or memory records.", "Record skipped checks with exact reason and residual risk."],
    "files_to_review": ["AGENTS.md", ".uai/memory-maintenance.uai", ".uai/system-profile.uai", ".uai/architecture.uai", ".uai/coding-standards.uai", ".uai/test-plan.uai", ".uai/exports/manifest.json", ".uai/next-recursive-prompt.uai"],
    "done_criteria": ["Required .uai files exist for the declared scope.", "Initial values are populated from visible evidence or marked not available - reason.", "Existing memory was preserved or conflicts were recorded.", "Targeted checks ran or skipped checks are explained.", "A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.", "The final response includes a standalone, prompt-shaped Suggested 下一步 Prompt block with enough detail for another agent to act without opening hidden memory; it may shorten low-value repetition only when all required sections remain present.", "The Suggested 下一步 Prompt states a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition.", "Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections."],
    "final_response_must_include": ["Changed files or explicit no-op/source-validation-only evidence.", "Tests run plus skipped checks with reasons and residual risk.", "Blockers, support-boundary risks, and publication/package status.", "Memory records updated or why no memory update was needed.", "Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.", "A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant."]
  },
  "next_loop": {
    "mode": "implement-then-verify",
    "first_response_contract": {
      "must_report": ["loaded context", "hard constraints", "expected touchpoints", "targeted checks"],
      "max_bullets": 6
    },
    "final_response_contract": {
"must_include": ["Changed files or explicit no-op/source-validation-only evidence.", "Tests run plus skipped checks with reasons and residual risk.", "Blockers, support-boundary risks, and publication/package status.", "Memory records updated or why no memory update was needed.", "Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.", "A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant.", "Suggested 下一步 /goal Prompt with a leading /goal line and Goal / Success criteria / Constraints / Verification wording only when the active work started from /goal, the human explicitly requested a goal prompt, or the last accepted handoff was goal-shaped."],
"next_detailed_suggested_prompt_requirements": ["context", "objective", "scope", "hard boundaries", "work items", "Feature/improvement focus", "concrete feature, bug fix, improvement, test/check addition, package/publication step, or no-op/source-validation stop condition", "code/source changes", "expected touchpoints", "files to review", "targeted checks", "Automated tests/checks", "done criteria", "final response contract", "Suggested 下一步 /goal Prompt with a leading /goal line only when the active work started from /goal, the human explicitly requested a goal prompt, or the last accepted handoff was goal-shaped"],
      "user_choice": "The human can edit the prompt, replace it, or answer keep going."
    },
    "prompt": "Continue this UAIX 项目交接.\n\nContext: load authoritative .uai records first, then inspect the visible repository or environment.\nObjective: complete the first concrete 项目交接 setup improvement: populate missing .uai values from evidence, verify architecture.uai exists for code-bearing scope, add or update the mapped automated check, update memory, and report blockers.\n下一步 action type: setup-completion improvement unless visible evidence proves there is no drift; in that case report no-op/source-validation only with the stop condition.\nGoal-mode continuation: not selected in this example. Use Suggested 下一步 Prompt for ordinary prompt work; selecting Follow Goals support only creates runtime export material. Switch the visible continuation to Suggested 下一步 /goal Prompt only when the active work starts from /goal, the human explicitly asks for /goal or a goal prompt, or the last accepted handoff was goal-shaped.\nScope: use AGENTS.md, .uai/memory-maintenance.uai, .uai/system-profile.uai, .uai/architecture.uai, .uai/coding-standards.uai, .uai/test-plan.uai, .uai/exports/manifest.json, and current user instructions.\nHard boundaries: current user instruction wins; do not overwrite existing memory silently; do not modify Totem, Taboo, or Talisman without exact human artifact-and-operation authorization; do not claim hosted import, automatic repo writes, sync, certification, endorsement, SDK, or CLI behavior.\n\nWork items:\n1. Verify the generated file set - Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages. Expected output: missing required files are created or a blocker is recorded before broad work.\n2. Populate .uai values from visible evidence - Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason. Expected output: every placeholder is evidence-backed or marked not available - reason.\n3. Decide fresh setup versus additive update - Preserve reviewed facts and merge cautiously when existing memory is present. Expected output: the agent records fresh install or update mode and changed .uai files.\n4. Map codebase, architecture, and checks - Fill architecture, stack, coding standards, and test plan before coding. Expected output: architecture, stack, coding standards, and test plan name concrete files, commands, owners, and risks.\n5. Name the actionable next slice or declare no-op - State whether the next prompt is asking for a concrete feature, bug fix, improvement, test/check addition, package/publication step, or no-op/source-validation pass. Expected output: the human can tell what will be added, fixed, improved, tested, packaged, published, or deliberately not changed.\n\nFeature/improvement focus:\n- Fix vague next-prompt handoffs by naming the concrete feature, bug fix, improvement, or test/check addition that the next agent should perform, or by declaring no-op/source-validation only with a stop condition.\n- Make the handoff clear enough for the human to review and edit next action.\n- Keep generated ZIP, file deck, manifest, and live preview aligned.\n\nCode/source changes:\n- Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code.\n- If this is validation-only or no source patch is needed, explicitly say no-op/source-validation only and give the reason.\n\nExpected touchpoints: review the files and package/runtime surfaces listed below before deciding the next action.\nFiles to review:\n- AGENTS.md\n- .uai/memory-maintenance.uai\n- .uai/system-profile.uai\n- .uai/architecture.uai\n- .uai/coding-standards.uai\n- .uai/test-plan.uai\n- .uai/exports/manifest.json\n- .uai/next-recursive-prompt.uai\n\nTargeted checks: run the automated tests/checks below and add environment-specific checks for touched behavior.\nAutomated tests/checks:\n- Add or update a focused regression check when the next prompt contract changes; otherwise record no-op/source-validation only with the exact no-drift evidence.\n- Parse JSON 导出s that changed.\n- Run targeted checks for touched code, docs, routes, package files, or memory records.\n- Record skipped checks with exact reason and residual risk.\n\nDone criteria:\n- Required .uai files exist for the declared scope.\n- Initial values are populated from visible evidence or marked not available - reason.\n- Existing memory was preserved or conflicts were recorded.\n- Targeted checks ran or skipped checks are explained.\n- A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.\n- The Suggested 下一步 Prompt states a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition.\n- Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections.\n\nFinal response must include:\n- Changed files or explicit no-op/source-validation-only evidence.\n- Tests run plus skipped checks with reasons and residual risk.\n- Blockers, support-boundary risks, and publication/package status.\n- Memory records updated or why no memory update was needed.\n- Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.\n- A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant.",
    "work_items": [
      {"id": "verify-file-set", "title": "Verify the generated file set", "detail": "Confirm required .uai files exist for the declared scope, including architecture.uai for code-bearing packages."},
      {"id": "populate-visible-values", "title": "Populate .uai values from visible evidence", "detail": "Replace placeholders with facts from source layout, manifests, tests, CI, deploy docs, routes, schemas, owner instructions, or write not available - reason."},
      {"id": "choose-fresh-or-update-mode", "title": "Decide fresh setup versus additive update", "detail": "Preserve reviewed facts and merge cautiously when existing memory is present."},
      {"id": "map-codebase", "title": "Map codebase, architecture, and checks", "detail": "Fill architecture, stack, coding standards, and test plan before coding."}
    ],
    "feature_changes": ["Make the handoff prominent and sectioned enough for the human to review and edit next action.", "Keep generated ZIP, file deck, manifest, and live preview aligned."],
    "code_changes": ["Preserve existing local patterns, DRY ownership, once-and-only-once facts, SOLID defaults, and framework-native APIs before editing code."],
    "test_plan": ["Parse JSON 导出s that changed.", "Run targeted checks for touched code, docs, routes, package files, or memory records.", "Record skipped checks with exact reason and residual risk."],
    "files_to_review": ["AGENTS.md", ".uai/memory-maintenance.uai", ".uai/system-profile.uai", ".uai/architecture.uai", ".uai/coding-standards.uai", ".uai/test-plan.uai", ".uai/exports/manifest.json", ".uai/next-recursive-prompt.uai"],
    "done_criteria": ["Required .uai files exist for the declared scope.", "Initial values are populated from visible evidence or marked not available - reason.", "Existing memory was preserved or conflicts were recorded.", "Targeted checks ran or skipped checks are explained.", "A prominent sectioned next prompt is shown to the human, not only stored in the file or compressed into a tiny paragraph.", "The final response includes a standalone, prompt-shaped Suggested 下一步 Prompt block with enough detail for another agent to act without opening hidden memory; it may shorten low-value repetition only when all required sections remain present.", "Validation-only or no-source-change results are labeled no-op/source-validation only and still include substantive Feature/improvement focus, Code/source changes, and Automated tests/checks sections."],
    "final_response_must_include": ["Changed files or explicit no-op/source-validation-only evidence.", "Tests run plus skipped checks with reasons and residual risk.", "Blockers, support-boundary risks, and publication/package status.", "Memory records updated or why no memory update was needed.", "Feature/improvement focus, Code/source changes, and Automated tests/checks sections with content; if no source patch was made, Code/source changes says no code/source changes and why.", "A prominent Suggested 下一步 Prompt section containing a copy-paste-ready prompt, not just labels. It must include literal sections named Feature/improvement focus, Code/source changes, and Automated tests/checks, plus context/objective, done criteria, and source/package/live boundaries. It must name a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicitly say no-op/source-validation only with a stop condition; a file reference, tiny footer, generic validation loop, or checklist-only outline is non-compliant."],
    "ordered_steps": [
      "Read AGENTS.md and .uai/memory-maintenance.uai before broad memory loading.",
      "Read and obey .uai/totem.uai, .uai/taboo.uai, and .uai/talisman.uai before broad execution; do not modify, weaken, replace, delete, or bypass any of those anchors without exact human artifact-and-operation authorization.",
      "Read the remaining ordinary .uai files named in authoritative_refs for the declared package scope.",
      "Verify .uai/architecture.uai exists for code-bearing scope and populate it from visible source, route, schema, build, test, deployment, and support-claim evidence.",
      "Populate new .uai values from what can reasonably be seen in the environment; use not available - reason only when a fact is not visible.",
      "When updating existing files, merge cautiously and preserve reviewed local facts instead of replacing them with generated defaults.",
      "Review .uai/next-recursive-prompt.uai for relevant ideas when the current request continues, resumes, or directly relates to the stored next loop.",
      "When 代理文件交接 is enabled, enumerate active Content 和 Improvement files; related intake supersedes or expands this next loop and must produce project work before configured durable-memory preservation and source-site removal.",
      "Verify workspace, identity, world context, memory-maintenance policy, constraints, coding standards, stack, architecture, current state, and test plan.",
      "Process active intake before unrelated work when file handoff is enabled.",
      "Implement the smallest safe improvement that advances the stated objective.",
      "Run targeted automated checks and record skipped checks with reasons.",
      "Update `.uai/progress.uai`, the relevant typed active `.uai` records, test plan, and this derived next-recursive prompt.",
      "Report changed files, automated tests/checks, blockers, and the next recursive work prompt.",
"End ordinary prompt work with a prominent, sectioned Suggested 下一步 Prompt that the human can review, modify, replace, or answer with keep going. End true /goal work with a prominent, sectioned Suggested 下一步 /goal Prompt whose first copy-paste line starts with /goal and preserves Goal / Success criteria / Constraints / Verification wording. Follow Goals export selection alone is not goal-origin and must not force a /goal continuation. Either form must identify a concrete next feature, bug fix, improvement, test/check addition, package/publication step, or explicit no-op/source-validation-only stop condition and include Feature/improvement focus, Code/source changes, and Automated tests/checks sections. If no source/code patch was made, label the result no-op/source-validation only and make Code/source changes explain no code/source changes plus the reason."
    ],
    "if_blocked": {
      "action": "emit-blocked-state",
      "required_updates": [".uai/progress.uai", ".uai/next-actions.uai", ".uai/next-recursive-prompt.uai"],
      "human_escalation_reason_template": "State the blocker, the safe next step, and the precise approval or evidence needed."
    }
  },
  "checks": {
    "required": ["PHP lint for touched PHP files", "JS syntax check for touched browser assets", "JSON/XML parse for touched machine records", "Playwright or rendered-route checks for touched wizard UI when available", "git diff --check"],
    "out_of_scope_for_this_scope": [],
    "last_known_results": []
  },
  "writeback_policy": {
    "authority_rule": "Derived hot-memory resume artifact; not a second source of truth. Authoritative .uai records win on conflict. Regenerate from authoritative handoff files after meaningful work.",
    "must_update_before_success": [".uai/startup-packet.uai", ".uai/progress.uai", ".uai/report-synthesis.uai when report or intake synthesis changes", ".uai/test-plan.uai", ".uai/intake-outcome-ledger.uai when file handoff is enabled", ".uai/next-recursive-prompt.uai"],
    "update_decisions_if_changed": ".uai/decisions.uai",
    "never_copy_into_hot_files": ["raw traces", "secrets", "private customer data", "large tool logs", "unreviewed cold-memory claims"],
    "conflict_rule": "Authoritative .uai records win on conflict. Regenerate this file from authoritative handoff files before using it again."
  },
  "security": {
    "approval_required_for": ["production deploy", "destructive repository operations", "schema boundary changes", "public support-claim widening"],
    "no_op_triggers": ["missing_authoritative_ref", "stale_constraints", "integrity_mismatch", "scope_conflict", "conflict_with_human_instruction", "conflict_with_repository_policy"],
    "escalation_triggers": ["support boundary would widen", "runtime behavior would be implied", "non-coding package would be made to look code-required", "code-bearing package lacks required coding memory"],
    "local_policy_wins": true
  },
  "cold_memory": {
    "refs": []
  },
  "provenance": {
    "trigger": "starter-template",
    "generated_by": "UAIX AI 记忆 starter template",
    "runtime_id": "",
    "issued_at_utc": "{GENERATED_AT_UTC}"
  },
  "integrity": {
    "canonicalization": "canonical-json",
    "yaml_mirror_allowed": false,
    "checksum": "sha256:{RECEIVER_COMPUTES_AFTER_WRITE}",
    "source_digests": [],
    "signatures": []
  }
}

人工智能内存属于什么

  • 项目概述、当前状态、决策、悬而未决的问题、下一步行动、风险、限制、所有者、术语表和代理说明。
  • 当代理需要可预测的加载路径时,根 AGENTS.md 加上本地内存文件,例如 .uai/readme.human
  • 当项目需要明确的上下文、堆栈、架构、约束、进度、操作、测试计划、样式、决策或内存规则时,键入 .uai 文件。
  • 仅当这些来源经过审查并明确标记为背景或宣传事实时,才会链接到更深层次的文档或 LLM Wiki 页面。

不应该包括什么

  • 秘密、凭证、私钥、令牌、连接字符串或未经审查的生产日志。
  • 原始客户、患者、员工或用户数据,除非存在安全批准的流程。
  • 私人法律分析、仅供内部使用的策略、定价、安全详细信息或不受支持的支持声明。
  • 旧的聊天记录、生成的摘要、删除的文件和 LLM Wiki 页面被视为未经审查的事实。
  • 未来代理可能无需人工批准即可运行的可执行有效负载。

隐私和信任边界

按信任边界而不是仅按名称选择捆绑包。内部项目人工智能内存比外部切换可以承载更多操作细节。代理会话内存会在配置文件需要时记录工具权限以及应快速存档的临时工作状态。外部移交、事件/审计和 LLM Wiki 导出数据包在共享之前需要经过编辑、批准和明确的源注释。

  • 每次共享之前检查机密和凭据。
  • 最大限度地减少客户或用户数据。
  • 标记仅限内部使用的策略和法律材料。
  • 命名代理权限和阻止的操作。
  • 优先选择经过净化的导出而不是原始内存。

维护模式

AI内存不是垃圾场。保持高流失率文件最新并保持持久文件稳定。 .uai/current-state.uai.uai/next-actions.uai 可能经常更改。 .uai/decisions.uai 应追加优先或仔细修改。每当权限、生产边界、支持声明或安全状况发生变化时,都应审查 .uai/risks-and-constraints.uai.uai/agent-instructions.uai.uai/archives/changelog.uai 应该解释有意义的捆绑包更新。

当数据包开始携带旧历史记录时,运行上下文节食。首先将预精简版本保存在冷内存中,记录源路径、最终路径、校验和、参与者、时间和处置,然后将活动文件缩短为当前事实加上指针。

代理如何消耗 AI 内存

  1. 行动前请阅读清单和前门文件。
  2. 仅加载包和当前任务所需的文件。
  3. 在广泛工作之前报告缺失、循环、矛盾、不可读或过大的记忆。
  4. 总结当前的事实、限制、预期接触点以及编辑前的检查。
  5. 将 LLM Wiki、旧聊天、生成的摘要和删除的文件视为背景,直到经过审核和升级。

站点、解决方案或工作空间布置

对于一个 WordPress 站点,将本地 .uai/ 文件夹保留在各个站点根目录中,并使用根 AGENTS.md 作为入口点。对于一种 Visual Studio 解决方案,请将 .uai/ 保留在实际的 .sln.slnx 文件旁边,然后将每个生成的 .uai 文件显式注册为解决方案项,以便它们显示在解决方案资源管理器中。磁盘上的物理文件夹本身是不够的。在这两种情况下,.uai/readme.human 和键入的 .uai 记录都保留在本地内存文件夹中。

对于经典 .sln 文件,这意味着为每个生成的文件添加一个 .uai 解决方案文件夹,其中包含 ProjectSection(SolutionItems) 条目。更新解决方案文件后,验证每个引用的 .uai 路径是否存在,如果解决方案已打开,则重新加载 Visual Studio。

仅当项目具有独立所有权、发布或移交边界时,才在 Visual Studio 解决方案中使用项目级 .uai/ 文件夹。在这种罕见的形式中,解决方案级别的 workspace.uai 可以协调这些项目文件夹;否则,更常见的协调器是跨多个解决方案路由的更高级别工作区或组织 workspace.uai

对于一个生态系统中的多个 WordPress 站点或 Visual Studio 解决方案,请使用 workspace.uai 作为本地 .uai/ 文件夹之外的唯一 UAI 内存文件。每个选定的站点或解决方案 AGENTS.md 应指向该协调器及其自己的本地 .uai/ 文件夹,并且代理应在加载本地内存之前解析显式的人工域、路由、存储库、解决方案或路径。所选目标的热内存加载;同级 .uai 包保持卸载状态,除非任务明确要求跨目标源路由、权限比较、包协调或存档保存。

如果包将引导部署,请包含一个工作区说明界面,其中指定部署所有者、共享版本策略、发布文件夹、安装目标、校验和或回滚证据以及任何混合堆栈差异。 WordPress 站点使用一致的主题/插件上传文件夹但.NET 解决方案部署不同的工作区应该在 workspace.uai 中表示,而不是让未来的代理从文件名推断它。

在依赖记住的绝对协调器路径之前,请验证协调器文件是否存在以及所选注册表根目录加上 AGENTS.md 路径是否已解析。如果指针已过时,请将 workspace.uai 定位到足以确认预期路由器的位置,修复或报告过时路径,并且当人类命名另一个目标时,永远不要默默地回退到当前 shell 目录。

这可以防止当前 shell 目录默默地赢得命名站点,例如 LLMWikis.org、UAIX.org、AIWikis.org 或其他相关工作空间根目录。

人类如何审查和认可记忆

人类应该能够查看人工智能将加载的相同文件。在共享捆绑包或使用它来引导自主代理之前,请检查所有权、日期、过时的声明、敏感数据、信任边界以及计划的工作是否与当前支持明确分开。要求人工智能准确说出哪些内存文件发生了变化以及原因。

UAIX AI 内存和 LLM Wiki

LLM Wiki 超出了基线 UAI 规范和标准的范围。 UAIX 支持将其作为 LLM Wiki 配置所需的深度内存策略,因为已经使用该策略的团队需要不同的包整形选择、源边界和升级规则。

UAIX AI 记忆 和 LLM Wiki 解决不同的内存问题。 UAIX AI 记忆 是一个便携式工作包,用于连续性、切换、入职、外部协作、审计、快速导出和代理就绪上下文。LLMWikis.org代表了深入、长期的内部文档和持久的组织知识的更强大的模式。

成熟的组织可以使用:LLM Wiki 作为持久的内部知识库,以及 UAIX AI 内存捆绑包作为便携式快照、工作上下文、入职导出、移交数据包、审计数据包或代理运行上下文。

何时使用 UAIX AI 内存

  • 当项目处于活动状态且上下文需要跨会话保留时,请使用 Project AI 记忆。
  • 当所有权、执行或责任发生变化时,使用项目移交。
  • 当 AI 代理需要可恢复的任务上下文时,请使用代理会话内存。
  • 当人员或代理需要策划的起点时,请使用入职记忆。
  • 当基本原理和权衡比状态更重要时,使用决策记忆。

何时使用 LLM Wiki

  • 当组织需要深入、持久、可搜索的机构知识时,请使用 LLM Wiki。
  • 将其用于长来源摘要、研究轨迹、比较、政策背景和内部教育。
  • 保持信息丰富而不是管理,直到公认的事实被提升为人工智能内存、文档、代码、测试、发行说明、路线图状态或公共证据。

何时同时使用两者

当持久的知识库需要便携式工作数据包时,请使用两者。 LLM Wiki 仍然非常广泛; AI 记忆 捆绑包仍然具有决定性作用。如果决定性的捆绑包开始像维基一样增长,请存档旧的详细信息并仅保留已接受的当前状态。实际操作路径请阅读将 UAI 包与 LLM Wiki 一起使用项目移交上下文预算。要了解更详细的原理,请阅读LLM Wiki 与 UAIX 项目移交LLM Wiki 和 UAIX 项目移交.

样本、清单和 ZIP 如何保持同步

渲染的示例文件、捆绑清单、下载链接和生成的 ZIP 都通过相同的规范注册表进行解析。没有过时的静态启动 ZIP 资源,也没有仅 ZIP 的示例文件。如果共享文件属于多个捆绑包,则通过相同的模板 ID 选择它。如果捆绑包需要变体,则变体是清单中记录的显式参数、选定部分或覆盖。

公共路线和别名

本主题的规范 UAIX 页面是 /en-us/ai-memory/。请求的 /AI_Memory 条目路径在此处重定向为搜索友好的条目别名,而规范的 UAIX 公共路由保持干净、以区域设置为前缀的路径。

相关 UAIX 记录

长期目标执行

使用长期目标执行当 AI 记忆 必须承受多个运行时会话、暂停、阻塞、切换或最终报告时。运行时目标使活动目标保持集中;权威的 .uai 文件保留持久的项目真相; UAI-1 数据包携带便携式证据;经过审查的回写促进了公认的事实。

分层目标记忆

使用分层目标记忆当 AI 记忆 需要子目标、折叠、检查点和有界证据的源链接层次结构时,而不替换规范源文件。