Deliberation

Deliberation

在 Claude Code、Codex、Cursor、Kiro、Antigravity、OpenCode 或任何其他 MCP 宿主中，向 GPT、Gemini 和 Grok 征求第二意见；还可使用本地模型（Ollama、LM Studio），以及通过 OpenRouter 接入的 400 多种模型，包括 Qwen、Kimi 和 DeepSeek。八位领域专家（架构师、代码审查员、安全分析师等）会审查你的计划、查找错误，并围绕边界情况展开辩论，直到达成共识。

近期博客文章：认识 Deliberation：接入 400 多种模型很容易，难的是判断哪些模型值得留下。

你的编码 Agent 可以通过 MCP 向 GPT、Gemini、Grok、本地模型（Ollama、LM Studio）或任何兼容 OpenAI 的模型（通过 OpenRouter）求助。Deliberation 会处理各个提供商的连接配置，让你只需编写提示词。每位专家都有专长领域，可以提供建议或参与实现。

它并不局限于 Claude Code。同一个 MCP 服务可在任何 MCP 宿主上运行，Codex、Cursor、Kiro、Antigravity 和 OpenCode 也有内置专家和委派指南的原生插件（参见 安装）。Claude Code 提供最完整的版本：在同一个服务之上，还提供斜杠命令和自动路由规则。

你可以使用任意部分的提供商。Deliberation 会检测已配置的提供商并据此路由。OpenRouter 仅提供建议，且由配置驱动：模型在 ~/.config/deliberation/config.json（Windows：%APPDATA%\deliberation\config.json；可通过 DELIBERATION_CONFIG 覆盖）中声明，并支持热重载，无需重启宿主。

安装

选择适用于你所用宿主的方式：

• Claude Code - 使用下方的插件（推荐）。
• Codex、Cursor、Kiro、Antigravity、OpenCode - 使用各宿主的原生插件。
• 任何其他 MCP 宿主（Claude Desktop、Windsurf、Zed、VS Code 等）- 使用独立 MCP 服务。

Claude Code 插件（推荐）：

1. 添加 marketplace - antonbabenko/agent-plugins

/plugin marketplace add antonbabenko/agent-plugins

2. 安装插件

/plugin install deliberation@antonbabenko

3. 运行设置

/deliberation:setup

Claude 现在会将复杂任务路由给你的 GPT、Gemini、Grok、本地模型（Ollama、LM Studio）和 OpenRouter 专家（所有提供商都会提供建议；只有 Gemini 还可以参与实现）。

设置只需进行一次。 MCP 服务由插件清单注册，因此会自动加载，并在更新后保持最新。

更新（Claude Code）

/plugin marketplace update antonbabenko  # pull the new version from the marketplace
/deliberation:reload-mcp                 # audit processes & recycle dashboard daemon
/reload-plugins                          # reconnect the MCP servers (or restart Claude Code)

**在非 Claude 宿主上更新：**通过 npx -y @antonbabenko/deliberation-mcp 运行独立服务的宿主，会在每次重新解析时获取最新发布版本。npx 会缓存已解析的包，因此如果宿主使用的是旧版本，请清除 npx 缓存 （rm -rf ~/.npm/_npx），或固定／刷新版本。运行 bash scripts/commands/reload-mcp.sh （或在 Codex、Antigravity、OpenCode 上触发 reload-mcp 技能／命令），以审查正在运行的工作进程，并安全地重启后台仪表板守护进程。

备选方案：使用 deliberation MCP 服务（独立运行，适用于任何 Agent）

编排服务也单独发布：npm 包 @antonbabenko/deliberation-mcp，官方 MCP 注册表名称为 io.github.antonbabenko/deliberation。

一键安装：

{
  "mcpServers": {
    "deliberation": {
      "command": "npx",
      "args": ["-y", "@antonbabenko/deliberation-mcp"],
      "env": {
        "XAI_API_KEY": "xai-...",
        "OPENROUTER_API_KEY": "sk-or-v1-..."
      }
    }
  }
}

在 Docker 中运行

此代码库提供了一个 Dockerfile，用于在容器中运行独立服务。它会通过 mcp-proxy 封装 stdio 服务，这与 MCP 托管提供方所需的形式一致：

docker build -t deliberation-mcp .
docker run -i --rm \
  -e XAI_API_KEY -e OPENROUTER_API_KEY \
  -v ~/.config/deliberation:/home/node/.config/deliberation:ro \
  deliberation-mcp

Grok 和 OpenRouter 仅凭密钥即可运行。GPT 和 Gemini 则不行——它们会调用 codex 和 agy CLI，而镜像中没有这两个 CLI，因此这两个提供方在容器内会报告 not-found / missing-cli。

各宿主的原生插件（Antigravity / Cursor / Codex / Kiro / OpenCode）

除了上面的原始 MCP 配置外，deliberation 还为五种宿主提供原生插件制品，让使用体验与 Claude Code 插件一致（包含具备特定角色的专家和何时委派的指导，而不只是基础工具）。所有这些制品都由规范来源通过 node scripts/sync-hosts.js 生成并提交，因此不会出现偏差（CI 偏差测试会对此进行检查）。每种宿主都会在仓库中扫描自己的文件：

提供商凭据的配置方式与独立服务相同（通过 Codex CLI 使用 GPT，通过 agy 使用 Gemini，Grok 使用 XAI_API_KEY，OpenRouter 使用 OPENROUTER_API_KEY）——只设置你要使用的提供商即可。MCP 服务已在服务端注入每位专家的角色设定，因此这些原生文件提供的是宿主的命令和引导界面，而不是重复的逻辑。

各宿主的完整安装指南： docs/hosts/ - Antigravity & Gemini、Cursor、Codex CLI、Kiro、OpenCode。

要求

你至少需要一个提供方：

• Codex CLI（GPT）：运行 npm install -g @openai/codex 安装，然后运行 codex login 登录（需要 ChatGPT 订阅；在远程机器上运行 codex login --device-auth，每台机器登录一次）。ChatGPT Business/Enterprise 工作区可以改为设置 CODEX_ACCESS_TOKEN。两者都没有时，codex 会使用 CODEX_API_KEY；绝不会使用 OPENAI_API_KEY。
• Antigravity CLI：查看Antigravity CLI 入门指南和从 Gemini CLI 迁移，然后运行 agy 并登录。
• Grok (xAI)：无需安装 CLI；桥接程序随插件提供（需要 Node 18+）。设置 XAI_API_KEY（在 https://console.x.ai 获取密钥）。
• OpenRouter：无需 CLI；桥接程序随插件提供（需要 Node 18+）。设置 OPENROUTER_API_KEY（在 https://openrouter.ai/keys 获取密钥），然后在 ~/.config/deliberation/config.json 中声明模型（Windows：%APPDATA%\deliberation\config.json；使用 DELIBERATION_CONFIG 覆盖）。适用于任何兼容 OpenAI 的端点（Ollama、vLLM、LM Studio、HuggingFace Inference）——密钥环境变量为空时会自动跳过身份验证。支持自定义 OpenRouter 预设（例如 cheapest-first），以优化推理成本和提供方路由。

Windows 提示（CLI 提供方）。 在 Windows 上运行 npm install -g 会安装 codex.cmd 存根，而非可执行文件；Node 无法直接启动 .cmd，因此 GPT 调用过去只会失败并报出生成进程错误。deliberation 现在会自行解析 CLI（先使用 PATHEXT，失败时回退到软件包自身的入口点），并且不会通过 shell 启动它。如果在你的机器上解析失败，请将 CODEX_BIN（GPT）或 AGY_BIN（Gemini）指向实际的可执行文件。Grok 和 OpenRouter 不受影响——它们是 HTTP 桥接程序，不会启动任何进程。

Claude Code 网页版提示。 网页宿主会将每次 MCP 工具调用的时限限制为 60s（MCP_TOOL_TIMEOUT=60000）。插件清单会针对每个服务覆盖此时限：每个 deliberation 服务都声明 "timeout": 1800000（30 min，Claude Code 会优先应用此值，而非 MCP_TOOL_TIMEOUT），并将其同步到服务的环境变量中，以便插件自身的时限上限与实际值保持一致。无需设置任何环境变量。如果某个 timeout 结果的消息仍显示 MCP_TOOL_TIMEOUT=60000，说明安装的是旧版插件：运行 claude plugin update deliberation@antonbabenko 并开启新会话。/deliberation:doctor 会报告时限上限、codex 凭据以及 agy 是否缺失；面板会跳过无法响应的提供方（panel.unavailable），而不是一直等待。对于 GPT，不要将笔记本电脑上的 ~/.codex/auth.json 复制到容器中：ChatGPT 登录的刷新令牌只能使用一次，因此其中一个副本一旦刷新，另一个副本就会失效。使用 Plus/Pro 时，会话中的首次 GPT 调用会启动 codex login --device-auth 并显示链接和代码（宿主支持时会显示对话框，否则会显示在结果中）；完成授权后 GPT 即可响应。使用 Business/Enterprise 时，请设置 CODEX_ACCESS_TOKEN。请参阅 SETUP.md。

命令

随 Claude Code 插件一同提供（安装后即可使用；OpenCode 可使用 ask-*、consensus 和 analyze 命令，其他所有宿主都直接调用对应的 MCP 工具）：

/setup 也可以在 ~/.claude/commands/ 中安装简短别名（/ask-gpt、/ask-gemini、/ask-grok、/ask-openrouter、/ask-all、/consensus）。此操作为可选。默认保留同名的现有命令；setup 会在覆盖任何命令前征求同意。/deliberation:uninstall 仅在别名与随附副本逐字节完全相同时才会将其移除。

analyze 特意不包含在内：/analyze 是常见名称，直接复制会与任何包含该命令的其他插件冲突。请使用始终可用的 /deliberation:analyze。如果先前的 setup 安装了 ~/.claude/commands/analyze.md，setup 现在会指出该路径，方便你删除。/deliberation:uninstall 也会列出 analyze，但其逐字节完全相同检查仅匹配当前随附文件的副本——从旧版本复制的别名会有所不同，因此会有意保留，而不会猜测是否应将其删除。

专家

专家最能发挥作用的场景

• 架构决策——“我应该使用 Redis，还是内存缓存？”
• 调试陷入僵局——两次或更多次尝试失败后，换个角度思考
• 开始实现之前——先验证计划，再编写代码
• 安全问题——“这个身份验证流程安全吗？”
• 代码质量——请他人对你的实现发表第二意见

不适合求助专家的场景

• 简单的文件操作（Claude 会直接处理）
• 第一次尝试修复问题（先自己试试）
• 简单的问题（没必要委派）

用你自己的风格写作

每当你的 Agent 撰写、审阅或更新以你的名义发布的文本时，写作编辑器都会运行：帖子、文章、新闻简报、发布说明、README 简介、PR 描述、个人简介、演讲摘要。你的 Agent 会先起草，然后编辑器会在你看到草稿之前检查它。编辑器会提供逐行修改建议、提出需要你提供额外信息的问题，并给出一份保留所有事实的改写稿。对于重要的文章，可以在草稿上运行 /consensus，由评审组使用 writing-editor persona 进行审阅。

编辑器需要了解你平时的写作方式。有了相关素材，它才能做得更好；否则只能删减赘词。简短的风格文件最有帮助。将它保存在你的仓库中，并指明文件位置（“使用我在 docs/voice.md 中的风格文件”）：

# <Your name> - voice

## How to use this file
- These rules beat any default style rule.
- Samples show rhythm only. Do not copy their phrases.
- Never invent a fact, number, person, customer, or quote.

## What I argue from
- 3-7 beliefs you keep coming back to, in your words.

## Mechanics
- "I" or "we", contractions or full forms, sentence length mix.
- Name the specific thing. A number beats an adjective, and every number needs a source.
- Typography you use (dashes, quotes, heading case).

## Moves
| Move | Use only when | My own example |
|------|---------------|----------------|
| <a habit of yours> | <the condition> | "<a real line you wrote>" |

At most one move per short post.

## Would sound wrong
| Wrong | Why |
|-------|-----|
| "Thrilled to share" | Launch voice. Say what shipped. |
| "Here's the thing", "Sound familiar?" | Run-up. Start with the thing itself. |
| A one-line quotable closer | End on the last concrete fact. |

## Channels
- LinkedIn: the hook fits before the "see more" cut, 1-3 sentence paragraphs, no closing question.
- Blog: ...

## Samples (rhythm only)
- 5-10 short lines you wrote yourself: posts, replies, talk transcripts.

文件中的两个部分最能发挥作用。每种写作手法都有适用条件，因此编辑器不会在每篇帖子里都套用你的标志性句式（习惯用语过度使用也会显得像机器生成）。“听起来不对劲”表格列出了你绝不会写的表达。手动编辑草稿时，把你对风格所做的调整作为规则添加到文件中。

选择模型：

• 使用多个模型系列进行审阅。/consensus 配合 writing-editor persona，会将草稿发送给共识评审组中的每个模型。不同系列的评审者往往会指出不同的问题（一个会注意文章的脉络，另一个会发现你从未提出过的论断）。

• 为改写稿单独创建模型记录。仅限 writing-editor 使用的记录只参与文本审阅，因此不会影响代码审阅的设置。写作时的温度可以高于审阅通常使用的 0.2。根据模型如何改写你提供的样例来选择，而不是根据基准测试成绩：

  "models": {
    "prose": {
      "provider": "openrouter",
      "model": "<provider/model whose prose you like>",
      "experts": ["writing-editor"],
      "consensus": true,
      "temperature": 0.7
    }
  }
  

• 只有 Gemini 能将改写稿写回文件（实现模式）。其他模型会以文本形式返回改写稿。

编辑器不会给文本评定“AI 生成可能性”，也不承诺任何检测结果。它也绝不会为了让文本看起来像人写的而故意加入错别字或语法错误。

如何使用

描述你的任务。你的 Agent 会判断何时需要专家帮助，并自动委派（示例展示的是 Claude Code）：

You: "Is this authentication flow secure?"
Claude: routes to the Security Analyst, then synthesizes the findings.

你也可以明确提出请求：“请 GPT 审阅这个架构”“请 Gemini……”，或“请 Grok……”。每位专家都会以只读方式进行分析；Gemini 也可以在拥有写入权限的情况下运行并应用修复，而你的 Agent 会根据请求选择运行模式。

也可以直接调用斜杠命令——参见上文的命令。

/consensus 和 /ask-* 如何确保模型保持客观

本节使用 Claude Code 的命令名称；“Claude”指负责协调运行的宿主 Agent。在其他宿主环境中，你自己的 Agent 会通过 consensus-step 工具发挥这一作用（或者由服务通过 consensus 发挥这一作用），遵循相同的规则。

/ask-gpt、/ask-gemini、/ask-grok 和 /ask-all 是快捷命令：每个命令会调度一个或三个外部模型，由 Claude 阅读输出，然后为你整理出一份综合回答。单次调用，没有循环，也没有同伴评审环节。

/consensus 则是更全面的命令。它同样会并行调度模型，但还会加入同伴评审环节和多轮循环，直到模型达成一致才会停止。代价是：协调器（Claude）会编写评审提示词、投票、判断哪些异议成立，并运行循环。如果不加限制，这种设置可能会悄悄地为自身的计划背书。四项保障措施可以避免这一点。

查看包含偏见防护机制和各模型流程的详细图示

四项防护机制：

• 盲评结论。 Claude 会在调用评审小组的消息之前，先单独发送自己的结论（APPROVE / REQUEST CHANGES / REJECT）。这份预先承诺会保留在对话记录中，因此 Claude 无法在看到其他模型的意见后改变自己的看法。引擎会强制执行这一点：记录盲评结论之前，不会揭示评审小组的意见。
• 同行评审。 每个外部模型都会独立评审计划，并返回结论和分类后的关键问题；Claude 作为仲裁者权衡这些意见。模型负责投票，Claude 负责裁决。
• 禁止自我批准。 只有在每个作出回应的外部模型都表示批准，且至少有一个外部模型实际作出回应时，轮次才会收敛。Claude 自己的批准不能单独让轮次通过。出错的提供方（例如未配置的 Grok 返回 missing-auth）会从计数中剔除，而不会卡住循环。
• 不得默默驳回。 最终报告必须为每个被驳回或延后的关键问题附上一句理由，包括 Claude 撤回自己某项盲评异议的情况。若裁决驳回问题却未提供理由，引擎会拒绝该裁决。

/ask-* 命令也采用同一规则的简化版本。外部模型只提供建议：Claude 阅读输出后运用自己的判断，并对综合后的回答负责。模型意见一致时，这只是输入，而非结论。

每个委派提示词还会包含当天的 UTC 日期，并规定不得仅凭记忆就声称某个不熟悉的模型、工具或版本不存在：数月前训练完成的模型遇到这类说法时，应标记为 [unverified]，而不是将其列为关键问题。核实实际情况仍由 Claude 负责，因为它有工具可用；Grok 和 OpenRouter 则没有。详见 TECHNICAL.md。

配置

完整的设置和配置参考见 SETUP.md。其中涵盖：

• 专家模式 - 咨询模式（read-only）与实现模式（workspace-write），根据你的请求自动选择
• 配置文件 - 位置（~/.config/deliberation/config.json）、DELIBERATION_CONFIG 覆盖项和热重载
• 配置分区 - providers、models、routing、consensus、sessions、debug、orientation、dashboard，并附带最简示例
• OpenRouter 模型 - 声明记录、askAll / consensus 资格、扇出、reasoningEffort 和仲裁器选择；consensus 还会配置轮数上限（maxRounds）和墙钟时间预算（maxWallMs，默认 30 min）
• GPT 模型与推理力度 - providers.codex.model 和 providers.codex.reasoningEffort 固定 codex exec 运行时使用的配置，并优先于 ~/.codex/config.toml
• 超时 - providers.defaults.timeout 可一次性提高所有提供方的单次调用上限；providers.<name>.timeout 可覆盖单个提供方的设置，而固定模型的 models.<id>.timeout 仍拥有最高优先级。主机上限（由 Claude Code on the web 设置的 MCP_TOOL_TIMEOUT）会限制所有这些值，并在超时消息中注明。遭遇速率限制（HTTP 429）的调用会重试一次，并遵循上游的 Retry-After
• 调试日志 - 可选的延迟 / 令牌 / 投票跟踪
• 会话持久化 - 可选的磁盘运行历史记录（包括由主机驱动的 /consensus 循环）和 session-* 工具；sessions.captureText（默认关闭）还会存储提供方响应正文（经过清理）
• 仪表板 - 可选的本地只读浏览器视图，以状态图形式查看实时和过往运行，以及配置、提供方健康状况和用量统计。dashboard.capture 可选择仅记录元数据（默认）或完整提示词和响应；写入时会清理密钥，提供内容时则会隐藏个人身份信息（PII），除非启用 dashboard.showPII。仅限环回地址访问，并受令牌保护。每次运行都会记录其项目（按 Git 远程仓库 org/repo 分组，并将发起调用时所在的检出目录作为工作区）；每次提供方调用都会记录其请求大小和实际使用的超时值，Analyzer 选项卡会据此生成可移除项和超时建议。使用 /deliberation:dashboard 或 deliberation-mcp dashboard 启动；使用 /deliberation:dashboard restart 或 npm run dashboard:restart 重启；使用 deliberation-mcp dashboard --stop 停止

启用遥测后，配置历史会记录经清理的有效配置快照和运行来源信息。仪表板的 Stats 共用分析时间 / 配置筛选条件；Config 会分别显示 Ask / Consensus 的推理力度，以及运行时实际生效 / 待生效的设置。并行的同行模型会在主机 / 共识预算范围内共用所选的最长超时值（设置 routing.timeoutPolicy: "per-provider" 可不采用此策略）。将面板的 fanoutId 传递给每次渐进式 ask-one 调用，即可固定设置并共用截止时间，即使未启用仪表板日志记录也适用。使用 analyze {groupBy:"config", since:"24h"} 分析历史队列，也可按完整的 configId 或 activationId 进一步筛选。

有关提供方内部机制、环境变量和手动配置 MCP 的信息，请参阅 TECHNICAL.md。

作者

由 Anton Babenko 维护 - LinkedIn，X/Twitter。

贡献

欢迎贡献。工作流、提交规范和自动发布流程请参阅 CONTRIBUTING.md。

许可证

MIT