指南

长期目标执行

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

  • 记录 UAIX-DOC-3295
  • 路径 /zh-cn/guides/long-running-goal-execution/
  • 使用 规范公共记录

文件状态

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

如何使用本页

使用本指南可以使长时间运行的代理目标保持可中断、检查点、审查门控,并写回到权威的 UAIX 内存中,而不是隐藏的运行时状态。

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

在旁边使用

遵循目标指南项目交接.uai 文件指南代理沟通

不间断的目标工作

检查长时间运行的工作,无需将 UAIX 转换为运行时

使用本指南编写 .uai 内存、遵循目标覆盖、UAI-1 代理数据包、检查点、阻止程序、交接、最终报告以及可能暂停或恢复的工作的审阅回写。

运行时

外部运行时执行

Codex、OpenAI 代理、本地代理、工作流引擎或人类自己的执行、工具、批准、跟踪、重试和托管运行时状态。

记忆

UAIX 文件保持权威

只有在审查并写回 .uai 记录、文档、代码、测试、发行说明、路线图状态或机器工件后,运行时状态才会成为持久的项目事实。

数据包

现有 UAI-1 配置文件的检查点

使用任务状态、阻止程序、切换、内存建议、最终报告和纠正数据包,而不是发明新的长期运行模式。

边界

没有托管编排声明

本指南不是调度程序、托管内存数据库、官方适配器、SDK、CLI、认证程序、自动存储库编写器、托管导入程序或自动同步表面。

在旁边使用

遵循目标指南使用 /goal 或结构化目标提示的环境的运行时目标覆盖。项目交接权威的repo-本地内存和切换边界。.uai 文件指南用于检查点和回写的类型化内存文件。代理沟通任务状态、阻止程序、切换、内存建议、最终报告和纠正数据包。OpenAI/Codex 指南使用 OpenAI 和 Codex 运行时,无需将持久内存移至运行时。编码剂指南带有代码的恢复规则和下一个递归提示边界。上下文预算指南热/冷内存升级和压缩规则。AI 记忆数据包向导针对跟随目标、多代理通信和代码承载延续的配置特定包指南。验证器仅在实际实施检查时使用当前验证器行为。变更日志指南级更新的公开发布轨迹已注明日期。
目标交接可复制的长期运行目标框架
/goal Finish the next bounded work chunk using authoritative UAIX memory, not the last chat turn.

Success criteria:
- Complete the bounded subtask or emit a blocker.
- Run targeted checks or name skipped checks with reasons.
- Record checkpoints, blockers, handoffs, memory proposals, and final evidence with existing UAI-1 profiles where applicable.
- Write accepted facts back to authoritative .uai files after review.

Feature/improvement focus:
- Keep long-running work interruptible, review-gated, and resumable.

Code/source changes:
- Regenerate next-recursive-prompt only after authoritative write-back for code-bearing scopes.

Automated tests/checks:
- Use .uai/test-plan.uai, focused touched checks, final-report evidence, and skipped-check reasons.

当接收器可以运行 /goal,而持久内存保留在 UAIX 文件中时,请使用此选项。

长时间运行的目标执行使可中断的代理工作保持可见、可恢复和审查。当项目组合 UAIX .uai 内存文件、遵循目标样式的运行时目标、UAI-1 任务数据包、检查点、阻止程序、切换、最终报告和权威写回时,请使用本指南。

这是一个文档和证据模式。运行时、IDE、工作流引擎、人工操作员或代理平台仍然拥有执行、调度、工具访问、批准、跟踪和托管内存。

此页面的用途

  • 规划可能在多个座席会话中中断、恢复、委派、暂停或完成的长期工作。
  • 保持活动运行时目标较小,同时持久项目内存保留在 AGENTS.md.uai/readme.human、键入的 .uai 记录中,并审查公共或本地证据。
  • 将检查点、阻止程序、切换、内存建议和最终报告映射到现有的 UAI-1 代理数据包配置文件中,而无需发明新模式。
  • 在任何运行时结果成为可接受的项目事实之前,为人们提供清晰的审查路径。

这不是什么

  • 不是 UAIX 托管的运行时、调度程序、队列、守护程序、工作流引擎、内存数据库、向量存储、跟踪存储或编排服务。
  • 不是官方 OpenAI 适配器、本机 OpenAI 目标字段、SDK、CLI、托管导入程序、存储库编写器、自动 LLM Wiki 同步、认证、认可或一致性计划。
  • 无权运行工具、部署、发布、身份验证、访问机密、改变内存、扩大公共支持声明或绕过本地政策。
  • 不是将原始痕迹、私有日志、隐藏提示、秘密或未经审查的生成摘要复制到持久内存中的理由。

分层分割

角色 耐用的? 示例 规则
UAIX 权威内存 当前的操作真相、约束、进度、决策、测试态势、所有者和下一步行动。 是的,当审查并接受时。 AGENTS.md, .uai/readme.human, .uai/short-term-memory.uai, .uai/progress.uai, .uai/current-state.uai, .uai/next-actions.uai, .uai/decisions.uai, .uai/constraints.uai, .uai/test-plan.uai. 权威的运行时摘要。
遵循目标运行时覆盖 受益于结构化规划的运行时的简洁主动目标。 不,不是单独的。 .uai/exports/follow-goal.json/goal 提示、结构化目标/成功标准/约束块。 由权威记忆生成;不取代它。
UAI-1 代理数据包 便携式状态、阻止程序、切换、内存建议、最终报告、更正和验证证据。 审查记录,而不是执行本身。 uai.agent.task-status.v1, uai.agent.blocker.v1, uai.agent.handoff.v1, uai.agent.memory-proposal.v1, uai.agent.final-report.v1. 在运行时在其他地方执行时记录证据和边界。
外部运行时 执行工具、代码编辑、检查、批准、跟踪、编排、重试和会话状态。 特定于运行时的。 OpenAI 代理、Codex、编码代理、Carcinus、LocalEndPoint、MCP/A2A 客户端、内部工作人员或人工/操作员循环。 运行时输出仅在审查和写回后才变为 UAIX 内存。
冷记忆/图表/存档 出处、来源历史、分支探索、旧报告、被拒绝的路径和长期研究。 是的,作为背景证据。 LLM Wiki、AIWikis 存档、图形投影、源快照、传输清单。 在经过审查和提升之前,不会主动项目真相。

规范的长期目标模式

  1. 加载切换前门和所需的 .uai 文件。
  2. 在广泛工作之前,说明目标、成功标准、硬性边界、验证计划、预期接触点和检查点节奏。
  3. 在外部运行时运行一个有界切片。
  4. 当可能发生有意义的状态更改或中断时,发出检查点数据包。
  5. 当无法安全解决同一障碍时,发出阻止包。
  6. 当另一个代理、人员、运行时或未来会话必须继续时发出切换数据包。
  7. 发出候选持久事实的内存建议包;在经过审查之前,不要将它们写为事实。
  8. 当目标完成或明确关闭时,发出最终报告数据包。
  9. 将接受的结果写回到权威记录中,然后仅在有用时存档或引用原始运行时材料作为证据。

所需的阅读顺序

  1. 当前的人类指导和当地政策。
  2. AGENTS.md.uai/readme.human 作为项目前门。
  3. .uai/memory-maintenance.uai、受保护的活动指令锚点和 .uai/short-term-memory.uai
  4. .uai/startup-packet.uai.uai/system-profile.uai.uai/receiver-brief.uai(当项目移交时)。
  5. .uai/constraints.uai.uai/progress.uai.uai/decisions.uai.uai/test-plan.uai 以及工作涉及代码时的代码范围记录。
  6. .uai/exports/follow-goal.json 仅当接收器环境使用“跟随目标”或 /goal 时。
  7. 在不相关的广泛工作之前进行主动代理文件交接。
  8. 冷内存或 LLM Wiki 来源仅在紧凑的当前内存和边界清晰之后。

检查点的文件映射

需要 权威文件 更新触发器 笔记
紧凑的主动工作状态 .uai/short-term-memory.uai 在有意义的工作、移交、部署、接收处理、阻止程序更改或压缩之后。 保持简洁和最新。
已完成/已验证的工作 .uai/progress.uai 在有意义的工作段、测试通过、阻碍解决或发布准备步骤之后。 记录发生了什么变化以及存在什么证据。
当前的准备状态/姿势 .uai/current-state.uai 测试运行、部署、阻止程序更改或状态更改后。 包括准备情况、主动拦截器状态和当前姿势。
有序队列 .uai/next-actions.uai 当优先级、下一步、所有者或阻止者状态发生变化时。 包括确切的下一步行动。
持久的决定 .uai/decisions.uai 当被接受、替换、逆转或证明过时时。 包括原因、证据、所有者和替换路径。
限制和红线 .uai/constraints.uai 当支持边界、秘密策略、破坏性操作限制或权限变更时。 不要通过运行时状态来削弱。
验证表面 .uai/test-plan.uai 当有针对性的检查、全面扫描触发或验收证据发生变化时。 姓名跳过检查并说明原因。
带有代码的简历 .uai/next-recursive-prompt.uai 接受带码工作并权威回写后。 仅派生热内存;不是第二个真相来源。
风险与审批 .uai/risk-register.uai.uai/owners.uai 当风险、审阅者、所有者或批准边界发生变化时。 高风险或业主控制的工作所需。
运行时目标叠加 .uai/exports/follow-goal.json 当接收器环境使用 /goal 或等效目标状态时。 配置特定的运行时视图;不持久的真理。

运行时数据包映射

情况 首选包 所需行为
通用异步状态 uai.task.status.v1 仅当需要任务 ID、状态、主题、进度、状态消息和结果引用时使用。
座席通讯状态 uai.agent.task-status.v1 当关联链接的进度、完成百分比、当前操作、支持边界、幂等性、超时、回退或 UTC 估计很重要时使用。
不安全或未指定的延续 uai.agent.blocker.v1 用于授权、访问、模糊性、不支持的功能、系统故障、验证失败、秘密、破坏性操作或边界冲突。
持久事实候选人 uai.agent.memory-proposal.v1 仅用于建议的持久事实;保持任务执行分离明确。
所有权转让 uai.agent.handoff.v1 当另一个参与者、运行时或人类应该继续时使用;包括目标演员和确切的下一步行动。
完成证据 uai.agent.final-report.v1 包括摘要、更改的文件、新文件、运行的测试、跳过的检查、阻止程序、风险、验证证据、建议的内存更新、跳过的内存更新以及确切的下一步操作。
更正 uai.agent.correction.v1 当先前的数据包或状态语句需要更正时,用于保留不可变的历史记录。

检查点节奏

  • 在每个有意义的源更改、发布步骤、迁移步骤或审查的证据更新之后设置检查点。
  • 上下文压缩、长时间等待、工具切换、进程中断或切换代理之前的检查点。
  • 在扩展权限、更改受保护内存、发布、部署或接触秘密相邻系统之前进行检查点。
  • 验证状态从未运行变为通过、失败、跳过或阻止时的检查点。
  • 不要过于频繁地检查点,以免噪音取代进度;每个检查点都应该回答哪些内容发生了变化,哪些内容仍然存在,哪些证据存在,以及哪些内容可以安全地恢复。

最小检查点有效负载:任务或相关 ID、当前操作、已完成的工作、生成的证据、运行的测试/检查、跳过的测试/检查及其原因、活动阻止程序、风险、文件或路线更改、建议的内存更新、有意跳过的内存更新、确切的下一步操作以及 UTC 时间戳。

中断和恢复流程

  1. 在安全边界上停止:保存文件,避免半写版本,并且不要让破坏性操作挂起。
  2. 使用 UTC 时间、当前切片、已完成的工作、更改的文件、检查、阻止程序以及恢复命令或提示编写任务状态检查点。
  3. 仅使用已接受或明确标记的候选事实更新 .uai/short-term-memory.uai.uai/progress.uai
  4. 恢复时,在使用旧聊天上下文之前重新加载当前指令、前门内存、主动摄入和最新检查点。
  5. 仅当无法从可见证据中解决阻塞并且合理的假设存在风险时,才总结恢复的状态并请求人工输入。

状态流:LoadAuthoritative -> BuildRuntimeGoal -> Working -> 检查pointed -> Working。如果缺少批准、上下文、能力或证据,请移至 Blocked。如果另一个参与者应该继续,请移至 Handoff。当满足完成条件时,移至 Finalized,然后移至 WriteBack,然后停止。

代码示例
Resume task <task_id> using the authoritative handoff bundle, not the last chat turn.
Load AGENTS.md, .uai/readme.human when present, .uai/memory-maintenance.uai, identity, world-context, active instruction anchors, short-term-memory, current-state, progress, next-actions, constraints, decisions, and test-plan.
If code-bearing, also load .uai/next-recursive-prompt.uai only as derived hot memory.
Reconstruct:
- last accepted checkpoint
- unfinished subtask
- active blockers
- required checks
- exact next action
If any conflict is unresolved, emit uai.agent.blocker.v1 instead of guessing.

冲突解决阶梯

  1. 人类明确的工件和操作授权控制受保护的锚点突变。
  2. .uai/memory-maintenance.uai.uai/totem.uai.uai/taboo.uai.uai/talisman.uai 管理内存生命周期和受保护的边界。
  3. AGENTS.md.uai/readme.human 提供条目记录和本地项目指令。
  4. 权威的.uai文件控制当前项目的真相。
  5. 当前公共 UAIX 页面、代码、测试、发行说明、路线图状态、验证器证据和机器工件管理公共支持声明。
  6. 除非经过审查和升级,否则遵循目标导出、下一个递归提示、任务状态包、运行时摘要、图形投影和冷内存注释都是从属的。
  7. 旧的聊天记录、原始日志、旧的报告、未经审查的存档注释和检索答案仅是来源线索。

如果冲突仍然存在,请停止广泛的工作,发出阻止程序,命名冲突的工件,命名最安全的下一个审查操作,并且不要默默地合并或覆盖持久内存。

代码范围规则

  • 对于代码、自动化、可执行工作流程或类似代码的工件,在进行广泛编辑之前需要架构、编码标准、约束、进度、测试计划和下一个递归提示记录。
  • 在更改代码之前绘制预期的接触点、风险和有针对性的测试。
  • 运行与触摸行为匹配的重点语法、单元、集成、静态、包、区域设置、路由或浏览器检查。
  • 切勿在没有证据的情况下声称部署、发布、包上传、自动存储库写入、SDK、CLI、官方适配器、认证或背书。

非代码范围规则

  • 对于写作、研究、治理、本地化、搜索引擎优化、政策或规划,需要源注释、当前公共表面、支持边界审查和最终证据路径。
  • 未经审查,请勿综合规范标准文本、翻译或政策权威。
  • 仅当没有具体的功能、错误、改进、测试/检查、打包或发布工作需要执行并明确说明停止条件时,才使用无操作/源验证。
  • 将人性化的解释保存在 .human 文件中,将 AI 指令文本保存在 .uai 文件中,将结构化数据保存在 .uai/ 内的 .json 文件中。

热上下文和冷记忆

热门上下文是下一个代理默认应该加载的内容:当前状态、约束、决策、主动阻止者、下一步行动、有针对性的检查和最近接受的结果。冷记忆是可恢复的来源:长报告、旧聊天记录、原始痕迹、研究快照、存档摄入量和庞大的理由。冷记忆可以为未来的工作提供信息,但只有当回顾的事实被提升到当前记录中时,它才会变得活跃。

分层代理模式

长期运行的项目可以使用协调员和专家工作者,但 UAIX 记录切换,而不是实时层次结构。协调员负责目标框架、阅读顺序、冲突检查、检查点审查、内存建议和最终报告。工作代理拥有有界任务并返回任务状态、阻止程序、切换或最终报告数据包。人工审查仍然控制着受保护的内存、公开声明、发布和部署。

新情境评估

当新的代理评估工作时,它应该加载最新的权威文件,忽略私人聊天内存(除非明确提供),将声明与源证据进行比较,运行或审查有针对性的检查,并决定先前的输出是否被接受、拒绝、部分接受或需要阻止程序。新鲜的背景很有用,因为它可以捕捉到长时间会话可能正常化的偏差。

向导设置

  1. 打开AI内存封装向导.
  2. 选择项目交接或与工作匹配的其他代码/项目包。
  3. 根据可见证据填充启动数据包、接收者简介、约束、进度、决策、测试计划和代码范围文件。
  4. 仅当接收方使用 /goal 或等效的运行时目标覆盖时才启用跟随目标。
  5. 确保 .uai/exports/follow-goal.json 指定一个活跃目标、成功标准、硬边界、验证、检查点节奏和回写目标。
  6. 完成目标后,当前工作从 /goal 开始或遵循目标时,显示建议的下一个 /goal 提示;否则显示建议的下一步提示,并具有相同的具体下一步工作规则。

验证期望

  • 当活动目标缺乏成功标准、约束、验证、检查点节奏或回写目标时发出警告。
  • 当检查点缺少 UTC 时间、当前状态、已完成工作、剩余工作、阻止程序状态、证据或恢复条件时发出警告。
  • 当内存提案在审查之前被写为公认的事实时发出警告。
  • 当最终报告忽略更改的文件、检查、跳过的检查、阻止程序、包/发布状态、内存更新或可见的下一个提示时发出警告。
  • 当公共副本暗示 UAIX 托管执行、自动同步、官方适配器、SDK、CLI、认证、认可或没有证据的生产发布时发出警告。

如果当前验证器还无法强制执行这些期望之一,请将其声明为文档指南或未来验证器工作。在架构、示例、验证器检查、一致性证据和发行说明达成一致之前,请勿将其描述为当前验证器行为。

可复制的提示

提示 A:父目标运行时导出

代码示例
Goal:
Finish the next bounded work chunk for this project without widening support claims or violating hard constraints.

Success criteria:
- The bounded subtask is complete or a concrete blocker is recorded.
- Targeted checks are run or explicitly skipped with a reason.
- Accepted facts are written back to authoritative UAIX files.
- Runtime status, blockers, handoffs, memory proposals, and final evidence are packetized where applicable.
- A concrete next action is left for continuation.

Constraints:
- Authoritative truth is AGENTS.md plus the listed .uai files.
- Do not treat old chats, raw traces, graph retrieval, or large reports as current truth.
- Do not promote secrets, tokens, credentials, private keys, hidden prompts, or unreviewed cold-memory claims.
- If approval, context, capability, or evidence is missing, stop with a blocker.

Verification:
- Read .uai/test-plan.uai.
- Run targeted checks or name skipped checks.
- Use final-report evidence before completion.
- Write accepted changes back to authoritative files only after review.

提示B:子任务执行提示

代码示例
Read AGENTS.md first, then .uai/readme.human if present, then the relevant .uai files for this subtask.
Summarize current truth, hard constraints, expected touchpoints, and targeted checks.
Complete only this bounded subtask:
<subtask description>

After any meaningful change:
- update short-term-memory/progress/current-state/next-actions as appropriate;
- emit uai.agent.task-status.v1 when external runtime continuity matters;
- emit uai.agent.blocker.v1 if blocked;
- emit uai.agent.handoff.v1 if another actor should continue;
- emit uai.agent.memory-proposal.v1 only for candidate durable facts;
- close with uai.agent.final-report.v1 when the segment ends.

If this is code-bearing, regenerate next-recursive-prompt only after authoritative write-back.
Do not guess through unresolved conflicts.

提示C:监控代理提示

代码示例
Monitor correlation_id <id>.
At each checkpoint require:
- percent complete
- current action
- blocker state
- checks run or pending
- skipped checks and reasons
- files/routes/artifacts changed
- memory updates proposed or skipped
- exact next action
- UTC timestamp

If a blocker persists across two checkpoints, require escalation or handoff.
If authoritative files drift from runtime status, prefer authoritative files and request reconciliation.

提示D:中断后恢复

代码示例
Resume task <task_id> using the authoritative handoff bundle, not the last chat turn.
Load AGENTS.md, .uai/readme.human if present, .uai/memory-maintenance.uai, identity, world-context, totem, taboo, talisman, short-term-memory, current-state, progress, next-actions, constraints, decisions, and test-plan.
If code-bearing, also load next-recursive-prompt only as derived hot memory.
Reconstruct:
- last accepted checkpoint
- unfinished subtask
- active blockers
- required checks
- exact next action

If any conflict is unresolved, emit a blocker instead of guessing.

数据包序列示例

代码示例
{
  "uai_version": "1.0",
  "profile": "uai.agent.task-status.v1",
  "message_id": "uaix-long-goal-status-20260613T210000Z",
  "source": { "id": "agent:worker-1" },
  "target": { "id": "project:example" },
  "body": {
    "task_id": "goal-20260613-001",
    "status": "checkpoint",
    "checked_at_utc": "2026-06-13T21:00:00Z",
    "completed": ["Read authoritative .uai files", "Patched guide source"],
    "remaining": ["Run static discovery test", "Update memory"],
    "evidence": ["git diff", "PHP lint pending"]
  }
}

{
  "uai_version": "1.0",
  "profile": "uai.agent.memory-proposal.v1",
  "message_id": "uaix-memory-proposal-20260613T211500Z",
  "body": {
    "proposal": "提升 the long-running goal guide as current UAIX guide-level operating recipe.",
    "target_records": [".uai/progress.uai", ".uai/short-term-memory.uai"],
    "review_required": true
  }
}

{
  "uai_version": "1.0",
  "profile": "uai.agent.final-report.v1",
  "message_id": "uaix-long-goal-final-20260613T213000Z",
  "body": {
    "status": "complete",
    "changed_files": ["wp-content/themes/uaix-authority-theme/functions.php"],
    "checks": ["php -l", "static discovery assets"],
    "publication_status": "source-only; no live publication claimed"
  }
}

支持边界

  • 目前支持:指南级配方、公共页面、交叉链接、向导指导、选择时生成的“关注目标”导出以及现有的 UAI-1 代理数据包配置文件。
  • 当前不支持:托管执行、调度程序、托管内存数据库、官方 OpenAI 适配器、自动存储库写入、自动 LLM Wiki 同步、SDK、CLI、认证、认可或本机 API 目标字段。
  • 权威:审查的 UAIX 内存文件、公共页面、发行说明、代码、测试和接受的项目记录胜过运行时状态。

相关 UAIX 记录

机器可读摘要

代理应该将此摘要视为面向页面的证据,而不是运行时权限。

代码示例
{
    "kind": "uaix.guide.long-running-goal-execution.v1",
    "canonical_route": "/en-us/guides/long-running-goal-execution/",
    "status": "guide-level operating recipe",
    "standard_version": "v1.0",
    "composes": [
        "项目交接",
        ".uai 文件指南",
        "Follow Goals runtime overlay",
        "UAI-1 agent packet profiles",
        "上下文预算"
    ],
    "not_a": [
        "runtime",
        "scheduler",
        "hosted memory database",
        "OpenAI adapter",
        "SDK",
        "CLI",
        "certification",
        "hosted importer",
        "automatic repository writer",
        "automatic sync"
    ],
    "required_packets": [
        "uai.task.status.v1",
        "uai.agent.task-status.v1",
        "uai.agent.blocker.v1",
        "uai.agent.handoff.v1",
        "uai.agent.memory-proposal.v1",
        "uai.agent.final-report.v1"
    ],
    "writeback_rule": "Runtime state is not accepted memory until reviewed and promoted into authoritative .uai files, docs, code, tests, release notes, roadmap state, or machine artifacts.",
    "checkpoint_cadence": "检查point after meaningful work, before interruption, before boundary expansion, before context compaction, and before final handoff."
}
传输格式优化版(无键)JSON
代码示例
[]

字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。

分层目标记忆

使用分层目标记忆当长期目标需要子目标、折叠记录、有界证据检索、新鲜上下文审查和审查门控写回而不将摘要转化为权威时。