长时间运行的目标执行使可中断的代理工作保持可见、可恢复和审查。当项目组合 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 存档、图形投影、源快照、传输清单。 | 在经过审查和提升之前,不会主动项目真相。 |
规范的长期目标模式
- 加载切换前门和所需的
.uai文件。 - 在广泛工作之前,说明目标、成功标准、硬性边界、验证计划、预期接触点和检查点节奏。
- 在外部运行时运行一个有界切片。
- 当可能发生有意义的状态更改或中断时,发出检查点数据包。
- 当无法安全解决同一障碍时,发出阻止包。
- 当另一个代理、人员、运行时或未来会话必须继续时发出切换数据包。
- 发出候选持久事实的内存建议包;在经过审查之前,不要将它们写为事实。
- 当目标完成或明确关闭时,发出最终报告数据包。
- 将接受的结果写回到权威记录中,然后仅在有用时存档或引用原始运行时材料作为证据。
所需的阅读顺序
- 当前的人类指导和当地政策。
AGENTS.md或.uai/readme.human作为项目前门。.uai/memory-maintenance.uai、受保护的活动指令锚点和.uai/short-term-memory.uai。.uai/startup-packet.uai、.uai/system-profile.uai和.uai/receiver-brief.uai(当项目移交时)。.uai/constraints.uai、.uai/progress.uai、.uai/decisions.uai、.uai/test-plan.uai以及工作涉及代码时的代码范围记录。.uai/exports/follow-goal.json仅当接收器环境使用“跟随目标”或/goal时。- 在不相关的广泛工作之前进行主动代理文件交接。
- 冷内存或 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 时间戳。
中断和恢复流程
- 在安全边界上停止:保存文件,避免半写版本,并且不要让破坏性操作挂起。
- 使用 UTC 时间、当前切片、已完成的工作、更改的文件、检查、阻止程序以及恢复命令或提示编写任务状态检查点。
- 仅使用已接受或明确标记的候选事实更新
.uai/short-term-memory.uai和.uai/progress.uai。 - 恢复时,在使用旧聊天上下文之前重新加载当前指令、前门内存、主动摄入和最新检查点。
- 仅当无法从可见证据中解决阻塞并且合理的假设存在风险时,才总结恢复的状态并请求人工输入。
状态流: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.冲突解决阶梯
- 人类明确的工件和操作授权控制受保护的锚点突变。
.uai/memory-maintenance.uai、.uai/totem.uai、.uai/taboo.uai和.uai/talisman.uai管理内存生命周期和受保护的边界。AGENTS.md或.uai/readme.human提供条目记录和本地项目指令。- 权威的
.uai文件控制当前项目的真相。 - 当前公共 UAIX 页面、代码、测试、发行说明、路线图状态、验证器证据和机器工件管理公共支持声明。
- 除非经过审查和升级,否则遵循目标导出、下一个递归提示、任务状态包、运行时摘要、图形投影和冷内存注释都是从属的。
- 旧的聊天记录、原始日志、旧的报告、未经审查的存档注释和检索答案仅是来源线索。
如果冲突仍然存在,请停止广泛的工作,发出阻止程序,命名冲突的工件,命名最安全的下一个审查操作,并且不要默默地合并或覆盖持久内存。
代码范围规则
- 对于代码、自动化、可执行工作流程或类似代码的工件,在进行广泛编辑之前需要架构、编码标准、约束、进度、测试计划和下一个递归提示记录。
- 在更改代码之前绘制预期的接触点、风险和有针对性的测试。
- 运行与触摸行为匹配的重点语法、单元、集成、静态、包、区域设置、路由或浏览器检查。
- 切勿在没有证据的情况下声称部署、发布、包上传、自动存储库写入、SDK、CLI、官方适配器、认证或背书。
非代码范围规则
- 对于写作、研究、治理、本地化、搜索引擎优化、政策或规划,需要源注释、当前公共表面、支持边界审查和最终证据路径。
- 未经审查,请勿综合规范标准文本、翻译或政策权威。
- 仅当没有具体的功能、错误、改进、测试/检查、打包或发布工作需要执行并明确说明停止条件时,才使用无操作/源验证。
- 将人性化的解释保存在
.human文件中,将 AI 指令文本保存在.uai文件中,将结构化数据保存在.uai/内的.json文件中。
热上下文和冷记忆
热门上下文是下一个代理默认应该加载的内容:当前状态、约束、决策、主动阻止者、下一步行动、有针对性的检查和最近接受的结果。冷记忆是可恢复的来源:长报告、旧聊天记录、原始痕迹、研究快照、存档摄入量和庞大的理由。冷记忆可以为未来的工作提供信息,但只有当回顾的事实被提升到当前记录中时,它才会变得活跃。
分层代理模式
长期运行的项目可以使用协调员和专家工作者,但 UAIX 记录切换,而不是实时层次结构。协调员负责目标框架、阅读顺序、冲突检查、检查点审查、内存建议和最终报告。工作代理拥有有界任务并返回任务状态、阻止程序、切换或最终报告数据包。人工审查仍然控制着受保护的内存、公开声明、发布和部署。
新情境评估
当新的代理评估工作时,它应该加载最新的权威文件,忽略私人聊天内存(除非明确提供),将声明与源证据进行比较,运行或审查有针对性的检查,并决定先前的输出是否被接受、拒绝、部分接受或需要阻止程序。新鲜的背景很有用,因为它可以捕捉到长时间会话可能正常化的偏差。
向导设置
- 打开AI内存封装向导.
- 选择项目交接或与工作匹配的其他代码/项目包。
- 根据可见证据填充启动数据包、接收者简介、约束、进度、决策、测试计划和代码范围文件。
- 仅当接收方使用
/goal或等效的运行时目标覆盖时才启用跟随目标。 - 确保
.uai/exports/follow-goal.json指定一个活跃目标、成功标准、硬边界、验证、检查点节奏和回写目标。 - 完成目标后,当前工作从
/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 记录
- 遵循目标指南默认关闭运行时目标覆盖与条件下一个/目标提示要求。
- 项目交接核心持久项目内存和回写模式。
- .uai 文件指南关闭所需文件集和读取顺序指南。
- OpenAI / Codex 指南OpenAI 运行代理;项目切换保留项目内存。
- 编码剂指南在支持代码的代理表面上应用相同的切换包。
- 上下文预算指南保持热切换文件紧凑,冷内存可恢复。
- 代理沟通运营模式状态、拦截器、切换、内存建议和最终报告的数据包配置文件。
- 模式机器可检查的 UAI-1 架构集合。
- 注册表已发布的配置文件 ID 和兼容性说明。
- 示例安全数据包测试样例和仅供参考的场景。
- 验证器当前仅检查验证器行为实际实现的地方。
- 领养套件支持记录的起始证据包。
- 一致性包可重复使用的一致性和启动审查证据,无需认证声明。
- 政策与安全秘密、修订和支持边界姿态。
- 路线图当前与计划的运行时、适配器、SDK、CLI 和认证边界。
- 变更日志注明日期的公共变更记录。
机器可读摘要
代理应该将此摘要视为面向页面的证据,而不是运行时权限。
{
"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 示例、已发布的模式顺序以及公共字段注册表。
分层目标记忆
使用分层目标记忆当长期目标需要子目标、折叠记录、有界证据检索、新鲜上下文审查和审查门控写回而不将摘要转化为权威时。