Back to Details

omc-teams

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OMC Teams Skill

OMC Teams 技能

Spawn N CLI worker processes in tmux panes to execute tasks in parallel. Supports 
claude
, 
codex
, and 
gemini
agent types.
/omc-teams
is a legacy compatibility skill for the CLI-first runtime: use 
omc team ...
commands (not deprecated MCP runtime tools).
在tmux窗格中启动N个CLI工作进程，以并行执行任务。支持
claude
、
codex
和
gemini
三种Agent类型。
/omc-teams
是面向CLI优先运行时的旧版兼容技能：请使用
omc team ...
命令（不要使用已弃用的MCP运行时工具）。

Usage

使用说明

bash
/oh-my-claudecode:omc-teams N:claude "task description"
/oh-my-claudecode:omc-teams N:codex "task description"
/oh-my-claudecode:omc-teams N:gemini "task description"
bash
/oh-my-claudecode:omc-teams N:claude "task description"
/oh-my-claudecode:omc-teams N:codex "task description"
/oh-my-claudecode:omc-teams N:gemini "task description"

Parameters

参数

  • N - Number of CLI workers (1-10)
  • agent-type - 
    claude
    (Claude CLI), 
    codex
    (OpenAI Codex CLI), or 
    gemini
    (Google Gemini CLI)
  • task - Task description to distribute across all workers
  • N - CLI工作进程的数量（1-10）
  • agent-type - 
    claude
    （Claude CLI）、
    codex
    （OpenAI Codex CLI）或 
    gemini
    （Google Gemini CLI）
  • task - 要分发给所有工作进程的任务描述

Examples

示例

bash
/omc-teams 2:claude "implement auth module with tests"
/omc-teams 2:codex "review the auth module for security issues"
/omc-teams 3:gemini "redesign UI components for accessibility"
bash
/omc-teams 2:claude "implement auth module with tests"
/omc-teams 2:codex "review the auth module for security issues"
/omc-teams 3:gemini "redesign UI components for accessibility"

Requirements

依赖要求

  • tmux must be running (
    $TMUX
    set in the current shell)
  • claude CLI: 
    npm install -g @anthropic-ai/claude-code
  • codex CLI: 
    npm install -g @openai/codex
  • gemini CLI: 
    npm install -g @google/gemini-cli
  • 必须正在运行tmux（当前shell中已设置
    $TMUX
    环境变量）
  • claude CLI：
    npm install -g @anthropic-ai/claude-code
  • codex CLI：
    npm install -g @openai/codex
  • gemini CLI：
    npm install -g @google/gemini-cli

Workflow

工作流

Phase 1: Parse input

阶段1：解析输入

Extract:
  • N
    — worker count (1–10)
  • agent-type
    — 
    claude|codex|gemini
  • task
    — task description
提取以下内容：
  • N
    — 工作进程数量（1–10）
  • agent-type
    — 
    claude|codex|gemini
  • task
    — 任务描述

Phase 2: Decompose task

阶段2：拆分任务

Break work into N independent subtasks (file- or concern-scoped) to avoid write conflicts.
将工作拆分为N个独立的子任务（按文件或关注点划分范围），避免写入冲突。

Phase 3: Start CLI team runtime

阶段3：启动CLI团队运行时

Activate mode state (recommended):
text
state_write(mode="team", current_phase="team-exec", active=true)
Start workers via CLI:
bash
omc team <N>:<claude|codex|gemini> "<task>"
Team name defaults to a slug from the task text (example: 
review-auth-flow
).
激活模式状态（推荐）：
text
state_write(mode="team", current_phase="team-exec", active=true)
通过CLI启动工作进程：
bash
omc team <N>:<claude|codex|gemini> "<task>"
团队名称默认取自任务文本的slug（例如：
review-auth-flow
）。

Phase 4: Monitor + lifecycle API

阶段4：监控 + 生命周期API

bash
omc team status <team-name>
omc team api list-tasks --input '{"team_name":"<team-name>"}' --json
Use 
omc team api ...
for task claiming, task transitions, mailbox delivery, and worker state updates.
bash
omc team status <team-name>
omc team api list-tasks --input '{"team_name":"<team-name>"}' --json
使用
omc team api ...
命令进行任务认领、任务状态流转、消息投递和工作进程状态更新。

Phase 5: Shutdown (only when needed)

阶段5：关闭（仅在需要时执行）

bash
omc team shutdown <team-name>
omc team shutdown <team-name> --force
Use shutdown for intentional cancellation or stale-state cleanup. Prefer non-force shutdown first.
bash
omc team shutdown <team-name>
omc team shutdown <team-name> --force
关闭操作用于主动取消任务或清理过时状态。优先使用非强制关闭。

Phase 6: Report + state close

阶段6：报告 + 关闭状态

Report task results with completion/failure summary and any remaining risks.
text
state_write(mode="team", current_phase="complete", active=false)
输出任务结果，包含完成/失败摘要以及剩余风险。
text
state_write(mode="team", current_phase="complete", active=false)

Deprecated Runtime Note

运行时弃用说明

Legacy MCP runtime tools are deprecated for execution:
  • omc_run_team_start
  • omc_run_team_status
  • omc_run_team_wait
  • omc_run_team_cleanup
If encountered, switch to 
omc team ...
CLI commands.
旧版MCP运行时工具已被弃用，请勿使用：
  • omc_run_team_start
  • omc_run_team_status
  • omc_run_team_wait
  • omc_run_team_cleanup
如果遇到上述命令，请切换为
omc team ...
系列CLI命令。

Error Reference

错误参考

ErrorCauseFix
not inside tmux
Shell not running inside tmuxStart tmux and rerun
codex: command not found
Codex CLI not installed
npm install -g @openai/codex
gemini: command not found
Gemini CLI not installed
npm install -g @google/gemini-cli
Team <name> is not running
stale or missing runtime state
omc team status <team-name>
then 
omc team shutdown <team-name> --force
if stale
status: failed
Workers exited with incomplete workinspect runtime output, narrow scope, rerun
错误原因修复方案
not inside tmux
当前shell未运行在tmux中启动tmux后重新执行命令
codex: command not found
未安装Codex CLI执行
npm install -g @openai/codex
gemini: command not found
未安装Gemini CLI执行
npm install -g @google/gemini-cli
Team <name> is not running
运行时状态过时或不存在先执行
omc team status <team-name>
检查，若状态过实则执行
omc team shutdown <team-name> --force
status: failed
工作进程退出，任务未完成检查运行时输出，缩小任务范围后重新执行

Relationship to 
/team

与
/team
的对比

Aspect
/team
/omc-teams
Worker typeClaude Code native team agentsclaude / codex / gemini CLI processes in tmux
Invocation
TeamCreate
/ 
Task
/ 
SendMessage
omc team [N:agent]
+ 
status
+ 
shutdown
+ 
api
CoordinationNative team messaging and staged pipelinetmux worker runtime + CLI API state files
Use whenYou want Claude-native team orchestrationYou want external CLI worker execution
维度
/team
/omc-teams
工作进程类型Claude Code原生团队Agent运行在tmux中的claude / codex / gemini CLI进程
调用方式
TeamCreate
/ 
Task
/ 
SendMessage
omc team [N:agent]
+ 
status
+ 
shutdown
+ 
api
协调方式原生团队消息传递和分阶段流水线tmux工作进程运行时 + CLI API状态文件
适用场景需要使用Claude原生团队编排能力时需要执行外部CLI工作进程时