council-review

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Council Review

顾问团评审

Run any question, plan, or code through 5 independent advisors who use distinct reasoning methods, collaborate to refine answers, peer-review each other anonymously, and synthesize a verdict you can trust.
This skill implements the Diverse Multi-Agent Debate (DMAD) pattern. It is collaborative, not adversarial: agents seek truth through diversity of reasoning, not by arguing opposing positions.
让任意问题、方案或代码通过5位独立顾问的评审,他们采用独特的推理方法,协作优化答案、匿名互评,并得出你可以信赖的结论。
该技能实现了**多样化多Agent辩论(DMAD)**模式。它是协作式而非对抗式的:Agent通过推理的多样性探寻真相,而非通过对立立场争论。

Why This Works (Research Backing)

为何有效(研究支持)

  • Method diversity beats single-method debate. DMAD (ICLR 2025) shows that agents using distinct reasoning methods reliably outperform homogeneous councils — diverse medium-capacity models can beat GPT-4 on GSM-8K (91% vs 82%) when each agent applies a different reasoning approach.
  • Collaborative debate beats adversarial debate. M3MADBench (2026) shows that across all modalities, collaborative DMAD outperforms adversarial Div-MAD "by a substantial margin." Adversarial paradigms introduce divergent noise; for open questions, plans, and decisions, collaborative deliberation is the right tool.
  • Anonymous peer review prevents provider bias. Universal across the literature — reviewers defer to role names if visible, so peer-review responses must be shuffled.
  • Confidence calibration breaks the martingale ceiling. Vanilla MAD often underperforms simple majority vote; confidence-modulated updates ("Demystifying MAD" 2026) systematically drift the council toward correct answers.
  • Adaptive stopping cuts cost. KS-statistic convergence detection (S2 MAD via llmcouncil) reports up to 94.5% cost reduction on convergent questions.
  • A true devil's advocate is the only reliable disagreement-inducer (V2). Across techniques for breaking consensus in multi-agent LLM teams, only a dedicated devil's advocate attacking the emerging answer produces genuine disagreement — soft role-framing and "please dissent" instructions test statistically indistinguishable from baseline. An LLM devil's advocate that challenges the recommendation measurably raises group decision accuracy (OpenReview 2026; IUI 2024). V2 adds this as a mandatory pass against the consensus — one devil's advocate vs the converged answer, not a standing advocates/skeptics split.
  • Sycophancy collapses councils into premature consensus (V2). LLMs defer — to each other and to the answer implied by the framing — which can drop a council below single-agent accuracy (Peacemaker-or-Troublemaker 2026; CONSENSAGENT). V2 adds a sycophancy guardrail to advisor + peer prompts and a structured independent-assessment step (Kahneman's Mediating Assessments Protocol, 2019) so the chairman judges key attributes separately before the holistic call.
For stress-testing a known artifact (PR, draft, spec), use the separate
/adversarial-review
skill instead — single-critic adversarial probing is the right tool there.
  • 方法多样性优于单一方法辩论。DMAD(ICLR 2025)表明,使用不同推理方法的Agent能持续优于同质化顾问团——当每个Agent采用不同推理方式时,多样化的中等容量模型在GSM-8K上的表现可超越GPT-4(91% vs 82%)。
  • 协作式辩论优于对抗式辩论。M3MADBench(2026)表明,在所有模态下,协作式DMAD的表现都大幅优于对抗式Div-MAD。对抗范式会引入分歧噪声;对于开放性问题、方案和决策,协作式审议是正确的工具。
  • 匿名互评可避免提供者偏见。这在文献中已被普遍证实——如果能看到角色名称,评审者会偏向特定角色,因此互评回复必须随机打乱。
  • 置信度校准打破鞅上限。常规MAD的表现往往不如简单多数投票;置信度调节更新(《Demystifying MAD》2026)能系统地引导顾问团得出正确答案。
  • 自适应停止降低成本。KS统计量收敛检测(通过llmcouncil实现的S2 MAD)显示,对于收敛性问题,成本可降低多达94.5%。
  • 真正的魔鬼代言人是唯一可靠的分歧诱导者(V2版本)。在打破多Agent LLM团队共识的各类技术中,只有专门针对现有答案发起攻击的魔鬼代言人能产生真实分歧——温和的角色设定和“请提出异议”的指令在统计上与基线无差异。挑战建议的LLM魔鬼代言人能显著提高群体决策的准确性(OpenReview 2026;IUI 2024)。V2版本新增了这一环节,作为对共识的强制检验——由一位魔鬼代言人针对已达成的共识发起挑战,而非从一开始就设置支持者/怀疑者阵营。
  • 谄媚会导致顾问团过早达成共识(V2版本)。LLM会顺从——顺从彼此,也顺从框架隐含的答案——这可能导致顾问团的表现不如单个Agent(《Peacemaker-or-Troublemaker》2026;CONSENSAGENT)。V2版本在顾问和评审的提示中添加了防谄媚约束,并引入结构化独立评估步骤(卡尼曼的调解评估协议,2019),让主席在做出整体判断前,先分别评估关键属性。
若要对已知工件(PR、草稿、规范)进行压力测试,请使用单独的
/adversarial-review
技能——单批评者的对抗性探查才是适合该场景的工具。

When to Use

使用场景

The council is for questions where being wrong is expensive.
Good for: Architecture decisions, implementation plans, PR reviews, product decisions, migration strategies, API design, naming, pricing, scope decisions Bad for: Factual lookups, writing tasks, simple yes/no, anything with one obvious right answer Use a different tool: Single-critic stress test of an existing artifact →
/adversarial-review
顾问团适用于出错代价高昂的问题。
**适用场景:**架构决策、实施方案、PR评审、产品决策、迁移策略、API设计、命名、定价、范围决策 **不适用场景:**事实查询、写作任务、简单的是/否问题、有明显唯一正确答案的问题 **使用其他工具:**对现有工件进行单批评者压力测试 →
/adversarial-review

Flags

标记

FlagEffect
--quick
Lite mode: 3 advisors + chairman, no peer review (4 calls instead of 11)
--adaptive
KS-statistic adaptive stopping. Run multi-round debate; halt when response distributions converge below epsilon for two consecutive rounds. Up to 94.5% cost cut on convergent questions.
--confidence
Confidence-modulated synthesis. Each advisor rates own confidence (1–10) and rates each peer's confidence. Chairman synthesis is confidence-weighted, not majority-vote. Surfaces low-confidence consensus as a yellow flag.
--measure-diversity
After advisors respond, score reasoning-footprint overlap across the responses. Report when the council agreed despite different reasoning methods — that's a signal the consensus may be theatrical.
--jury
(V2) Replace the single chairman with a 3-judge jury, ideally across different model families. Each judge synthesizes independently; a brief reconciliation step merges them. For close calls and high-stakes verdicts where single-judge reliability isn't enough (jury-of-judges / PoLL).
Flags compose:
/council-review --adaptive --confidence "Should we adopt GraphQL?"
runs convergence-stopped, confidence-weighted deliberation.
标记作用
--quick
轻量模式:3位顾问+主席,无互评(4次调用而非11次)
--adaptive
KS统计量自适应停止。进行多轮辩论;当连续两轮的响应分布收敛到epsilon以下时停止。对于收敛性问题,成本可降低多达94.5%。
--confidence
置信度调节综合。每位顾问对自己的置信度评分(1–10),并对每位同行的置信度评分。主席的综合结果基于置信度加权,而非多数投票。低置信度共识会被标记为黄色警告。
--measure-diversity
收集顾问回复后,对回复中的推理足迹重叠度进行评分。当顾问团采用不同推理方法却达成一致时,需进行报告——这表明共识可能是表面性的。
--jury
(V2版本) 用3位法官组成的陪审团替代单一主席,法官最好来自不同模型家族。每位法官独立进行综合;通过简短的协调步骤整合结果。适用于结果难分高下、高风险的决策场景,此时单一法官的可靠性不足(法官陪审团/PoLL模式)。
标记可组合使用:
/council-review --adaptive --confidence "Should we adopt GraphQL?"
会运行收敛停止、置信度加权的审议流程。

The Five Advisors

五位顾问

#AdvisorAngleReasoning MethodCatches
1The ContrarianWhat will fail?Inversion — assume it shipped and failed, trace backward to the cause"Sounds great but..." gaps you skip when excited
2First Principles ThinkerWhat are we actually solving?Decomposition — break into atomic claims, challenge each one"You're optimizing the wrong variable"
3The ExpansionistWhat upside are we missing?Analogy — what adjacent domain solved this differently?"You're thinking too small"
4The OutsiderZero context, fresh eyes onlyNaive questioning — explain like you just joined; flag anything that requires insider knowledge to make senseCurse of knowledge blind spots
5The ExecutorWhat do you do Monday morning?Dependency graphing — what blocks what? What's the critical path?Brilliant plans with no actionable first step
Natural tensions: Contrarian vs Expansionist (downside vs upside), First Principles vs Executor (rethink vs ship it), Outsider keeps everyone honest.
The five reasoning methods are not interchangeable angles — each is a different cognitive operation. This is the DMAD lever: same model, different reasoning.

序号顾问角色视角推理方法擅长发现
1异议者哪些方面会失败?反转法 ——假设方案已上线并失败,回溯找出原因你兴奋时忽略的“听起来不错但……”的漏洞
2第一性原理思考者我们真正要解决的是什么?分解法 ——拆解为原子主张,逐一质疑“你在优化错误的变量”
3拓展者我们遗漏了哪些潜在收益?类比法 ——哪些相邻领域用不同方法解决了类似问题?“你的思考格局太小了”
4局外人零背景,全新视角朴素提问法 ——像刚加入团队一样解释问题;标记任何需要内部知识才能理解的内容知识诅咒导致的盲区
5执行者周一早上要做什么?依赖关系绘图法 ——哪些环节相互阻塞?关键路径是什么?缺乏可落地第一步的完美方案
**天然张力:**异议者vs拓展者(风险vs收益)、第一性原理思考者vs执行者(重新思考vs落地)、局外人确保所有人保持客观。
这五种推理方法不是可互换的视角——每种都是不同的认知操作。这是DMAD的核心优势:相同模型,不同推理方式。

Execution Flow

执行流程

Step 0: Pre-flight

步骤0:预检查

<pre_flight>
Parse flags from
$ARGUMENTS
:
  • If
    --quick
    is present: use Lite Mode (see below)
  • If
    --adaptive
    is present: enable KS-statistic adaptive stopping (Step 3.5)
  • If
    --confidence
    is present: enable confidence-modulated synthesis (Steps 2 and 4)
  • If
    --measure-diversity
    is present: enable diversity verification (Step 2.5)
  • If
    --jury
    is present: use a 3-judge jury at synthesis (Step 4)
  • Remove flags from the input before classifying
Scope validation: Before convening the council, assess whether the input actually warrants it. If the question is purely factual, has one obvious right answer, or has no meaningful tradeoff, say so directly: "This doesn't need a council — [direct answer]. Use
/council-review
for decisions with genuine stakes and tradeoffs." Do not spawn agents for trivial questions.
Classify the remaining input:
  1. PR — Numeric value, or URL containing
    /pull/
    . Fetch PR diff and description via
    gh pr view
    .
  2. File path — String ending in a file extension or pointing to an existing file. Read the file contents.
  3. Plan/Decision/Question — Everything else. Use as-is.
For PRs and files, read the actual content and include it in the framed question. Don't just pass a URL — advisors need the substance.
</pre_flight>
<pre_flight>
$ARGUMENTS
解析标记:
  • 如果存在
    --quick
    :使用轻量模式(见下文)
  • 如果存在
    --adaptive
    :启用KS统计量自适应停止(步骤3.5)
  • 如果存在
    --confidence
    :启用置信度调节综合(步骤2和4)
  • 如果存在
    --measure-diversity
    :启用多样性验证(步骤2.5)
  • 如果存在
    --jury
    :在综合阶段使用3位法官组成的陪审团(步骤4)
  • 在分类前从输入中移除标记
**范围验证:**在召集顾问团之前,评估输入是否确实需要顾问团。如果问题纯粹是事实性的、有明显唯一正确答案,或没有有意义的权衡,直接告知:“这个问题不需要顾问团——[直接答案]。请将
/council-review
用于存在真实风险与权衡的决策。”不要为琐碎问题生成Agent。
对剩余输入进行分类:
  1. PR —— 数字,或包含
    /pull/
    的URL。通过
    gh pr view
    获取PR差异和描述。
  2. 文件路径 —— 以文件扩展名结尾或指向现有文件的字符串。读取文件内容。
  3. 方案/决策/问题 —— 其他所有内容。直接使用。
对于PR和文件,读取实际内容并将其包含在构建的问题中。不要只传递URL——顾问需要实质内容。
</pre_flight>

Step 1: Gather Context and Frame

步骤1:收集上下文并构建问题

Auto-context gathering — before framing, read these project files (skip any that don't exist):
  • README.md
    — what the project does
  • CLAUDE.md
    or
    AGENTS.md
    — conventions, architecture, patterns
  • Recent git log (
    git log --oneline -10
    ) — what's been happening
  • Any files the user referenced or that relate to the topic
  • PR diff and description if reviewing a PR
Reframe the raw input as a clear, neutral prompt:
QUESTION:
[Core decision, plan, or code being reviewed]

CONTEXT:
[Key context from project files: what the project does, constraints, recent changes, stakes]

WHAT'S AT STAKE:
[Why this matters — cost of getting it wrong]
Don't add your own opinion. Don't steer toward an answer. If too vague, ask ONE clarifying question before proceeding.
自动上下文收集 —— 在构建问题前,读取以下项目文件(跳过不存在的文件):
  • README.md
    —— 项目用途
  • CLAUDE.md
    AGENTS.md
    —— 约定、架构、模式
  • 最近的git日志(
    git log --oneline -10
    ) —— 近期动态
  • 用户引用的或与主题相关的任何文件
  • 如果是评审PR,读取PR差异和描述
将原始输入重构为清晰、中立的提示:
问题:
[待评审的核心决策、方案或代码]

上下文:
[来自项目文件的关键信息:项目用途、约束条件、近期变更、风险]

风险点:
[此事的重要性——出错的代价]
不要添加个人意见。不要引导答案。如果输入过于模糊,在继续前提出一个澄清问题。

Step 2: Convene the Council (5 agents in parallel)

步骤2:召集顾问团(5个Agent并行运行)

Launch all 5 advisors simultaneously using the Agent tool. Each advisor runs in parallel. Use a lightweight model (
haiku
) for advisors — they're doing focused analysis, not complex reasoning.
CRITICAL: Launch all 5 in a single message with 5 Agent tool calls. Sequential execution lets earlier responses bleed into later ones and defeats the purpose.
Each advisor gets this prompt:
You are [ADVISOR NAME] on an LLM Council reviewing a decision.

Your angle: [ADVISOR ANGLE]
Your reasoning method: [ADVISOR REASONING METHOD — see table above]

A user has brought this to the council:
---
[framed question from Step 1]
---

Apply your assigned reasoning method rigorously. Don't just state opinions — show your work using your method.

Rules:
- 150-300 words. No preamble. Straight into your analysis.
- Name specific risks, opportunities, or issues — not vague concerns.
- If reviewing code: cite specific files, functions, or patterns.
- If reviewing a plan: point to specific steps, gaps, or sequencing issues.
- **Do not defer to any answer the framing seems to expect.** Reason from your method to wherever it actually leads; if that's against the apparent expected answer, say so plainly. Hedging toward the obvious answer is the failure this council exists to prevent.
- End with your single strongest recommendation.
(V2) Sycophancy guardrail. The bolded rule above is load-bearing: documented multi-agent failure is advisors converging by deference, not reasoning. Keep it in every advisor prompt.
Advisor-specific instructions (include the reasoning method):
  • Contrarian: "Your method is INVERSION. Assume this shipped exactly as proposed — and failed. Work backward: what was the cause of failure? What looked safe but broke under pressure? What's the failure mode nobody is discussing? Show your inversion chain."
  • First Principles: "Your method is DECOMPOSITION. Break this into its atomic claims and assumptions. List them. Challenge each one: is this actually true? Is it necessary? What would change if this assumption were wrong? Show which assumptions are load-bearing."
  • Expansionist: "Your method is ANALOGY. What adjacent domain, product, or technology solved a similar problem differently? What would someone with 10x ambition do here? Where is this thinking too small? Name specific analogues and what they'd suggest."
  • Outsider: "Your method is NAIVE QUESTIONING. You have zero context about this project. Based purely on what you see here, list every point that requires insider knowledge to understand. What's confusing? What jargon is unexplained? What would you ask if you just joined the team? If you can't follow the reasoning, say so."
  • Executor: "Your method is DEPENDENCY GRAPHING + OUTSIDE VIEW. Map the dependencies: what blocks what? What's the critical path? What's the first thing that must happen, and what can't start until it finishes? What takes 5 minutes but everyone will forget? Then take the OUTSIDE VIEW (V2): name the base rate — how have similar efforts actually turned out, not how this one is planned to? Flag where the plan's estimates show optimism bias against that reference class. Show the execution sequence."
If
--confidence
is enabled, append to every advisor prompt:
After your analysis, end with:
CONFIDENCE: [1-10]
RATIONALE: [one sentence — what would change your confidence up or down?]
This produces calibrated self-assessments the chairman will weight in synthesis.
使用Agent工具同时启动所有5位顾问。每个顾问并行运行。为顾问使用轻量模型(
haiku
)——他们进行的是聚焦分析,而非复杂推理。
关键:在一条消息中发起5个Agent工具调用,同时启动所有5位顾问。 顺序执行会让早期回复影响后期回复,违背设计初衷。
每位顾问会收到以下提示:
你是LLM顾问团中的[顾问名称],正在评审一项决策。

你的视角:[顾问视角]
你的推理方法:[顾问推理方法——见上表]

用户提交给顾问团的内容如下:
---
[步骤1中构建的问题]
---

严格应用你被分配的推理方法。不要只陈述观点——用你的方法展示分析过程。

规则:
- 150-300词。无需开场白。直接进入分析。
- 指出具体的风险、机会或问题——不要模糊的担忧。
- 如果评审代码:引用具体的文件、函数或模式。
- 如果评审方案:指出具体的步骤、漏洞或顺序问题。
- **不要顺从问题框架隐含的预期答案。** 从你的方法出发,得出实际结论;如果结论与预期答案相悖,直接说明。向明显答案妥协正是顾问团要避免的失败模式。
- 结尾给出你最有力的单一建议。
(V2版本) 防谄媚约束。 上述加粗规则至关重要:已有文献记载,多Agent系统的失败原因是顾问通过妥协达成共识,而非通过推理。请在每位顾问的提示中保留该规则。
顾问专属指令(包含推理方法):
  • 异议者: “你的方法是反转法。假设该方案完全按提议上线——但失败了。回溯:失败的原因是什么?哪些看起来安全的环节在压力下崩溃了?哪些失败模式无人讨论?展示你的反转推导链。”
  • 第一性原理思考者: “你的方法是分解法。将问题拆解为原子主张和假设。列出它们。逐一质疑:这是否真实?是否必要?如果该假设不成立,会有什么变化?指出哪些假设是核心支撑。”
  • 拓展者: “你的方法是类比法。哪些相邻领域、产品或技术用不同方法解决了类似问题?有10倍野心的人会怎么做?哪些思考格局太小?指出具体的类比对象及其启示。”
  • 局外人: “你的方法是朴素提问法。你对该项目毫无背景知识。仅根据你看到的内容,列出所有需要内部知识才能理解的点。哪些内容令人困惑?哪些术语未解释?如果你刚加入团队,会问什么问题?如果无法理解推理过程,直接说明。”
  • 执行者: “你的方法是依赖关系绘图法+外部视角。绘制依赖关系:哪些环节相互阻塞?关键路径是什么?必须先完成的第一件事是什么?哪些环节要等它完成才能启动?哪些只需5分钟但所有人都会忘记?然后采用外部视角(V2版本):指出基准比率——类似项目实际结果如何,而非该项目的计划结果。标记方案预估与参考类别相比存在乐观偏差的地方。展示执行顺序。”
如果启用
--confidence
,在每位顾问的提示末尾添加:
分析结束后,添加:
置信度:[1-10]
理由:[一句话——什么会让你的置信度上升或下降?]
这会生成校准后的自我评估,主席会在综合阶段进行加权。

Step 2.5: Diversity Verification (
--measure-diversity
only)

步骤2.5:多样性验证(仅启用
--measure-diversity
时)

After all 5 advisor responses are collected and before peer review, score the reasoning footprint overlap:
  1. Extract the load-bearing claims from each response (top 3-5 per advisor).
  2. Compute pairwise overlap: how many claims appear in 2+ responses with the same conclusion?
  3. Report a single diversity score:
    • High diversity (< 30% overlap) — advisors genuinely thought differently. Trust the consensus.
    • Medium diversity (30-60% overlap) — partial alignment. Note shared assumptions in the verdict.
    • Low diversity (> 60% overlap) — advisors converged on the same reasoning despite different methods. Flag as theatrical consensus — the chairman should treat this as a single advisor's opinion.
This catches "five advisors said yes" when actually one prompt-priming pattern dominated.
收集所有5位顾问的回复后,在互评前对推理足迹重叠度进行评分:
  1. 从每个回复中提取核心主张(每位顾问最多3-5个)。
  2. 计算两两重叠度:有多少主张在2个及以上回复中出现且结论相同?
  3. 给出单一多样性评分:
    • 高多样性(重叠度<30%) —— 顾问的思考方式确实不同。信任共识。
    • 中多样性(重叠度30-60%) —— 部分一致。在结论中注明共同假设。
    • 低多样性(重叠度>60%) —— 尽管方法不同,顾问仍收敛于相同推理。标记为表面共识 —— 主席应将其视为单个顾问的意见。
这能避免出现“五位顾问都同意”但实际上是单一提示引导模式主导的情况。

Step 3: Anonymous Peer Review (5 agents in parallel)

步骤3:匿名互评(5个Agent并行运行)

Collect all 5 advisor responses. Randomize the mapping — Advisor 1 should NOT always be Response A. Then launch 5 reviewer agents in parallel (use
haiku
).
Each reviewer sees all 5 anonymized responses:
You are reviewing the outputs of an LLM Council. Five advisors independently answered:

---
[framed question]
---

**Response A:** [randomized advisor response]
**Response B:** [randomized advisor response]
**Response C:** [randomized advisor response]
**Response D:** [randomized advisor response]
**Response E:** [randomized advisor response]

Answer these three questions. Be specific. Reference responses by letter.

1. Which response is strongest? Why? (one sentence)
2. Which has the biggest blind spot? What is it missing? (one sentence)
3. What did ALL five responses miss that the council should consider? (This is the most valuable question — think hard.)
4. **(V2)** Where these responses agree, is the agreement genuine — or could it be conformity to a shared framing? Flag any consensus that looks like deference rather than independent reasoning.

Keep under 150 words. Be direct. No preamble.
If
--confidence
is enabled, append a fourth question:
4. Rate your confidence in your answers above (1-10). What would change it?
收集所有5位顾问的回复。随机映射 —— 顾问1不应总是对应回复A。然后并行启动5个评审Agent(使用
haiku
)。
每位评审会看到所有5个匿名回复:
你正在评审LLM顾问团的输出。五位顾问独立给出了以下回复:

---
[构建的问题]
---

**回复A:** [随机化的顾问回复]
**回复B:** [随机化的顾问回复]
**回复C:** [随机化的顾问回复]
**回复D:** [随机化的顾问回复]
**回复E:** [随机化的顾问回复]

回答以下三个问题。请具体说明。用字母指代回复。

1. 哪个回复最有力?为什么?(一句话)
2. 哪个回复存在最大盲区?遗漏了什么?(一句话)
3. 所有五个回复都遗漏了哪些顾问团应考虑的内容?(这是最有价值的问题——认真思考。)
4. **(V2版本)** 这些回复达成一致的地方,是真实共识——还是对共同框架的顺从?标记任何看似妥协而非独立推理的共识。

控制在150词以内。直接明了。无需开场白。
如果启用
--confidence
,添加第四个问题:
4. 对你上述答案的置信度评分(1-10)。什么会改变它?

Step 3.5: Adaptive Stopping (
--adaptive
only)

步骤3.5:自适应停止(仅启用
--adaptive
时)

If
--adaptive
is enabled, the council operates over multiple rounds rather than the single advisor → review → chairman flow. After each round:
  1. Collect all advisor responses for the round (5 responses).
  2. Compute the Kolmogorov-Smirnov statistic comparing the response distributions to the prior round's responses. Use a coarse fingerprint — for each response, extract the set of distinct claims, then compute Jaccard-style distance across rounds.
  3. If the distribution shift drops below epsilon (default: 0.1) for two consecutive rounds, stop and proceed to chairman synthesis.
  4. Otherwise, run another advisor round, feeding each advisor the prior round's responses and asking them to update.
  5. Maximum 5 rounds — hard cap to prevent runaway cost.
When
--adaptive
triggers early stopping, the chairman receives the final-round responses plus a one-line note: "Council converged after N rounds (KS shift below epsilon)."
When fixed-mode is used (no
--adaptive
), proceed directly to Step 3 peer review after one advisor round.
如果启用
--adaptive
,顾问团会进行多轮运行,而非单一的顾问→评审→主席流程。每轮结束后:
  1. 收集本轮所有5位顾问的回复。
  2. 计算Kolmogorov-Smirnov统计量,比较本轮与上一轮回复的分布差异。使用粗略指纹:从每个回复中提取不同主张的集合,然后计算跨轮次的Jaccard式距离。
  3. 如果连续两轮的分布变化低于epsilon(默认:0.1),停止并进入主席综合阶段。
  4. 否则,进行下一轮顾问评审,将上一轮的回复反馈给每位顾问,要求他们更新答案。
  5. 最多5轮——硬上限,避免成本失控。
--adaptive
触发提前停止时,主席会收到最后一轮的回复,以及一行说明:“顾问团经过N轮后收敛(KS变化低于epsilon)。”
如果使用固定模式(未启用
--adaptive
),在一轮顾问评审后直接进入步骤3的互评阶段。

Step 3.7: Devil's Advocate vs the Consensus (V2 — mandatory)

步骤3.7:魔鬼代言人挑战共识(V2版本——强制环节)

This is the single highest-leverage V2 addition. The evidence is unambiguous: soft contrarian framing at the start (the Contrarian advisor) is statistically indistinguishable from baseline at inducing real disagreement — only a dedicated devil's advocate attacking the emerging answer works, and it measurably raises decision accuracy.
  1. From the advisor responses + peer review, identify the emerging consensus answer in one sentence (what is the council drifting toward recommending?). If there is genuinely no emerging answer yet, note that and skip to Step 4.
  2. Spawn one Devil's Advocate agent. Use a strong model (not
    haiku
    ) — this agent must be sharp. Its prompt:
    The council is converging on this answer:
    ---
    [emerging consensus answer, stated plainly]
    ---
    To this question:
    ---
    [framed question]
    ---
    
    Your job is to make the strongest possible case that this answer is WRONG.
    Not "here are some risks" — argue that following it is a mistake.
    - What does the consensus overlook that, if true, flips the decision?
    - Construct the concrete scenario in which this answer fails badly.
    - What evidence would the council need to see to abandon this answer — and is it actually present, or assumed?
    Steelman the opposite of the consensus. 200 words max. End with: the ONE thing that, if the council can't rebut it, should change the verdict.
  3. Feed the Devil's Advocate output to the chairman alongside everything else. This is not a 2-vs-2 advocates/skeptics structure from the start; it's one sharp attack on the converged answer, which is the configuration the research singles out.
--quick
mode: still run the Devil's Advocate (it's the cheapest high-value addition — 1 call). It is the one step
--quick
must not skip.
这是V2版本中影响力最大的新增环节。证据明确:在开始时设置温和的异议者角色(异议者顾问)在诱导真实分歧方面与基线无差异——只有针对已形成的答案发起攻击的专门魔鬼代言人才能奏效,且能显著提高决策准确性。
  1. 从顾问回复+互评中,用一句话总结正在形成的共识答案(顾问团倾向于推荐什么?)。如果确实尚未形成共识,注明并跳过至步骤4。
  2. 生成一位魔鬼代言人Agent。使用高性能模型(不要用
    haiku
    )——该Agent必须敏锐。提示如下:
    顾问团正在收敛于以下答案:
    ---
    [正在形成的共识答案,简明陈述]
    ---
    针对以下问题:
    ---
    [构建的问题]
    ---
    
    你的任务是提出最有力的论据,证明该答案是错误的。
    不是“这里有一些风险”——而是主张遵循该答案是一个错误。
    - 共识忽略了什么?如果该点成立,会彻底改变决策?
    - 构建该答案会严重失败的具体场景。
    - 顾问团需要看到什么证据才能放弃该答案——这些证据是真实存在的,还是假设的?
    强化共识的对立面。最多200词。结尾注明:如果顾问团无法反驳这一点,就应该改变结论的核心依据。
  3. 将魔鬼代言人的输出与其他所有内容一起提交给主席。这不是从一开始就设置2对2的支持者/怀疑者阵营;而是针对已收敛的答案发起一次犀利攻击,这是研究证实有效的配置。
--quick
模式:仍需运行魔鬼代言人环节(这是成本最低、价值最高的新增环节——仅1次调用)。这是
--quick
模式唯一不能跳过的步骤。

Step 4: Chairman Synthesis

步骤4:主席综合

One agent gets everything: the original question, all 5 advisor responses (de-anonymized with names and reasoning methods), all 5 peer reviews, the Devil's Advocate's attack on the consensus (V2), the diversity score (if
--measure-diversity
), and confidence ratings (if
--confidence
). Use the best available model for this (default — do not specify a lightweight model).
(V2) Mediating Assessments first. Before writing the recommendation, the chairman names 3–5 independent key attributes the decision turns on (e.g. for an architecture call: reversibility, blast radius, time-to-first-value, team familiarity) and scores each separately against the evidence — without yet forming the overall verdict. Only after the independent assessments does the chairman synthesize the holistic call. This fights coherence bias (locking onto an early answer and bending every attribute to fit it). Kahneman/Lovallo/Sibony, Mediating Assessments Protocol (2019).
(V2)
--jury
:
instead of one chairman, run 3 chairmen — ideally across different model families — each performing the full synthesis independently (including Mediating Assessments). Then a short reconciliation pass surfaces where the three judges agree (high-confidence verdict) and where they diverge (flag as a genuine close call). Use for high-stakes or close-call decisions where single-judge reliability isn't enough.
Default synthesis (majority-aware): the chairman weighs convergence across advisors and peer-review signals, and must explicitly rebut or concede the Devil's Advocate's strongest point.
Confidence-modulated synthesis (
--confidence
):
the chairman weights each advisor's contribution by their self-rated confidence × peer-rated confidence. Low-confidence majorities are flagged in the verdict; high-confidence dissent is preserved with extra weight.
Diversity-aware synthesis (
--measure-diversity
):
if the diversity score is Low, the chairman explicitly notes "the council converged on shared assumptions, not independent reasoning" in the verdict and downgrades confidence in the recommendation.
The chairman produces exactly this structure:
undefined
一个Agent会收到所有内容:原始问题、所有5位顾问的回复(还原名称和推理方法)、所有5份互评、魔鬼代言人对共识的攻击(V2版本)、多样性评分(如果启用
--measure-diversity
)以及置信度评分(如果启用
--confidence
)。为此使用最佳可用模型(默认——不要指定轻量模型)。
(V2版本) 先进行调解评估。 在撰写建议前,主席需列出决策所依赖的3–5个独立关键属性(例如,对于架构决策:可逆性、影响范围、首次价值交付时间、团队熟悉度),并根据证据分别评分——暂不形成整体结论。只有完成独立评估后,主席才能综合得出整体判断。这能避免一致性偏差(过早锁定答案,然后让所有属性都适配该答案)。卡尼曼/洛瓦洛/西博尼,调解评估协议(2019)。
(V2版本)
--jury
不用单一主席,而是运行3位主席——最好来自不同模型家族——每位独立完成综合(包括调解评估)。然后通过简短的协调步骤,找出三位法官达成一致的部分(高置信度结论)和存在分歧的部分(标记为真实难分高下的情况)。适用于高风险或难分高下的决策场景,此时单一法官的可靠性不足。
默认综合(关注多数意见): 主席会权衡顾问团的收敛情况和互评信号,必须明确反驳或认可魔鬼代言人提出的最有力观点。
置信度调节综合(
--confidence
):
主席会根据每位顾问的自评置信度×同行评分置信度对其贡献进行加权。低置信度的多数意见会在结论中标记;高置信度的不同意见会被重点保留。
多样性感知综合(
--measure-diversity
):
如果多样性评分低,主席会在结论中明确注明“顾问团收敛于共同假设,而非独立推理”,并降低对建议的置信度。
主席需生成以下结构的内容:
undefined

Council Verdict: [Topic — 5 words max]

顾问团结论:[主题——最多5词]

Where the Council Agrees

顾问团共识点

[Points where multiple advisors converged independently — these are high-confidence signals]
[多位顾问独立达成一致的要点——这些是高置信度信号]

Where the Council Clashes

顾问团分歧点

For each disagreement, classify it:
[Value Tension] — Both sides are valid; the right choice depends on priorities. [Present both sides clearly. Name the tradeoff.]
[Error Catch] — One advisor found a real flaw the others missed. [Name the flaw, who caught it, and why it matters.]
对每个分歧进行分类:
[价值冲突] —— 双方都合理;正确选择取决于优先级。 [清晰呈现双方观点。指出权衡点。]
[错误发现] —— 一位顾问发现了其他人遗漏的真实漏洞。 [指出漏洞、发现者及其重要性。]

Blind Spots Revealed

暴露的盲区

[Things only the peer review caught — the "what did ALL five miss?" answers]
[只有互评发现的内容——“所有五个回复都遗漏了什么?”的答案]

Mediating Assessments (V2)

调解评估 (V2版本)

[The 3–5 independent attributes the decision turns on, each scored separately against the evidence — stated BEFORE the recommendation so the reader sees the inputs to the judgment, not just the conclusion.]
[决策所依赖的3–5个独立属性,每个属性都根据证据单独评分——在建议前陈述,让读者看到判断的依据,而非仅结论。]

Devil's Advocate — and the Council's Answer (V2)

魔鬼代言人的挑战与顾问团的回应 (V2版本)

[The strongest case that the emerging answer is wrong (from Step 3.7), and the chairman's explicit rebuttal or concession. If the Devil's Advocate's one key point can't be rebutted, the verdict must change to reflect it.]
[步骤3.7中提出的最有力的反对共识的论据,以及主席的明确反驳或认可。如果魔鬼代言人的核心观点无法被反驳,结论必须据此调整。]

Confidence Profile (only with --confidence)

置信度概况 (仅启用--confidence时)

[Which advisors were confident vs hedging? Where did peer-rated confidence diverge from self-rated? What does the confidence pattern tell us?]
[哪些顾问置信度高,哪些有所保留?同行评分与自评置信度存在哪些差异?置信度模式说明了什么?]

Diversity Check (only with --measure-diversity)

多样性检查 (仅启用--measure-diversity时)

[Diversity score and what it means for the verdict's reliability.]
[多样性评分及其对结论可靠性的意义。]

Recommendation

建议

[Clear, actionable recommendation. Not "it depends." Not "consider both options." A real answer with reasoning. The chairman CAN disagree with the majority if the dissenter's reasoning is strongest, OR if confidence/diversity signals undermine the apparent consensus.]
[清晰、可执行的建议。不要“视情况而定”。不要“考虑两种选择”。给出带有推理依据的明确答案。如果持不同意见者的推理最有力,或置信度/多样性信号削弱了表面共识,主席可以反对多数意见。]

What You Lose

取舍说明

[If you follow this recommendation, what does the strongest dissenting voice say you're giving up? Name the specific risk or missed opportunity. This is NOT a hedge — it's informed consent.]
[如果遵循该建议,最强烈的反对声音认为你会失去什么?指出具体的风险或错失的机会。这不是妥协——而是知情同意。]

Do This First

首要行动

[Single concrete next step. Not a list. Not three options. One thing to do right now.]
How to verify: [2-3 concrete checks to confirm the recommendation was right. What should you measure? What should you look for after N days/weeks? (V2) Include the outside-view check: what's the base rate for efforts like this, and what early signal would tell you you're tracking worse than the reference class?]
undefined
[单一具体的下一步行动。不要列表。不要三个选项。现在就做一件事。]
验证方式: [2-3个具体检查,确认建议是否正确。需要衡量什么?N天/周后需要关注什么? (V2版本) 包含外部视角检查:类似项目的基准比率是什么?哪些早期信号表明你的进展比参考类别差?]
undefined

Step 5: Present Results

步骤5:呈现结果

Show the chairman's verdict directly in chat. Then provide the full transcript in a collapsible section or separate file if the user wants it.

在聊天中直接展示主席的结论。如果用户需要,可在可折叠区域或单独文件中提供完整记录。

Lite Mode (
--quick
)

轻量模式(
--quick

When
--quick
is passed, run a streamlined council:
  1. 3 advisors only: Contrarian, Executor, Outsider (the three most action-oriented perspectives)
  2. No peer review — skip Step 3 entirely
  3. Devil's Advocate (V2) still runs — Step 3.7 is the one cheap step
    --quick
    must not skip
  4. Chairman synthesis from 3 responses + the Devil's Advocate attack
  5. Same output format but faster (5 agent calls instead of 12)
  6. Compatible with
    --confidence
    and
    --measure-diversity
    but not with
    --adaptive
    (multi-round costs more than the savings).
Use for routine decisions, quick gut-checks, or when time matters more than exhaustive coverage.
当使用
--quick
时,运行简化版顾问团:
  1. 仅3位顾问: 异议者、执行者、局外人(三个最注重行动的视角)
  2. 无互评 —— 完全跳过步骤3
  3. 仍需运行魔鬼代言人(V2版本) —— 步骤3.7是
    --quick
    模式唯一不能跳过的低成本高价值步骤
  4. 主席综合 基于3位顾问的回复+魔鬼代言人的攻击
  5. 输出格式相同 但速度更快(5次Agent调用而非12次)
  6. 兼容
    --confidence
    --measure-diversity
    但不兼容
    --adaptive
    (多轮运行的成本超过节省的部分)
适用于常规决策、快速直觉检查,或时间比全面性更重要的场景。

Cost Budget

成本预算

ModeAgent CallsBest For
Full (default)12 (5 advisors + 5 reviewers + 1 devil's advocate + 1 chairman)High-stakes decisions
Quick (
--quick
)
5 (3 advisors + 1 devil's advocate + 1 chairman)Routine decisions, gut-checks
Adaptive (
--adaptive
)
7 to 27 (5 advisors × N rounds + 5 reviewers + devil's advocate + chairman, N ≤ 5 with early stop)Open questions where convergence cost matters
Confidence (
--confidence
)
12 (same as full, slightly longer prompts)Decisions where calibrated certainty matters
Measure-diversity (
--measure-diversity
)
12 (adds a synchronous overlap-scoring step, no extra agent calls)Verifying consensus is real, not theatrical
Jury (
--jury
)
+2 (3 chairmen instead of 1, ideally diverse models)Close calls / high-stakes verdict reliability
Flags compose:
--adaptive --confidence --measure-diversity
together = up to 26 calls + diversity scoring + confidence weighting.
Fast models for volume, good model for synthesis. The chairman's reasoning quality is what matters most.
模式Agent调用次数最佳适用场景
完整模式(默认)12次(5位顾问+5位评审+1位魔鬼代言人+1位主席)高风险决策
快速模式(
--quick
5次(3位顾问+1位魔鬼代言人+1位主席)常规决策、直觉检查
自适应模式(
--adaptive
7至27次(5位顾问×N轮+5位评审+魔鬼代言人+主席,N≤5且提前停止)开放性问题,关注收敛成本
置信度模式(
--confidence
12次(与完整模式相同,提示略长)需要校准确定性的决策
多样性测量模式(
--measure-diversity
12次(添加同步重叠度评分步骤,无额外Agent调用)验证共识是否真实,而非表面性的
陪审团模式(
--jury
+2次(3位主席而非1位,最好使用多样化模型)难分高下/高风险决策,需提高可靠性
标记可组合使用:
--adaptive --confidence --measure-diversity
组合使用最多需要26次调用+多样性评分+置信度加权。
大量调用使用快速模型,综合阶段使用高性能模型。主席的推理质量是最重要的。

Gotchas

注意事项

  • Always parallel spawn advisors. Sequential lets earlier responses contaminate later ones.
  • Always anonymize for peer review. Reviewers defer to "The Contrarian" or "First Principles" if they see the label. Shuffle the letters.
  • Chairman can override majority. Quality of reasoning > vote count. If the Contrarian found a real flaw that everyone else missed, the chairman should side with them.
  • Don't council trivial questions. The pre-flight check should catch these. If one right answer exists, just answer it.
  • Context is critical. Generic input = generic output. The auto-context step reads project files so advisors aren't flying blind.
  • Same-model limitation. This skill uses persona/method diversity (different reasoning methods on the same model), not model diversity (Karpathy's original used different LLMs). For the highest-stakes decisions, consider getting a second opinion from a different model family — or use
    --measure-diversity
    to verify the council didn't converge prematurely.
  • Collaborative beats adversarial for open questions. M3MADBench 2026: adversarial debate underperforms collaborative debate across all modalities. For stress-testing a known artifact (PR, draft, spec), reach for the separate
    /adversarial-review
    skill — different operation, different input.
  • Confidence calibration is only as good as the model's calibration. Low-confidence dissent should still be taken seriously when the dissenter's reasoning is concrete and the majority's is vague.
  • (V2) The Contrarian is NOT the Devil's Advocate. The Contrarian inverts at the start (soft framing — tests baseline-equivalent at inducing real disagreement). The Step 3.7 Devil's Advocate attacks the converged answer — that's the configuration the evidence singles out. Never drop Step 3.7 to save a call; it's the highest-leverage step in the skill.
  • (V2) Mediating Assessments come BEFORE the recommendation. If the chairman writes the verdict first and back-fills the attribute scores, it has recreated the coherence bias the protocol exists to prevent. Score the attributes independently, then synthesize.
  • (V2)
    --jury
    only helps if the judges differ.
    Three runs of the same model is mostly theater. Use different model families, or at minimum independent contexts; treat 3-of-3 agreement as the real signal and any split as a genuine close call.
  • 始终并行启动顾问。 顺序启动会让早期回复污染后期回复。
  • 互评始终保持匿名。 如果评审者看到“异议者”或“第一性原理思考者”的标签,会偏向这些角色。随机打乱字母标识。
  • 主席可以推翻多数意见。 推理质量>投票数。如果异议者发现了其他人都遗漏的真实漏洞,主席应支持异议者。
  • 不要为琐碎问题召集顾问团。 预检查应捕捉到这些问题。如果存在唯一正确答案,直接回答即可。
  • 上下文至关重要。 通用输入=通用输出。自动上下文步骤会读取项目文件,让顾问不会盲目工作。
  • 同模型限制。 该技能使用角色/方法多样性(同一模型采用不同推理方法),而非模型多样性(Karpathy最初的版本使用不同LLM)。对于最高风险的决策,考虑从不同模型家族获取第二意见——或使用
    --measure-diversity
    验证顾问团是否过早收敛。
  • 对于开放性问题,协作式优于对抗式。 M3MADBench 2026:对抗式辩论在所有模态下的表现都不如协作式辩论。对于已知工件(PR、草稿、规范)的压力测试,请使用单独的
    /adversarial-review
    技能——操作方式不同,输入场景不同。
  • 置信度校准的效果取决于模型的校准能力。 当持不同意见者的推理具体、而多数意见模糊时,低置信度的不同意见仍应被认真对待。
  • (V2版本) 异议者≠魔鬼代言人。 异议者在开始时采用反转法(温和框架——在诱导真实分歧方面与基线无差异)。步骤3.7的魔鬼代言人攻击已收敛的答案——这是证据证实有效的配置。永远不要为节省一次调用而跳过步骤3.7;这是技能中影响力最大的步骤。
  • (V2版本) 调解评估先于建议。 如果主席先撰写结论,再回填属性评分,就会重现该协议要避免的一致性偏差。先独立评分属性,再进行综合。
  • (V2版本)
    --jury
    只有在法官存在差异时才有用。
    同一模型运行三次大多是表面功夫。使用不同模型家族,或至少使用独立上下文;将全票通过视为真实信号,任何分歧都视为真实难分高下的情况。

Changelog

更新日志

V2.1 (2026-05-27)

V2.1(2026-05-27)

Removed the deprecated
--adversarial
mode entirely (flag, mode section, cost row, parse step). It contradicted the M3MADBench evidence, was superseded by V2's mandatory Devil's-Advocate-vs-consensus step, and caused real "isn't this the same as
/adversarial-review
?" confusion. The two skills stay cleanly separated: council-review = open decisions (with a built-in devil's advocate);
/adversarial-review
= stress-test a finished artifact. The "collaborative beats adversarial" evidence and the cross-link to
/adversarial-review
are kept.
完全移除了已弃用的
--adversarial
模式(标记、模式部分、成本行、解析步骤)。它与M3MADBench的证据相悖,被V2版本中强制的“魔鬼代言人挑战共识”步骤取代,且导致了“这和
/adversarial-review
不是一样的吗?”的真实困惑。两个技能保持清晰区分:council-review = 开放性决策(内置魔鬼代言人);
/adversarial-review
= 对已完成工件进行压力测试。保留了“协作式优于对抗式”的证据和指向
/adversarial-review
的交叉链接。

V2 (2026-05-26)

V2(2026-05-26)

Optimized via
skillforge optimize
. Outcome-research brief: the V2 outcome-research brief. Each change is tied to evidence and targets the decision outcome, not packaging:
  • Mandatory Devil's Advocate (Step 3.7) attacking the emerging consensus — the one configuration shown to reliably induce genuine disagreement and raise accuracy (OpenReview 2026; IUI 2024). The Contrarian's start-of-debate inversion is soft framing and tests baseline-equivalent.
  • Sycophancy guardrail in advisor + peer prompts; new peer-review question separating genuine agreement from conformity (Peacemaker-or-Troublemaker 2026; CONSENSAGENT).
  • Mediating Assessments in chairman synthesis — score 3–5 independent attributes before the holistic call, fighting coherence bias (Kahneman/Lovallo/Sibony 2019).
  • Outside-view / base-rate check in the Executor + "How to verify" (reference-class forecasting; Kahneman/Tversky, Flyvbjerg).
  • --jury
    — 3 diverse-model chairmen for close calls (jury-of-judges / PoLL).
Verification. Two passes. (1) Structured single-model eval on "monolith → microservices?": V1 3.2 → V2 4.6. (2) Independent A/B (2026-05-27): real separate-process agents (
claude -p
) on "seed startup → adopt Kubernetes?", advisors held constant across arms to isolate the chairman-layer change, scored by a blind judge (didn't know which verdict was which; V1 shown first to avoid order bias): V1 3.8 → V2 4.8 (Decisiveness, Insight, Calibration, Actionability, Risk-surfacing). Biggest gains: Risk-surfacing 3→5 and Calibration 3→4. The judge's stated reasons for V2's win named exactly the V2 mechanisms — base-rate/outside-view, the Devil's-Advocate rebuttal, and independent attribute scoring. The advisor-layer changes (sycophancy guardrail, outside-view prompt) were held constant in this A/B and remain validated only by reasoning.
通过
skillforge optimize
优化。成果研究摘要:V2成果研究摘要。每项变更都有证据支持,且针对决策成果,而非包装:
  • 强制魔鬼代言人环节(步骤3.7) 攻击正在形成的共识——这是唯一被证实能可靠诱导真实分歧并提高准确性的配置(OpenReview 2026;IUI 2024)。异议者在辩论开始时的反转法属于温和框架,与基线无差异。
  • 顾问+评审提示中的防谄媚约束;新增互评问题,区分真实共识与顺从(《Peacemaker-or-Troublemaker》2026;CONSENSAGENT)。
  • 主席综合中的调解评估——在整体判断前对3–5个独立属性评分,避免一致性偏差(卡尼曼/洛瓦洛/西博尼2019)。
  • 执行者和“验证方式”中的外部视角/基准比率检查(参考类别预测;卡尼曼/特沃斯基、Flyvbjerg)。
  • --jury
    ——3位多样化模型主席处理难分高下的情况(法官陪审团/PoLL模式)。
验证。 两轮验证。(1) 在“单体架构→微服务?”问题上进行结构化单模型评估:V1得分3.2 → V2得分4.6。(2) 独立A/B测试(2026-05-27): 在“初创公司→采用Kubernetes?”问题上使用真实独立进程Agent(
claude -p
),保持顾问不变以隔离主席层变更,由盲评法官评分(不知道哪个结论属于哪个版本;先展示V1以避免顺序偏差):V1得分3.8 → V2得分4.8(决策果断性、洞察力、校准度、可执行性、风险暴露)。提升最大的是:风险暴露从3分提升至5分,校准度从3分提升至4分。法官指出V2获胜的原因正是V2的机制——基准比率/外部视角、魔鬼代言人的反驳、独立属性评分。顾问层的变更(防谄媚约束、外部视角提示)在本次A/B测试中保持不变,仅通过推理验证。

Credits

致谢