SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场oma-coordination

oma-coordination

智能体与模型

查看项目

更新于 10-16 02:11

技能介绍

用途

oma-coordination 用于手动协调多智能体工作流，处理跨越 PM、前端、后端、移动端和 QA 等多领域职责的复杂工作。当用户希望逐步协调、手动生成智能体，或进行多领域工作规划而不采用全自动方式时适用。

适用与不适用场景

适用：跨越多个领域的复杂功能（全栈、移动端）；需要前端、后端、移动端与 QA 之间协调；用户希望获得多智能体协调的分步指导。

不适用：简单的单领域任务（直接使用对应智能体）；用户希望自动执行（使用 orchestrator）；快速缺陷修复或微小改动。

预期输入与输出

输入：复杂功能或项目目标；所需领域与优先级层级；工作区/会话约束以及 API/数据契约需求。

输出：手动协调序列；PM 任务分解、智能体生成顺序、监控指导以及 QA 审查步骤；API/数据契约对齐检查点。

主要能力与控制流

按任务复杂度、优先级层级、依赖顺序以及是否需要自动化进行分支判断。在适当情况下并行生成同优先级且相互独立的任务。监控进度文件与契约对齐情况。

使用方式

结构流程分为四个阶段：

  • PREPARE：确认会话、领域与任务分解需求。
  • ACT：按优先级生成智能体，分配独立工作区。
  • VERIFY：监控进度与 API/数据契约对齐。
  • FINALIZE：运行 QA 审查并协调修复。

转换规则：若任务简单，路由到单一专家；若用户希望自动执行，使用 orchestrator；若 QA 报告阻塞性缺陷或必需的验证缺口，将受影响的工作在现有恢复预算内路由给负责的智能体。

失败与恢复：若契约出现分歧，暂停下游前端/移动端工作，直到后端/API 契约协调一致；若智能体工作区冲突，拆分所有权边界；若进度停滞，检查进度文件并重新下达聚焦指令。

退出：成功时，专家输出经过协调并通过 QA 审查；部分成功时，明确列出被阻塞的智能体、契约冲突或 QA 失败。

工具与命令

使用 oma agent spawn、PM/前端/后端/移动端/QA 智能体，以及内存/进度/结果文件。

规范命令路径示例：

# If planning is required, dispatch the declared PM task first; otherwise reuse the current plan.
oma agent spawn pm <pm-prompt-file> <session-id> --task-id <plan.pm_task.id> -w ./pm
oma agent spawn backend <backend-prompt-file> <session-id> --task-id <plan.backend_task.id> -w ./backend &
oma agent spawn frontend <frontend-prompt-file> <session-id> --task-id <plan.frontend_task.id> -w ./frontend &
wait

当原生运行时调度可用（每个智能体的目标 vendor 等于当前运行时 vendor）时，优先使用运行时的原生子智能体路径，并将 oma agent spawn 作为跨 vendor 的回退方案。

常用生成选项：--vendor <vendor>（覆盖 CLI vendor）、--isolation worktree（每次生成使用 git worktree，防止文件冲突）、--read-only（仅使用非破坏性工具，例如用于审查/QA 环节）。

资源范围

LOCAL_FS：进度/结果文件与工作区。PROCESS：智能体生成命令。MEMORY：会话状态与任务板。CODEBASE：共享契约与实现区域。

先决条件

任务需要多个领域；当前计划需明确任务所有权、验收检查、依赖关系和优先级层级。

效果与副作用

生成或指导多个智能体；协调工作区所有权与 QA 反馈。

护栏

复用有效计划，仅在需要分解或契约变更时调用 PM；并行生成同优先级的独立任务；在依赖的前端/移动端工作之前，为变更的 API 边界复用或更新契约；QA 审查始终为最后一步；分配独立工作区以避免文件冲突（或使用 --isolation worktree 为每次生成创建 git worktree）；遵循代码智能规范：发现已配置工具，不自动安装或跟踪，仅在不可用或超时时对项目外路径或忽略路径使用原生搜索；从当前交接状态恢复并按依赖顺序执行适用步骤，记录分支不适用的原因。

工作流

第 1 步：使用 PM 智能体规划。复用现有有效计划；否则由 PM 分析需求并创建任务分解、验收检查、契约和优先级。保留注入的会话/任务/运行 ID；不要重新生成已由调度冻结的计划。

第 2 步：按优先级生成智能体。按智能体解析调度路径，然后生成：从 oma-config.yaml 解析每个智能体的目标 vendor（agents: override，否则 model_preset）；若目标 vendor 等于当前运行时 vendor 且存在原生子智能体路径，则使用原生调度；否则对该智能体使用 oma agent spawn。使用后台进程并行生成所有同优先级任务。

# Example: spawn backend and frontend in parallel
oma agent spawn backend backend-prompt.md session-id --task-id plan.backend_task.id -w ./backend &
oma agent spawn frontend frontend-prompt.md session-id --task-id plan.frontend_task.id -w ./frontend &
wait

第 3 步：监控与协调。读取注入的运行产物与回执。人类可读的进度/结果使用 {memoryConfig.basePath}/progress-{agentId}-{taskId}-{runId}-{sessionId}.md 及相应的 result- 名称；保持结构化声明路径不变。验证智能体之间的 API 契约对齐；确保共享数据模型一致。

第 4 步：QA 审查。与 QA 一起审查协调后的交付物。通过负责的智能体解决阻塞性缺陷和必需的验证缺口；在最终确认前重新运行受影响的检查。

自动化替代方案

若需无需手动生成的完全自动化执行，请改用 orchestrator 技能。

限制

关于具体定价、收费、平台支持范围、实际效果或更多使用步骤，资料中暂未提供。