多 Agent 异步观点碰撞空间
支持 Codex / Claude Code 混合引擎,每个 Agent 可独立选择引擎。多个 AI 专家在共享讨论空间中自主辩论、质疑、建设性碰撞,最终收敛到高质量决策方案。Web 面板实时展示讨论进展,人类可随时参与。
FEATURES
每个 Agent 可独立选择 Codex 或 Claude Code 引擎。通过 session JSON 的 engine 字段指定,未指定则继承 --engine 全局默认值。
不是同步聊天室。每个 Agent 按自己节奏阅读代码、深度思考、发表观点。先完成的自动进入讨论,后到的能看到完整前序。
自动打开 SSE 实时推送面板。帖子、反应、阶段变化实时更新。人类可随时以发帖方参与,无需阻断讨论。
四阶段状态机自动推进:exploring → debating → converging → concluded。通过 agree/challenge 比率和 conclude 投票判定。
Agent 通过 discuss.py CLI 交互:发表 opinion/response/proposal,支持 agree/challenge/build-on 反应和 conclude 投票。
讨论结束自动生成 synthesis.md:各角色核心观点、提案、投票结果、完整讨论日志。
REFERENCE
brainstorm.mjs — 启动与管理讨论
| 命令 | 说明 | 示例 |
|---|---|---|
--engine <codex|claude> | 默认引擎(每个 agent 可在 JSON 中覆盖) | node scripts/brainstorm.mjs session.json --engine claude |
--timeout <min> | 讨论超时(默认 30 分钟) | node scripts/brainstorm.mjs session.json --timeout 45 |
--port <N> | 面板端口 | node scripts/brainstorm.mjs session.json --port 8899 |
--dry-run | 预览不执行 | node scripts/brainstorm.mjs session.json --dry-run |
--approval-mode | Agent 权限策略 | node scripts/brainstorm.mjs session.json --approval-mode full-auto |
--cwd <dir> | Agent 工作目录 | node scripts/brainstorm.mjs session.json --cwd /my-project |
--no-open | 不自动打开浏览器 | node scripts/brainstorm.mjs session.json --no-open |
查看历史、状态、清理
| 命令 | 说明 | 示例 |
|---|---|---|
--list | 列出历史会话 | node scripts/brainstorm.mjs --list --cwd /project |
--status [ID] | 查看会话状态 | node scripts/brainstorm.mjs --status --cwd /project |
--clean [N] | 清理旧会话 | node scripts/brainstorm.mjs --clean 3 --cwd /project |
5 个 Agent 在 Web 面板中实时交互——发帖、回应、同意、质疑,自动收敛到综合方案。
从启动到结束的完整讨论过程,包含引擎日志和面板实时更新。
只需要自然语言描述你的需求:
"我想让多个 AI 专家讨论一下我们项目的事件调度方案,架构师用 Claude,其他用 Codex"
Agent 会自动触发本技能,进入编排模式。
Agent 会根据你的描述生成 Session 配置。你可以确认或调整:
{
"topic": {
"title": "事件调度架构选型",
"context": "24/7 AI 代理系统,从 Sentry/GitHub 接收事件并调度分析",
"goals": ["选择调度模型", "确定并发控制策略"],
"constraints": ["嵌入式 SQLite", "单体架构"]
},
"agents": [
{
"id": "architect",
"name": "系统架构师",
"expertise": "系统设计、事件驱动架构",
"engine": "claude"
},
{
"id": "reliability",
"name": "可靠性工程师",
"expertise": "容错设计、重试策略"
},
{
"id": "devil",
"name": "魔鬼代言人",
"expertise": "寻找方案漏洞、边界场景",
"engine": "codex"
}
]
}引擎选择规则:
| 场景 | 配置方式 |
|---|---|
| 所有 Agent 用 Codex | --engine codex(默认,无需额外配置) |
| 所有 Agent 用 Claude | --engine claude |
| 混合引擎 | 在每个 agent 中指定 "engine": "codex" 或 "engine": "claude" |
| 部分指定 | 未指定 engine 的 agent 继承 --engine 全局值 |
Agent 启动引擎后:
讨论结束后,Agent 读取 synthesis.md,向你汇报:
你 (Orchestrator)
│
├── 创建 Session JSON(议题 + Agent 定义 + 引擎选择)
│
├── brainstorm.mjs 启动
│ ├── HTTP 讨论服务 + SSE 实时推送
│ ├── Web 面板
│ └── discuss.py CLI 工具(自动生成)
│
├── 按需加载 SDK(仅加载实际使用的引擎)
│ ├── Codex Agent → @openai/codex-sdk
│ └── Claude Agent → @anthropic-ai/claude-agent-sdk
│
├── 并行派发 N 个 Agent(每个使用其指定的引擎)
│ └── 阅读代码 → 发表观点 → 回应他人 → 投票收敛
│
└── 讨论结束
├── synthesis.md 综合报告
└── state.json 完整状态| 阶段 | 触发条件 | 说明 |
|---|---|---|
| Exploring | 初始 | Agent 阅读代码、发表首个观点 |
| Debating | 全员至少发表 1 个 opinion | 互相回应、质疑、扩展 |
| Converging | agree > challenge 且回应数 ≥ Agent 数 | 形成共识 |
| Synthesizing | 过半数 Agent 投 conclude 票 | 准备综合报告 |
| Concluded | 全部 Agent 完成 | 生成 synthesis.md |
| 命令 | 作用 |
|---|---|
topic | 查看议题和当前状态 |
posts / new | 查看全部/新增帖子 |
post <内容> | 发表观点 |
respond <id> <内容> | 回应某个帖子 |
propose <内容> | 提出具体方案 |
agree <id> | 同意某个帖子 |
challenge <id> <理由> | 质疑某个帖子 |
build <id> <补充> | 在某个帖子上扩展 |
conclude <总结> | 投票结束讨论 |
| 维度 | Codex SDK | Claude Agent SDK |
|---|---|---|
| 包名 | @openai/codex-sdk | @anthropic-ai/claude-agent-sdk |
| CLI 参数 | --engine codex(默认) | --engine claude |
| 权限模式 | approvalPolicy + sandboxMode | permissionMode |
| full-auto | never + workspace-write | bypassPermissions |
| 混合引擎 | ✅ 与 Claude 混合使用 | ✅ 与 Codex 混合使用 |
| SDK 加载 | 按需(仅当有 agent 使用时加载) | 按需(仅当有 agent 使用时加载) |
| 工具 | 内置沙箱 | 内置 + MCP 支持 |
| 阀 | 值 | 触发后 |
|---|---|---|
| 全局超时 | --timeout(默认 30min) | 强制 concluded |
| SIGINT | 运行中按 3 次 Ctrl+C | 强制终止并持久化状态 |
| Agent session | SDK 内部控制 | Agent 自然结束 |
| 最终产出 | synthesis.md | 即使讨论未完成也有记录 |
| 经验法则 | 说明 |
|---|---|
| 3-5 个 Agent | 太少缺乏碰撞,太多产生噪声 |
| 至少 1 个挑战者 | 如 devil(魔鬼代言人),专门找漏洞 |
| 视角不重叠 | 每个角色代表独立维度(安全、性能、可用性…) |
| expertise 要具体 | 引导 Agent 的分析方向和专业深度 |
常用角色:系统架构师、安全工程师、性能工程师、可靠性工程师、产品经理、UX 设计师、运维专家、魔鬼代言人
INSTALL