用途:Ultragoal 用于在 Codex goal 模式之上创建并执行可持久化的仓库原生多目标计划,适用于 ultragoal、create-goals、complete-goals、持久多目标规划或对 Codex /goal 的顺序执行。状态归属与目标工具边界见 AGENTS.md 的 durable-runtime-invariants-canonical-ssot。
主要能力:持久化工件为 .omx/ultragoal/brief.md、.omx/ultragoal/goals.json 和 .omx/ultragoal/ledger.jsonl。新计划默认使用聚合 Codex goal 模式,即一个稳定指针目标,由 OMX 跟踪各故事;仅在明确要求时用 --codex-goal-mode per-story。支持创建目标、执行与检查点、失败重试、显式纠偏(add_subgoal、split_subgoal、reorder_pending、revise_pending_wording、annotate_ledger、mark_blocked_superseded)、阶段/HUD 交接、可选 Team 桥接以及最终质量门禁。
使用方式:创建时运行 omx ultragoal create-goals --brief "<brief>",也可用 --brief-file、--from-stdin。执行时重复运行 omx ultragoal complete-goals 并读取交接,调用 get_goal,仅在无活动 Codex goal 时按打印载荷调用 create_goal;完成一个 OMX 故事并审计后,用 omx ultragoal checkpoint --goal-id <id> --status complete --evidence "<evidence>" --codex-goal-json <fresh-get-goal-json-or-path> 记录检查点;阻塞或失败用 --status blocked|failed,失败重试用 omx ultragoal complete-goals --retry-failed。纠偏用 omx ultragoal steer 及相应参数。独立激活时用 omx state write 声明阶段。最终完成前需运行故事验证、对改动文件运行 ai-slop-cleaner 并重跑验证、审计架构/领域不变量、通过独立 code-reviewer 与 architect 通道运行 $code-review;不干净则用 omx ultragoal record-review-blockers 记录阻塞,干净则调用 update_goal({status: "complete"})、get_goal 并用 --quality-gate-json 记录检查点。
限制:不要从 shell 或本技能调用 /goal clear;完成运行后可由操作者在 Codex UI 清除交互式 goal。普通文字不会改变计划,重复结构化指令会去重。不得仅凭 OMX 状态声称完成。其他细节暂未提供。