@dmsdc-ai/aigentry审议
通过MCP进行结构化的多AI讨论。
唯一允许多个AI代理在做出决定之前对问题进行辩论的MCP服务器。在CLI代理(Claude Code、Codex、Gemini)和浏览器LLM(ChatGPT、Claude Web、Gemini Web)之间进行结构化讨论,并提供完整的审计跟踪、投票跟踪和综合。
它做什么
- 结构化审议会议 --提出一个话题,路线转向每个演讲者,收集\[同意\]/\[不同意\]/\[\[有条件\]投票,综合共识
- 智能音箱订购 --平衡参与的循环、随机或加权随机策略
- 人物角色 --使用内置提示模板分配评论家、实现者、调解员、研究人员或自由角色
- 浏览器LLM集成 --基于CDP的ChatGPT、Claude Web、Gemini Web等自动转换;剪贴板回退不受支持的提供程序
- 类型化合成输出 --结构化
ExecutionContractV2包含决策、可操作任务和可选实验结果的信封,用于下游自动化
安装
一个命令install--使用Claude Code和Gemini CLI自动注册MCP服务器:
npx --yes --package @dmsdc-ai/aigentry-deliberation deliberation-install这将服务器安装到 ~/.local/lib/mcp-deliberation/ (Windows: %LOCALAPPDATA%/mcp-deliberation/),将其注册到 ~/.claude/.mcp.json 和 ~/.gemini/settings.json,并安装 deliberation-gate 技巧 ~/.claude/skills/.
安装后重新启动Claude Code/GGemini CLI。就这样
全局安装(备选):
npm install -g @dmsdc-ai/aigentry-deliberation && deliberation-install卸载:
npx --yes --package @dmsdc-ai/aigentry-deliberation deliberation-install --uninstall自动删除MCP注册、已安装文件和技能文件。
诊断:
npx --yes --package @dmsdc-ai/aigentry-deliberation deliberation-doctor自动诊断Claude Code、Codex CLI和Gemini CLI的MCP配置。
论坛演示
审议完成后,合成结果可以显示为论坛视图。
审议是一个过程。论坛是产出。审议结束后,论坛即告成立。
open demo/forum/index.htmlMCP工具
| 工具 | 说明 |
|---|---|
deliberation_start | 开始新的审议会议 |
deliberation_respond | 提交演讲者的回应 |
deliberation_synthesize | 生成综合报告 |
deliberation_status | 检查会话状态 |
deliberation_context | 加载项目上下文 |
deliberation_inject_context | 将结构化上下文或实验历史注入活动会话 |
deliberation_history | 查看讨论历史记录 |
deliberation_list_active | 列出活动会话 |
deliberation_list | 列出已存档的会话 |
deliberation_reset | 重置会话 |
deliberation_speaker_candidates | 列出发言者名单 |
deliberation_confirm_speakers | 确认用户选择的扬声器组 |
deliberation_browser_llm_tabs | 列出打开的浏览器LLM选项卡 |
deliberation_browser_auto_turn | 通过CDP自动向浏览器发送LLM |
deliberation_route_turn | 路线转向合适的交通方式 |
deliberation_run_until_blocked | 自动运行混合运输,直到完成或手动阻塞 |
deliberation_request_review | 请求审议参与者进行代码审查 |
deliberation_cli_auto_turn | 自动发送转向CLI扬声器 |
deliberation_ingest_remote_reply | 接收来自远程参与者的回复,其中包含明确的源元数据 |
deliberation_cli_config | 配置CLI设置 |
启动流程
在会话开始之前,必须强制选择发言人。原始候选令牌不能启动审议。
1. deliberation_speaker_candidates(...)
2. User picks speakers in the TUI
3. deliberation_confirm_speakers(selection_token: "", speakers: [...])
4. deliberation_start(selection_token: "", speakers: [...])演讲者订购策略
| 策略 | 描述 |
|---|---|
cyclic | 顺序循环(默认) |
random | 每轮随机选择 |
weighted-random | 优先考虑发言较少的人 |
人物角色
| 角色 | 焦点 |
|---|---|
critic | 风险分析、弱点、反驳 |
implementer | 技术可行性、代码设计 |
mediator | 建立共识、综合 |
researcher | 数据、基准、参考 |
free | 无角色约束(默认) |
支持的CLI扬声器
| CLI | 命令 | 状态 |
|---|---|---|
| 克劳德代码 | claude | 已测试 |
| Codex CLI | codex | 已测试 |
| Gemini CLI | gemini | 已测试 |
| 助手 | aider | 支持 |
| 光标代理 | cursor | 支持 |
| OpenCode | opencode | 支持 |
| 继续 | continue | 支持 |
支持的浏览器LLM
| 提供者 | 传输 | 状态 |
|---|---|---|
| ChatGPT | CDP/剪贴板 | 已测试 |
| Claude Web | CDP/剪贴板 | 已测试 |
| Gemini Web | CDP/剪贴板 | 已测试 |
| DeepSeek | CDP/剪贴板 | 已测试 |
| Qwen | CDP/剪贴板 | 已测试 |
| Poe | CDP/剪贴板 | 已测试 |
| 副本 | CDP/剪贴板 | 支持 |
| 困惑 | CDP/剪贴板 | 支持 |
| Mistral | CDP/剪贴板 | 支持 |
| Grok | CDP/剪贴板 | 支持 |
| 拥抱聊天 | CDP/剪贴板 | 支持 |
例子
看 examples/ 用于工作会话脚本和合成输出示例。
实验回顾
对于自动搜索风格的保留/丢弃评论,在会话开始后注入一个紧凑的实验包,而不是膨胀 topic.
指导方针:
- 将注入的JSON保持在1.5-2KB左右
- 仅包括最后3-5个相关实验
- 保持
key_changes在成对之前/之后最多3个标量 - 参考笨重的文物(
results.tsv,满program.md,JSONL日志)仅按路径
deliberation_start(...)
deliberation_inject_context(
session_id: "experiment-review-123",
speaker: "dustcraw",
context: "{\"past_experiments\":[{\"experiment_id\":\"dg-20260310-001\",\"signal_kind\":\"INTEREST_DRIFT\",\"patch_summary\":\"Raised relevanceThreshold from 0.30 to 0.35\",\"patch_kind\":\"config\",\"key_changes\":{\"relevanceThreshold\":{\"before\":0.3,\"after\":0.35}},\"score\":0.08,\"score_label\":\"promotion_rate_delta\",\"metric_name\":\"promotion_rate_delta\",\"metric_delta\":0.08,\"verdict\":\"positive\",\"followup_action\":\"kept\",\"reasoning\":\"Threshold raise reduced noise; promotion quality improved 8%\"}],\"experiment_count\":1,\"success_rate\":1.0}"
)带有明确实验结论的合成输出:
{
"summary": "Lower the blast radius and re-run with stricter constraints.",
"decisions": [
"Keep the experiment loop bounded to one editable file",
"Retry after restoring the failing test baseline"
],
"actionable_tasks": [
{ "id": 1, "task": "Tighten editable globs", "priority": "high" }
],
"experiment_outcome": {
"verdict": "modify",
"suggested_action": "iterate",
"confidence": 0.78,
"measurement_window_hours": 24
}
}审议门(超级大国一体化)
安装一项技能,在密钥处插入多个AI验证门 超级大国 工作流决策点。
情节:
- 头脑风暴 --编写计划前的多AI设计验证
- 代码审查 --通过多AI审核
deliberation_request_review - 调试 --卡住时的多AI假设验证
触发: 半自动——技能推荐深思熟虑,用户认可。
退路: 如果没有安装MCP,则退回到基于自我批评的验证。安装MCP后,运行完整的多AI讨论。
自动安装 通过 deliberation-install.手动安装:
cp skills/deliberation-gate/SKILL.md ~/.claude/skills/deliberation-gate/SKILL.mdRFC: 工具相关技能的先决条件标题
远程运输(高级)
对于使用 电话 为了管理人工智能会话,审议支持通过电话总线进行路由转弯,从而实现了跨机器和跨会话的审议流。
deliberation_route_turn已打印的出版物turn_request信封上ws://localhost:3848/api/busdeliberation_run_until_blocked继续跨越cli_respond,browser_auto,以及telepty_bus扬声器直到手动块- 运输交付跟踪时间为5秒
inject_writtenack窗口 - 通过60秒的自我提交窗口跟踪语义完成
deliberation_synthesize验证并发出类型deliberation_completed下游自动化信封
跨机器事件目录
- 保证(守护进程已发出):
inject_written,session_health,session_register,session.replaced,session.idle,thread.opened,thread.closed,handoff.*,message_routed - 尽最大努力(仅限公共汽车接力):
turn_request,turn_completed,deliberation_completed kind是规范事件鉴别器target识别电视会话目标payload.prompt是的规范提示字段turn_requestsource_host是用于跨机器跟踪的可选传输元数据
远程回复入口
对于远程参与者无法直接调用本地MCP工具的分布式设置,请使用审议拥有的语义入口,而不是代理原始总线事件:
deliberation_ingest_remote_reply(
session_id: "...",
speaker: "...",
turn_id: "...",
content: "...",
source_machine_id: "peer-01",
source_session_id: "remote-gemini-001",
transport_scope: "remote_mcp",
artifact_refs: ["results.jsonl"]
)这保留了显式的起源,而不是从原始总线事件中推断语义。
最新动态
v0.0.39
- 权限层——审议功能的自由/专业/团队层门控
- Gemini CLI模型标志和Codex GPT-5.4路由改进
v0.0.36
- 澄清了强制性TUI扬声器选择流程,并在之前确认了令牌切换
deliberation_start - 使用轻量级工具记录活动电视会话发现
session_id+host/pid定位器 - 跨项目交付:活动会话查找现在跨项目状态目录解析
v0.0.35
- 手动选择强制执行:
deliberation_confirm_speakers将新的候选快照绑定到之前用户选择的确切扬声器集deliberation_start - 电话会议候选人:使用轻量级主机/pid定位器在说话者发现中出现活动电视会话
- Telepty巴士路线:电话扬声器通过打字路由
turn_request具有5s传输和60s语义超时跟踪的信封 - 结构化合成包络:
deliberation_synthesize在telety总线发布之前验证键入的有效载荷 - Codex CLI硬化:减少了提示预算,降低了执行难度,更清晰的超时诊断
许可证
麻省理工学院
