kavyrshin/Consilium

Consilium

tests release License: MIT

Русская версия

一个用于 Claude Code 和 Codex 的技能，它会运行一次 consilium（审议）：多个独立模型审查同一个技术问题，两名仲裁者将各方的审查合并为一份草案决策，只有在你确认之后，实施者才会进行更改，验证者再对其进行检查。人类始终是最终仲裁者；没有任何模型拥有决定权。

一个文件夹，一个 SKILL.md，纯 bash 脚本。该流程产生的所有内容都是你项目中的普通 markdown 文件，因此它可审查、可 diff，并且归你所有、由你保存。

brief.md ─┬─► host review (the agent you are talking to)  ┐
├─► reviewer 2 (external CLI, in parallel)      ├─► decision.md  ─► you confirm
└─► reviewer 3 (external CLI, in parallel)      ┘   (DRAFT, two arbiters)
│  only after confirmation
implementer ─► verifiers ─► implementer fixes ─► you review the diff

为什么

一个模型审查自己的想法时，往往会赞同自己。来自不同模型的独立审查会发现不同的问题，而强制每个模型在阅读其他模型的意见之前先写下事实、假设、风险和一项建议，能让它们保持诚实。仲裁者必须明确陈述分歧，而不是把它们平均掉，并且由脚本（而非模型）记录谁没有作答。

要求

- bash 3.2+（macOS 自带版本即可）、git、python3；Node.js 18+ 仅用于可选的阅读器
- 你的 PATH 中至少有一个 agent CLI。你拥有的每一个都会成为可用的审查者、仲裁者、验证者或实施者：

| 适配器 | CLI | 备注 |
| --- | --- | --- |
| claude | Claude Code (claude -p) | |
| codex | Codex CLI (codex exec) | 模型来自 ~/.codex/config.toml |
| opencode | Open Code (opencode run) | 需要 CM_OPENCODE_MODEL，见下文 |
| deepseek | DeepSeek Harness (dsh) | 可选，未找到时不启用 |
| mock | 无 | 写入占位文本；用于在没有任何模型的情况下试用该流程 |

更多内容：编写你自己的适配器，它只是一个约 10 行的文件。

宿主（host） 是你在其中运行该技能的任意 agent。它亲手撰写自己的审查，因此绝不会被第二次启动。即使只安装了一个 CLI，consilium 仍会运行，只是评审团规模更小，并且决策中会说明这一点。

安装

稳定版本（推荐）：

git clone --branch v0.1.0 --depth 1 https://github.com/kavyrshin/Consilium.git
cd Consiliumbash
./install.sh                # 每个配置目录存在的 agent（~/.claude、~/.codex）

最新开发版本：
bash
git clone https://github.com/kavyrshin/Consilium.git
cd Consilium
./install.sh                # 每个配置目录存在的 agent（~/.claude、~/.codex）

选项：--claude、--codex、--agents（~/.agents/skills）、--dir PATH（例如 ./.claude/skills 用于单个项目）、--symlink（编辑仓库，实时查看更改）、--force、--uninstall。

或者手动将 skills/consilium/ 复制到你的 agent 的 skills 目录中。

使用

在你的 agent 中：

| Agent | 调用 |
| --- | --- |
| Claude Code | /consilium 我们应该把 X 缓存在 Redis 中还是进程内？ |
| Codex | $consilium 我们应该把 X 缓存在 Redis 中还是进程内？ |

该技能设置为仅在你要求时运行：它会消耗模型配额，并将项目文件发送给多个提供商。

会发生什么：

1. agent 显示面板（run-reviewers.sh --plan）并创建 consilium/-/。
2. 它研究事实（只读）并填写 brief.md。在 brief 完成之前，审查者不会收到任何内容。
3. 外部审查者在后台并行启动。agent 在不阅读他们内容的情况下撰写自己的审查。
4. 当所有人都已答复或失败时，一个监视器起草 decision.md。两位仲裁者：第一位起草，第二位修订，并且必须记录分歧。
5. 你阅读并确认草稿。 在此之前不会实施任何内容（除非你事先说明了）。
6. 实施者仅应用“Authorized code changes”中列出的内容，在单独的 git worktree 中进行；验证者独立检查；实施者修复他们发现的问题。不提交，不推送。

查看 examples/ 了解案例文件夹的样子。

配置

纯 KEY=VALUE，位于 /.consilium.conf 或 ~/.config/consilium/config。环境变量优先于项目文件，项目文件优先于用户文件。文件是被解析的，从不执行。项目文件被视为不受信任，因为它随你克隆的任何仓库而来：它只能设置面板、语言、模型、超时以及项目内的相对案例文件夹。加载代码或运行命令的设置（CM_ADAPTERS_DIR、CM_NOTIFY_CMD）以及项目外的路径仅从环境变量或你的用户配置中接受；该技能会打印它忽略了什么。从 consilium.example.conf 开始。

| 设置 | 默认值 | 含义 |
| --- | --- | --- |
| CM_LANG | en | 文档语言：en 或 ru（参见下文添加更多） |
| CM_HOST | claude | 运行该技能的 agent（claude / codex） |
| CM_REVIEWERS | claude codex opencode deepseek | 外部审查者适配器；不可用的会被跳过并报告 |
| CM_ARBITERS | codex claude | 列表中前两个可用的合成草稿 |
| CM_VERIFIERS | codex claude | 并行验证实现 |
| CM_IMPLEMENTERS | claude codex opencode | 第一个可用的实现者 |
| CM_OUT_DIR | consilium | 案例文件夹，相对于项目根目录 |
| CM_OPENCODE_MODEL(S) | 未设置 | 必需以启用 Open Code：opencode 在无头模式下没有默认模型 |
| CM_CODEX_MODEL、CM_CLAUDE_MODEL、CM_CLAUDE_EFFORT | CLI 自带的 | 模型覆盖 |
| CM_*_TIMEOUT | 30 / 15 / 45 / 45 分钟 | 审查 / 决策 / 验证 / 实现 |

预览谁会运行、谁会被跳过，而不启动任何东西：
bash
bash ~/.claude/skills/consilium/scripts/run-reviewers.sh --plan   # installed for Claude Code
bash ~/.codex/skills/consilium/scripts/run-reviewers.sh --plan    # installed for Codex

语言

英语是默认语言，俄语已内置（CM_LANG=ru）。要添加一种语言，请将 skills/consilium/lang/en.sh 和 skills/consilium/templates/en/ 复制到你的代码中，翻译其中的值，设置 CM_LANG=。章节标题是契约的一部分（决策验证器会精确匹配它们），因此请更改措辞，而不是机制。

阅读器

一个用于阅读案例的本地网页：侧边栏中显示每个案例，文档按处理顺序显示（简报、审查、决策、实现），并在审查者和仲裁者撰写时实时更新。需要 Node.js 18+。
bash
bash ~/.claude/skills/consilium/scripts/reader.sh --open     # http://localhost:4600

从项目根目录运行它（如果你为 Codex 安装，则为 ~/.codex/...）。--port N 可更改端口。它仅监听 127.0.0.1，拒绝外部 Host 标头，除了案例 markdown 之外不提供任何内容，并在严格的内容安全策略下对文档进行清理后渲染：这些文档是由可能读取过恶意内容的模型编写的。

通过 ngrok 共享

要将案例展示给你机器之外的人，请以公共模式运行阅读器，并在其前面放置一个隧道：
bash
bash ~/.claude/skills/consilium/scripts/reader.sh --public   # prints a user and a one-time password
ngrok http 4600                                              # in a second terminal

将 https://….ngrok-free.app URL 和密码分开发送。公共模式要求每个请求都提供密码（用 CM_READER_PASSWORD 设置你自己的密码，12 个字符以上），并隐藏你的本地路径。

共享前请三思：任何拥有 URL 和密码的人都可以读取该文件夹中的每个案例，而案例会引用你的代码。完成后请停止这两个进程（Ctrl+C）。为了获得更强的保护，ngrok 还可以通过流量策略在隧道前要求 Google 或 GitHub 登录。

数据与隐私
在将其用于私有代码之前，请先阅读此内容。 每个审查者、仲裁者、验证者和实现者都是一个代理 CLI，它会读取你的项目文件，并将其读取到的内容发送给其提供商。一个四人小组意味着最多四个提供商可以看到你的代码。一些免费或“贡献者”层级与付费层级的数据条款不同；请逐一检查。使用 CM_REVIEWERS= / --plan 来控制谁参与。

安全模型

- 审查者、仲裁者和验证者被要求不要修改代码；只有实现者更改文件，且仅在你提供给它的工作树内，仅限已确认决策所授权的范围。它从不提交、推送或切换分支。
- Codex 以 --sandbox workspace-write 运行；Claude 在无头模式下以显式工具允许列表运行（读/写/编辑/搜索，仅验证者和实现者可额外使用 shell）。验证者和实现者可以运行命令：给它们一个工作树，而不是你唯一的副本。
- 仲裁者写入候选文件，绝不写入 decision.md；候选文件仅在其结构验证通过后才会发布，如果仲裁者触碰了活动文件，该文件会逐字节恢复。
- “不完整小组”说明由脚本根据磁盘上存在的内容写入，绝不由模型写入。
- 决策始终是带有横幅的草稿；由人类确认。

布局

skills/consilium/
SKILL.md                 该技能（Claude Code 和 Codex 读取同一文件）
agents/openai.yaml       Codex 元数据：不会自动调用
scripts/                 init-case、run-reviewers、run-reviewer、watch-and-decide、
write-decision、implement、verify、lib.sh、mock-agent
scripts/adapters/        每个代理 CLI 一个文件
reader/                  本地 Web 阅读器（reader.sh 启动它）
lang/  templates/        每种语言的措辞
consilium.example.conf
install.sh   tests/   docs/   examples/

测试
bash
bash tests/run.sh

语法检查、shellcheck（如果已安装），以及在模拟适配器上的端到端运行：两种语言的流水线、仲裁者回退、活动文件保护、超时、实现/验证、安全配置解析。无网络，无模型调用。

状态

脚本和模拟流水线已经过测试；claude、codex、opencode 和 deepseek 适配器封装了真实 CLI，其标志在不同版本之间会发生变化，因此请先运行 --plan 并尝试一个小问题。欢迎反馈 CLI 版本相关的问题。

许可证

MIT