swarmesh

Swarmesh

English | 中文 | 🔌 Claude Code 插件安装

---

🔌 Claude Code 插件安装

Swarmesh 现在可作为 Claude Code 插件使用，提供两种协作模式：

模式	何时用	启动命令
discuss	想和多个 CLI（Codex / Claude / Gemini）圆桌讨论、碰方案。v0.2 起 CLI 回答自动流转	/swarm-chat <项目> <cli>
vote	多 CLI 隔离投票 + LLM 综合（对标 pal consensus，v0.6 起多轮辩论 + 文件注入 + 自动闭环）	/swarm-vote "<问题>"
execute	方案已定，要由 supervisor 拆任务派发给全角色团队	/swarm-start <项目> [profile]

安装

Claude Code

/plugin marketplace add Soein/swarmesh
/plugin install swarmesh

本地测试：claude --plugin-dir ~/项目/tmux并行

Codex CLI（v0.7.0+ 支持）

需要 Codex ≥ 0.110.0（codex --version 确认）。

# 1. 启用 plugin features
cat >> ~/.codex/config.toml <<EOF
[features]
plugins = true
EOF

# 2. 装 marketplace（本地 / GitHub / git URL 均可）
codex marketplace add Soein/swarmesh
# 或本地: codex marketplace add /path/to/swarmesh

# 3. 装插件
codex plugin install swarmesh

# 4. 验证
codex   # 进入 REPL 后输入 /skills 应看到 13 个 swarm-* skills

启动后 Codex 会根据用户意图自动激活 skill（LLM 匹配 description），也可用 $swarm-chat 等显式调用。

discuss 模式速览

/swarm-chat ~/my-app codex cx          # 首发 Codex
/swarm-chat-add claude "claude"        # 再加 Claude
/swarm-chat-msg "@cx @claude 讨论 Redis vs Dynamo 做会话缓存"
/swarm-chat-msg "@cx 基于上面对比，结论是？"
/swarm-promote --profile minimal       # 讨论成熟后转 execute 落地

关键规则：

• 只有 @点名 才触发对方接话（防刷屏）
• 默认最大轮次 20（SWARM_DISCUSS_MAX_TURNS 调整）
• 每次喂给 CLI 的上下文 = 最近 10 轮对话（SWARM_DISCUSS_CONTEXT_TURNS 调整）
• v0.2 新增：pane 输出监听器后台自动运行，CLI 答完会自动推回 jsonl 并继续派发链路；降级 SWARM_DISCUSS_AUTO_WATCH=0
• v0.2 新增：Codex 首次进新目录的 trust 提示自动接受（DISCUSS_CODEX_TRUST_AUTO=1）
• 防回环：@ 自己 自动跳过

vote 模式（v0.2 起，v0.6 大幅增强）

基础投票

/swarm-chat ~/app codex cx
/swarm-chat-add cl "claude"
/swarm-chat-add gm "gemini"
/swarm-vote "Redis vs DynamoDB 做会话缓存？"
# 30-60 秒后自动出报告（含 LLM 综合的共识/分歧/各方立场/建议决策四段）

三个 CLI 收到同一个问题独立作答、互不可见，避免讨论模式的羊群效应。

v0.3-v0.6 演进的能力

能力	引入版本	用法
稳定性判定（hash + prompt 防抖，避免半截答案）	v0.3-A	自动
LLM 综合分析（共识/分歧/各方立场/建议决策）	v0.3-B	自动；VOTE_LLM_DISABLE=1 关闭
Quorum / 法定人数	v0.4	--min-responses N
Vote → discuss session.jsonl 回写	v0.4	自动（在 discuss 内发起时）
LLM-assisted extract（删启发式黑名单）	v0.5	自动；status ∈ {answer,abstain,incomplete,no_answer}
Stance 分组（pro/con/neutral/other）	v0.5.1	自动；report 按立场聚段
多轮辩论（看完别人答案再修正立场）	v0.5.2	--rounds N + next-round 子命令
UUID + list/cancel	v0.5.3	discuss-vote.sh list / cancel --id
pane 无限 capture + LLM 压缩兜底	v0.6.0	自动；超 150K 字符触发
--files 文件上下文注入（glob + 行号）	v0.6.1	--files 'src/**/*.go:L1-L50,README.md'
--auto-promote 自动闭环	v0.6.2	--auto-promote <profile>；最终轮综合后自动 promote

复杂用例

# 1. 代码评审型投票（v0.6.1 文件注入）
discuss-vote.sh ask \
    --question "这个重构合理吗？" \
    --participants cx,cl,gm \
    --files 'src/lib/*.sh:L1-L100,docs/ARCHITECTURE.md' \
    --min-responses 2

# 2. 多轮辩论（v0.5.2，3 轮，每轮看上轮立场）
ID=$(discuss-vote.sh ask --rounds 3 --question "方案 A vs B vs C？" | tail -1)
discuss-vote.sh collect --id $ID
discuss-vote.sh report --id $ID
discuss-vote.sh next-round --id $ID    # paste 上轮立场 + 重置 expect
discuss-vote.sh collect --id $ID
# 重复直到最终轮

# 3. 全自动闭环（v0.6.2）：投票 → 综合 → 自动起 execute
discuss-vote.sh ask \
    --question "下一步做什么？" \
    --participants cx,cl \
    --auto-promote full-stack
# 最终轮 LLM 综合给出"## 建议决策"段后，自动：
# - 生成 brief-for-promote.md
# - 调 discuss-relay.sh promote --brief-file ... --profile full-stack
# - tmux 切到 execute session，supervisor 拿到 brief 开工

和 pal consensus 对比（v0.6 后）

维度	pal	swarm
多模型投票 / 综合 / stance / confidence / abstain / quorum / relevant-files	✅	✅
多轮辩论（参与者看到对方立场再修正）	❌	✅
参与者自带 skills / MCP / plugins / 文件读写工具	❌	✅
投票 → execute 自动闭环	❌	✅
MCP 调用 / 秒级延迟 / 无状态	✅	❌（CLI + tmux）

execute 模式速览

/swarm-start ~/my-app minimal    # 起 4 角色团队
/swarm-task "实现用户注册系统"    # 派发给 supervisor，自动拆解
/swarm-status                    # 观察进度
/swarm-stop                      # 结束

平台支持

• ✅ macOS / Linux
• ❌ Windows 原生（需 WSL）

Slash Commands

命令	模式	作用
/swarm-start	execute	启动蜂群
/swarm-task	execute	派发任务
/swarm-join / /swarm-leave	execute	动态增删角色
/swarm-chat	discuss	启动圆桌
/swarm-chat-add	discuss	加参与者
/swarm-chat-list	discuss	列出当前参与者（可 @点名的名字）
/swarm-chat-msg	discuss	发消息（@点名，v0.2 自动流转）
/swarm-chat-tail	discuss	查看最近 N 轮对话历史
/swarm-vote	discuss	隔离投票（v0.6：LLM-first + 多轮辩论 + 文件注入 + 自动闭环）
/swarm-promote	discuss→execute	结案转落地
/swarm-status	通用	查看状态
/swarm-stop	通用	停止

依赖检测

${CLAUDE_PLUGIN_ROOT}/scripts/check-deps.sh

SessionStart hook 会自动检测；缺依赖时打印安装建议但不阻塞会话。

---

English