northseadl/norix-skills / agent-brainstorm
agent-brainstorm
VerifiedMulti-agent brainstorming: async opinion collision with expert personas. Mixed Codex/Claude Code engine. Use when multiple AI agents need to collaboratively discuss, debate, and converge on solutions through structured dialog. Triggers: brainstorm, multi-perspective discussion, opinion collision, expert debate, war room, collective intelligence, 头脑风暴, 多视角讨论, 集思广益.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 14 B |
| SKILL.md | skill md | 10.1 KB |
| agents/openai.yaml | config | 295 B |
| evals/evals.json | config | 4.1 KB |
| package.json | manifest | 454 B |
| references/agent-protocol.md | markdown | 3.4 KB |
| scripts/brainstorm.mjs | script | 49.3 KB |
| scripts/panel.html | other | 46.5 KB |
references/agent-protocol.md
View on GitHub# Agent 讨论协议
> 本文是 Brainstorm Engine 生成 Agent prompt 时的行为规范补充。
> 核心 Agent prompt 由 `brainstorm.mjs` 的 `buildAgentPrompt()` 动态生成。
> 本文件供 Orchestrator 在需要自定义 Agent 行为时参考。
---
## 角色设定原则
每个 Agent 被赋予一个**专家身份**。Orchestrator 在创建 session config 时定义角色:
| 字段 | 含义 | 例子 |
|:---|:---|:---|
| `id` | 唯一标识 (英文, 无空格) | `architect`, `security`, `ux` |
| `name` | 显示名称 | `系统架构师`, `安全专家` |
| `expertise` | 专业领域描述 | `系统设计、微服务架构、可扩展性` |
**角色设计建议**:
- **每个角色代表一个独立视角**。避免角色重叠。
- **至少包含一个"挑战者"角色** — 如 `devil` (魔鬼代言人),专门寻找方案漏洞。
- **3-5 个 Agent 是最佳数量**。太少缺乏碰撞,太多导致噪声。
## 常用角色模板
| ID | 名称 | 适用场景 |
|:---|:---|:---|
| `architect` | 系统架构师 | 技术选型、架构设计 |
| `security` | 安全专家 | 安全审计、威胁建模 |
| `performance` | 性能工程师 | 性能优化、资源管理 |
| `product` | 产品经理 | 用户需求、商业价值 |
| `ux` | 用户体验设计师 | 交互设计、可用性 |
| `devil` | 魔鬼代言人 | 反面论证、风险发现 |
| `ops` | 运维工程师 | 部署、监控、可观测性 |
| `data` | 数据工程师 | 数据架构、存储策略 |
## Agent 讨论行为模式
### 三阶段节奏
```
阶段 1: Explore (探索)
├── 阅读代码和文档
├── 形成独立观点
└── 发表首个分析 (opinion)
阶段 2: Engage (碰撞)
├── 阅读他人观点
├── 同意 / 质疑 / 扩展
└── 发表回应 (response)
阶段 3: Converge (收敛)
├── 评估共识程度
├── 提出综合方案 (proposal)
└── 投票结束 (conclude)
```
### Agent 自主节奏控制
Agent 被指示在发表首个观点后,通过交替执行"深入分析"和"检查新观点"来维持讨论节奏。
具体 prompt 由 `brainstorm.mjs` 的 `buildAgentPrompt()` 函数生成。
### 常见问题处理
| 场景 | Agent 行为 |
|:---|:---|
| 其他人还没发言 | 继续深入分析代码,稍后再检查 |
| 所有人都同意我 | 尝试自我质疑,找出潜在风险 |
| 激烈分歧 | 用 `respond` 发表详细论证 |
| 超时即将到达 | 立即 `conclude` 投票 |
## 讨论空间 API
每个 Agent 通过 `discuss.py` CLI 工具与讨论空间交互。
工具由 `brainstorm.mjs` 在启动时生成到 `.brainstorm/discuss.py`。
### Post 类型
| 类型 | 用途 | 何时使用 |
|:---|:---|:---|
| `opinion` | 独立观点 | 首次发言、新洞察 |
| `response` | 对他人观点的回应 | 回应特定 post |
| `proposal` | 具体解决方案 | 收敛阶段 |
| `conclude_vote` | 结束投票 + 总结 | 认为讨论充分时 |
### Reaction 类型
| 类型 | 含义 |
|:---|:---|
| `agree` | 同意该观点 |
| `challenge` | 质疑,应附带理由 |
| `build-on` | 在此基础上扩展 |
### 收敛检测
Discussion Space 自动检测讨论阶段转换:
- **exploring → debating**: 所有 Agent 至少发布 1 个 opinion
- **debating → converging**: 回应数 ≥ Agent 数 且 agree > challenge
- **converging → synthesizing**: 过半 Agent 投 conclude 票
- **synthesizing → concluded**: 所有 Agent session 结束
Orchestrator 也可通过 timeout 强制结束。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |