SuperAPI AI 工具集

ultrawork

智能体与模型

查看项目

更新于 10-15 15:33

技能介绍

用途

Ultrawork 是一个面向高吞吐量的并行执行引擎(parallel execution engine),用于同时处理多个相互独立的任务。当多个独立任务可以并行运行、需要一次性把工作委派给多个 agent,或任务能受益于并发执行但由用户自行管理完成情况时,适合使用它。

典型触发方式包括:用户说出 "ulw"、"ultrawork",或明确表示希望并行执行。

主要能力

  • 并行执行:一次性发射所有相互独立的 agent 调用,不将独立工作串行化。
  • 模型分级路由:委派时始终显式传入 model 参数,把任务按复杂度路由到不同层级的模型。
  • 分层委派:简单改动使用 haiku,标准工作使用 sonnet,复杂工作使用 opus。
  • 后台执行:对安装、构建、测试等超过约 30 秒的操作使用 run_in_background: true;对 git status、文件读取、简单检查等快速命令使用前台执行。
  • 计划编排:对非平凡任务,在执行前产出考虑依赖关系的并行波次计划。
  • 无状态设计:Ultrawork 不保存持久状态,两个并发运行在设计上彼此独立,因此不需要 plan id。

使用方式

  • 委派前先阅读 docs/shared/agent-tiers.md,以获取 agent 选择指引。
  • 通过 Task 工具调用,例如 Task(subagent_type="oh-my-claudecode:executor", model="haiku", ...) 处理简单改动;model="sonnet" 处理标准工作;model="opus" 处理复杂工作。
  • 在实现前先解决意图与不确定性:优先探索,只有在仍然受阻时才提问。
  • 保持委派任务的报告简洁:简短摘要、涉及文件、验证状态、阻塞项。
  • 对已实现的行为需要人工 QA,而不只是诊断。

适用场景

  • 多个彼此独立的任务需要同时执行。
  • 需要一次性把工作分发给多个 agent。
  • 任务能受益于并发执行,但完成情况由用户自行管理。

限制与不适用场景

  • 需要保证完成并进行验证的任务:应改用 ralph(ralph 已包含 ultrawork)。
  • 需要完整自主流水线的任务:应改用 autopilot(autopilot 包含 ralph,ralph 又包含 ultrawork)。
  • 只有一个顺序任务、不存在并行机会时:直接委派给 executor agent。
  • 用户需要会话持久化以便恢复时:应改用 ralph,它在 ultrawork 之上增加了持久化。

当直接调用 ultrawork(而非经由 ralph)时,只进行轻量验证:构建通过、测试通过、无新增错误。若需要完整持久化与全面的架构师验证,建议切换到 ralph 模式。若任务在多次重试后仍失败,应报告问题而不是无限重试;当任务依赖不清晰或需求冲突时,升级给用户处理。

完成检查清单

  • 所有并行任务已完成
  • 构建/类型检查通过
  • 受影响的测试通过
  • 未引入新的错误

并行会话注意事项

  • 多仓库工作区锚点:在父目录放置 .omc-workspace 标记,使跨子仓库的多个会话共享同一个 .omc/。解析顺序为:OMC_STATE_DIR > .omc-workspace > git > cwd。详见 docs/REFERENCE.md。
  • 会话 id 来源:在 CLI 上下文中 OMC_SESSION_ID 环境变量优先;在 hook 上下文中 hook payload 的 data.session_id 优先。
  • 并行判定:受支持(无状态组件)。

层级关系

  • ralph(持久化包装器):包含 ultrawork(本技能),后者仅提供并行执行。
  • autopilot(自主执行):包含 ralph,ralph 又包含 ultrawork(本技能)。

即 Ultrawork 是并行层,Ralph 在其上增加持久化与验证,Autopilot 再增加完整生命周期流水线。