菜单
Dynamically add a role to the running swarm (execute mode). Use when user says "add a role", "加个角色", "加 database engineer", "bring backend online", "need another engineer".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add a new AI CLI participant to an ongoing discuss-mode roundtable. Use when user asks to "add another AI", "bring in claude/gemini/codex", "add participant to discussion", or mentions "加入讨论" / "加参与者".
List current participants of the discuss-mode roundtable (show who can be @-mentioned). Use when user asks "who's in the discussion", "list participants", "who can I @", "看下有谁", "列出参与者".
Post a message to the discuss roundtable with @-mentions to trigger replies. Use when user wants to "send message to discussion", "@mention a participant", "post to roundtable", "触发 CLI 接话", "发消息", or says "@xxx 讨论 X".
Start a discuss-mode roundtable with multiple AI CLIs (Codex/Claude/Gemini) in a single tmux session. Use when user asks to "discuss X with multiple AIs", "start a roundtable", "brainstorm with other CLIs", "start multi-AI conversation", or mentions "discuss 模式" / "圆桌讨论" / "多 AI 讨论".
View recent N turns of discuss session history from jsonl (without tmux attach). Use when user asks to "show discussion history", "what did they say", "回看讨论", "看下讨论历史", or needs to catch up on recent conversation.
Remove a role from the running swarm. Use when user says "remove role", "移除 X", "kick out backend", "少一个角色", "leave role".
| name | swarm-join |
| description | Dynamically add a role to the running swarm (execute mode). Use when user says "add a role", "加个角色", "加 database engineer", "bring backend online", "need another engineer". |
向运行中的蜂群（execute 模式）动态添加新角色。
# Locate swarmesh plugin root (优先 $SWARM_ROOT env)
if [[ -z "${SWARM_ROOT:-}" || ! -d "$SWARM_ROOT/scripts" ]]; then
SWARM_ROOT=$(find "$HOME/.codex/plugins/cache" -type d -name scripts 2>/dev/null \
| grep -E '/swarmesh/[^/]+/scripts$' | head -1 | sed 's|/scripts$||')
fi
[[ -n "${SWARM_ROOT:-}" && -d "$SWARM_ROOT/scripts" ]] || { echo "⚠ 未找到 swarmesh plugin root，请 export SWARM_ROOT=/path/to/swarmesh"; exit 1; }
格式：<角色名> [选项]
database --task "设计用户表"ls "$SWARM_ROOT/config/roles/core/" \
"$SWARM_ROOT/config/roles/quality/" \
"$SWARM_ROOT/config/roles/management/"
有匹配自动用，否则让用户选。
"$SWARM_ROOT/scripts/swarm-join.sh" <角色名> \
--cli "claude code" \
--config <config_path> \
--force \
[--task "任务"]
CLI 选项：claude code / codex chat / gemini
多实例：同角色可多次加入，实例名自动编号（首 = 角色名，后续 角色名-2 ...）。supervisor/inspector 不支持多实例。
"$SWARM_ROOT/scripts/swarm-msg.sh" list-roles
汇报 pane 位置、实例名、当前团队。