指南

将 UAIX 内存文件与 OpenAI 遵循目标结合使用

使用 Codex Goal 模式或 OpenAI 结构化提示的默认关闭配置特定运行时覆盖指南,而 UAIX 内存文件仍然是经过审查的持久事实来源。

  • 记录 UAIX-DOC-2236
  • 路径 /zh-cn/guides/project-handoff-openai-follow-goals/
  • 用途 规范公共记录

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-DOC-2236
页面类型
指南
访问
公开且可链接

如何使用此页面

将此页面用作 将 UAIX 内存文件与 OpenAI 遵循目标结合使用 及其标准内容的规范公共参考。

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

遵循目标可以帮助 OpenAI 运行时保持专注,但 UAIX 内存文件仍然是持久的事实来源。当接收者想要 Codex 目标模式或 OpenAI 结构化提示来承载源自已审核的 UAIX 项目移交捆绑包的可衡量目标时,请使用本指南。

此页面故意缩小。它描述了一个默认关闭、特定于配置的运行时覆盖,用于以 OpenAI 为中心的工作。它不会将 UAIX 转换为 OpenAI 运行时、官方适配器、SDK、CLI、托管导入程序、存储库编写器、认证程序或本机 API 目标字段提供程序。

此页面的用途

  • 当切换应包括一个明确的运行时目标、成功标准、约束、验证表面和参考文件时,请使用它。
  • 待接收器正常后使用项目交接文件和特定于运行时的工作开始之前。
  • 使用它可以将 OpenAI 运行时目标与经过审查的持久内存分开,直到结果被接受并写回。
  • 使用更广泛的OpenAI 和 Codex 指南当您需要 OpenAI 代理的完整项目切换模式时。

层分割

层分割
层工作耐用性
UAIX 内存文件保留当前的事实、限制、决策、验证计划、接收者简报和经过审查的回写。耐用项目内存正在审查中。
法典目标模式让 Codex 应用程序、IDE 或 CLI 会话始终指向一个持久目标,选择时首先进行规划。运行时会话状态,本身不接受内存。
OpenAI 结构化提示为 OpenAI API 或聊天工作流程提供明确的目标/成功标准/约束/参考/验证块。运行时提示状态,本身不接受内存。
.uai/exports/follow-goal.json选择向导设置后,将运行时覆盖作为结构化导出材料进行传输。使用 /goal 的接收器环境需要特定配置;从切换中生成,而不是新的持久内存源。

向导设置

  1. 打开AI内存封装向导.
  2. 首先配置正常的项目切换包,包括启动包、接收者简介、约束、测试计划、进度以及包系列需要的下一个递归提示。
  3. 在第7步中,打开替代方案:遵循目标。默认情况下它是关闭的。
  4. 选择 Codex 目标模式、OpenAI 结构化提示块或两者。
  5. 输入适合 Codex 目标文本的主要目标,并将详细信息移至引用的 UAIX 文件中。
  6. 足够明确地列出成功标准、约束、验证表面和参考,以便人们可以在接收器开始之前修改下一个操作。
  7. 当接收方使用/goal时,将.uai/exports/follow-goal.json保留在包中作为配置特定所需的统一记录。

默认参考文献

跟随目标覆盖应该将运行时指向接收者已经需要的相同的持久项目切换文件:

  • .uai/startup-packet.uai 用于启动读取顺序和设置边界。
  • .uai/receiver-brief.uai 用于第一个任务、成功证据和切换框架。
  • .uai/constraints.uai 用于硬边界和支持声明限制。
  • .uai/test-plan.uai 用于检查和验收证据。
  • .uai/progress.uai 和相关类型的活动 .uai 记录用于查看状态和写回。

法典目标路径

对于 Codex 应用程序、IDE 或 CLI 工作,运行时覆盖可以生成简短的 /goal 命令和计划优先提醒。当目标需要细化时,首先使用 /plan ,当目标文本变得太长时,将详细说明保留在文件中。

代码示例
/plan Refine the UAIX handoff into a concrete, testable goal before execution.
/goal Complete the receiver task using the generated UAIX memory files, preserve constraints, run targeted checks, and record evidence before stopping.

Codex 运行时目标不会替换 AGENTS.md、.uai/readme.human、.uai/startup-packet.uai 或键入的 .uai 记录。它应该来自他们,并在审查后才报告给他们。

OpenAI API 路径

对于 OpenAI API 使用,请将关注目标视为结构化提示块,而不是本机顶级 API 目标参数。保持提示明确并附加或引用带有持久内存的相同文件。

代码示例
Role: You are an agent using UAIX files as reviewed durable context.

# Goal
Complete the receiver task with verifiable evidence.

# Success criteria
- Current truth and constraints are summarized before broad work.
- Changed files, checks, skipped checks, blockers, and owners are recorded.

# Constraints
- UAIX memory files remain the durable source of truth.
- Runtime output is not accepted memory until reviewed.

# Verification
- Use .uai/test-plan.uai and .uai/progress.uai as the evidence route.

当运行时支持文件输入或持久对话状态时,使用这些 OpenAI 机制来提供 UAIX 引用。请勿声称 UAIX 发布本机 OpenAI 目标字段、官方导入程序或自动存储库写回。

审查和写回

  1. 在工作开始之前,接收者应该总结当前的事实、约束、接触点和有针对性的检查。
  2. 在工作期间,运行时状态可以是活动的或暂停的,但暂停原因和恢复条件应该明确。
  3. 工作结束后,仅将已审核的已接受事实提升到 .uai/progress.uai、.uai/decisions.uai、相关类型化活动 .uai 记录、.uai/test-plan.uai、发行说明、代码、测试或其他权威记录中。
  4. 将原始运行时跟踪、提示和生成的摘要保留在持久内存之外,除非出于指定目的对其进行审查、编辑和摘要。

有条件的目标型完成交接

仅当工作从 /goal 开始、人员明确要求 /goal 或目标提示、或者最后接受的移交是目标形状时,才使用目标措辞和功能。选择替代:遵循目标作为可用运行时导出本身不会将普通延续转换为 /goal。对于真正的目标起源工作,以建议的下一个/目标提示,不仅仅是通用的建议下一个提示,使复制粘贴块以 /goal 开头,并包括目标、成功标准、约束或硬边界、验证、功能/改进重点、代码/源代码更改和自动测试/检查,以便人类可以在另一个代理继续之前引导下一个目标。

验证期望

  • 当选择“遵循目标”但没有主要目标、没有成功标准或没有验证表面时发出警告或阻止。
  • 当暂停的目标缺少暂停原因或恢复条件时发出警告。
  • 当覆盖声明官方 OpenAI 适配器支持、托管导入、SDK、CLI、认证、运行时编排、自动存储库写入或本机响应 API 目标支持时发出警告。
  • 保持 /goal 接收器环境所需的 .uai/exports/follow-goal.json 配置特定;不选择“遵循目标”的通用启动基线包会使该文件超出范围。

与本指南配合使用的 OpenAI 文档

支持边界

  • 目前支持:向导指南、接收器文本、Codex /goal 切换文本、结构化 OpenAI 提示文本以及 .uai/exports/follow-goal.json 作为 /goal 接收器环境的配置特定所需导出。
  • 当前不支持:官方 OpenAI 适配器、托管导入器、SDK、CLI、认证、认可、运行时协调器、存储库编写器、自动跟踪导入器、自动内存提升或本机响应 API 目标字段。
  • 持久的事实来源:审查了 UAIX 内存文件、公共 UAIX 页面、发行说明、代码、测试和已接受的项目记录。

相关 UAIX 记录

长时间运行的工作

对于扩展或可中断的目标,请使用长期目标执行。 FollowGoals 携带运行时目标;权威的 .uai 文件带有持久检查点; UAI-1 任务状态、阻止程序、切换、内存建议和最终报告数据包携带便携式证据。运行时输出在经过审查和写回之前不会被接受到内存中。