mcpField
U
ultragoal

ultragoal

github.com/yeachan-heoAgent 工作流33.7k70 次安装今天更新
代码仓库

关于 ultragoal

ultragoal 是通过 Codex `/goal` 进行持久化多目标规划和顺序执行的工作流 skill。它用持久化产物跟踪各个故事，以证据记录检查点，并在完成前执行验证与审查。

主要功能

  1. 01创建持久化多目标计划
  2. 02通过持久化产物跟踪故事
  3. 03以证据记录 Codex 目标检查点
  4. 04通过结构化指令调整计划
  5. 05完成前要求验证与审查

适用场景

  1. 01规划并依序执行多个项目目标
  2. 02依据记录状态恢复失败故事
  3. 03根据证据调整目标拆分

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yeachan-heo/oh-my-codex --skill ultragoal

安装后在 Claude Code 中输入/ultragoal确认已加载。

详细介绍

Ultragoal 工作流

何时使用

用于 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 聚合目标模式：为计划使用一个稳定的指针目标，同时 OMX 跟踪各个故事。仅在明确要求时使用 --codex-goal-mode per-story。
  • 不要从 shell 或此技能调用 /goal clear。在完成一次运行后，操作员可以在 Codex UI 中清除交互式 Codex 目标，然后再进行另一次同线程运行。

操作步骤：创建

运行一条命令，然后检查生成的计划：

omx ultragoal create-goals --brief "<brief>"
omx ultragoal create-goals --brief-file <path>
cat <brief> | omx ultragoal create-goals --from-stdin
omx ultragoal create-goals --codex-goal-mode per-story --brief "<brief>"

如果需要细化，请使用明确支持的引导方式，而不是手动编辑持久化产物。

操作步骤：执行

重复直到 omx ultragoal status 报告所有目标完成：

  1. 运行 omx ultragoal complete-goals 并阅读其交接信息。
  2. 调用 get_goal。仅当不存在活动的 Codex 目标时，使用打印的载荷调用 create_goal；否则继续匹配的聚合目标。
  3. 完成一个 OMX 故事，并根据真实产物和验证证据审计其目标。
  4. 对于中间聚合故事，保持 Codex 目标处于活动状态并设置检查点： 
    omx ultragoal checkpoint --goal-id <id> --status complete --evidence "<evidence>" --codex-goal-json <fresh-get-goal-json-or-path>
  5. 对于被阻塞/失败的故事，使用带证据的 --status blocked|failed；使用 omx ultragoal complete-goals --retry-failed 恢复失败的工作。
  6. 在最后一个故事上，在 update_goal({status: "complete"}) 之前完成下面的最终门禁；然后再次调用 get_goal 并检查点最新的完成快照。

明确引导

仅在分解必须更改时使用有证据支持的指令：

omx ultragoal steer --kind add_subgoal --title "<title>" --objective "<objective>" --evidence "<evidence>" --rationale "<reason>" --json
omx ultragoal steer --directive-json ./steering.json --json

支持的 kind：add_subgoal、split_subgoal、reorder_pending、revise_pending_wording、annotate_ledger 和 mark_blocked_superseded。普通叙述不会改变计划；重复的结构化指令会去重。

阶段/HUD 交接

在独立激活时，声明最小准确的阶段（planning、executing、verifying、reviewing、checkpointing 或 blocked）：

omx state write --input '{"mode":"ultragoal","active":true,"current_phase":"planning"}' --json

在 Autopilot 内，保持父模式活动并设置 current_phase:"ultragoal"；在代码审查交接之前，将 Ultragoal 证据持久化到 handoff_artifacts.ultragoal 下。仅当每个持久目标都完成时，才将独立 Ultragoal 标记为完成。

可选 Team 桥接

对于并行故事执行，使用单独的 Team 命令。领导者使用最新的 get_goal 快照记录 Ultragoal 检查点；有关桥接详情，请参阅 Team 技能。

最终门禁和退出证据

在最终完成之前：

  1. 运行有针对性的故事验证。
  2. 对更改的文件运行 ai-slop-cleaner，然后重新运行验证。
  3. 根据实现、测试和审查证据，审计 brief/spec/已接受引导中的每个架构/领域不变量。
  4. 通过独立的 code-reviewer 和 architect 通道运行 $code-review。如果审查或不变量证明不干净，不要更新 Codex 目标；记录持久阻塞项： 
    omx ultragoal record-review-blockers --goal-id <id> --title "Resolve final code-review blockers" --objective "<objective>" --evidence "<findings>" --codex-goal-json <active-get-goal-json-or-path>
  5. 如果干净，调用 update_goal({status: "complete"})，调用 get_goal，并使用包含 cleaner、验证、审查和架构不变量证据的 --quality-gate-json 设置检查点。

报告目标 id/状态、ledger/检查点路径、最新目标快照证据、审查结论以及任何阻塞项。绝不要仅凭 OMX 状态声称完成。

评论

支持 Markdown