Skip to content
IN DEVELOPMENT头脑风暴混合引擎Codex SDKClaude CodeNode.jsv0.0.1

Agent 头脑风暴

多 Agent 异步观点碰撞空间

支持 Codex / Claude Code 混合引擎,每个 Agent 可独立选择引擎。多个 AI 专家在共享讨论空间中自主辩论、质疑、建设性碰撞,最终收敛到高质量决策方案。Web 面板实时展示讨论进展,人类可随时参与。

Agent 头脑风暴
混合引擎:3 个 Agent 使用不同引擎
$node scripts/brainstorm.mjs session.json --timeout 30
OK Panel: http://localhost:8899
OK Topic: 事件调度架构选型
OK Agents: 3 — 架构师[claude], 可靠性工程师[codex], 魔鬼代言人[codex]
OK Engine: mixed (2 codex, 1 claude)
OK Mode: full-auto
讨论完成
Agents: ✓ 3 ✗ 0
Posts: 18
Phase: concluded
OK Report: .brainstorm/20260228-101615/synthesis.md

核心能力

混合引擎

每个 Agent 可独立选择 Codex 或 Claude Code 引擎。通过 session JSON 的 engine 字段指定,未指定则继承 --engine 全局默认值。

异步观点碰撞

不是同步聊天室。每个 Agent 按自己节奏阅读代码、深度思考、发表观点。先完成的自动进入讨论,后到的能看到完整前序。

实时 Web 面板

自动打开 SSE 实时推送面板。帖子、反应、阶段变化实时更新。人类可随时以发帖方参与,无需阻断讨论。

自动收敛

四阶段状态机自动推进:exploring → debating → converging → concluded。通过 agree/challenge 比率和 conclude 投票判定。

讨论工具

Agent 通过 discuss.py CLI 交互:发表 opinion/response/proposal,支持 agree/challenge/build-on 反应和 conclude 投票。

综合报告

讨论结束自动生成 synthesis.md:各角色核心观点、提案、投票结果、完整讨论日志。

命令参考

头脑风暴引擎

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-modeAgent 权限策略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 面板中实时交互——发帖、回应、同意、质疑,自动收敛到综合方案。

完整头脑风暴会话

从启动到结束的完整讨论过程,包含引擎日志和面板实时更新。

快速教程

第一步:对 Agent 说你想讨论什么

只需要自然语言描述你的需求:

"我想让多个 AI 专家讨论一下我们项目的事件调度方案,架构师用 Claude,其他用 Codex"

Agent 会自动触发本技能,进入编排模式。

第二步:确认或自定义 Session

Agent 会根据你的描述生成 Session 配置。你可以确认或调整:

json
{
  "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 启动引擎后:

  1. Web 面板自动打开,实时展示讨论进展
  2. 每个 Agent 独立阅读代码、思考、发帖
  3. Agent 互相回应、同意、质疑
  4. 你随时可以参与 — 在面板中发帖加入你的观点
  5. 超半数 Agent 投票 conclude → 讨论自动结束

第四步:获取报告

讨论结束后,Agent 读取 synthesis.md,向你汇报:

  • 关键共识和方案
  • 未解决的分歧点
  • 作为 Orchestrator 的最终建议

核心架构

你 (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互相回应、质疑、扩展
Convergingagree > challenge 且回应数 ≥ Agent 数形成共识
Synthesizing过半数 Agent 投 conclude 票准备综合报告
Concluded全部 Agent 完成生成 synthesis.md

Agent 讨论命令

命令作用
topic查看议题和当前状态
posts / new查看全部/新增帖子
post <内容>发表观点
respond <id> <内容>回应某个帖子
propose <内容>提出具体方案
agree <id>同意某个帖子
challenge <id> <理由>质疑某个帖子
build <id> <补充>在某个帖子上扩展
conclude <总结>投票结束讨论

引擎对比

维度Codex SDKClaude Agent SDK
包名@openai/codex-sdk@anthropic-ai/claude-agent-sdk
CLI 参数--engine codex(默认)--engine claude
权限模式approvalPolicy + sandboxModepermissionMode
full-autonever + workspace-writebypassPermissions
混合引擎✅ 与 Claude 混合使用✅ 与 Codex 混合使用
SDK 加载按需(仅当有 agent 使用时加载)按需(仅当有 agent 使用时加载)
工具内置沙箱内置 + MCP 支持

安全阀

触发后
全局超时--timeout(默认 30min)强制 concluded
SIGINT运行中按 3 次 Ctrl+C强制终止并持久化状态
Agent sessionSDK 内部控制Agent 自然结束
最终产出synthesis.md即使讨论未完成也有记录

角色设计建议

经验法则说明
3-5 个 Agent太少缺乏碰撞,太多产生噪声
至少 1 个挑战者devil(魔鬼代言人),专门找漏洞
视角不重叠每个角色代表独立维度(安全、性能、可用性…)
expertise 要具体引导 Agent 的分析方向和专业深度

常用角色:系统架构师、安全工程师、性能工程师、可靠性工程师、产品经理、UX 设计师、运维专家、魔鬼代言人

快速开始

Install
via skills.sh (推荐)
$npx skills add northseadl/norix-skills/agent-brainstorm
或手动安装
$git clone https://github.com/northseadl/norix-skills.git
$ln -s norix-skills/agent-brainstorm <SKILLS_DIR>/agent-brainstorm
验证
$npm install
OK Skill ready.

Built for AI Agents, by Norix