SuperAPI AI 工具集

llm-council-decision-framework

智能体与模型

查看项目

更新于 10-16 11:36

技能介绍

用途

LLM Council 决策框架用于辅助决策:它把一个问题转化为五个独立专家视角,随后进行同行评审,并综合出最终建议。根据资料,它不是只给一个 AI 意见,而是提供多样化的观点,用来挑战假设、揭示盲点,并在你做出承诺前暴露冲突。该框架基于 Andrej Karpathy 的 LLM Council 方法论,最初由 Ole Lehmann 构建,属于 Claude Code Skills 集合中的一个技能。

主要能力

该 council 分三个阶段运作:

  1. 独立分析:5 位具有不同认知风格的顾问分析你的问题。
  2. 同行评审:每位顾问评审其他人的建议。
  3. 综合:主席给出最终裁决,突出共识、冲突与行动项。

五种顾问原型包括:

  1. The Analyst:数据驱动、关注风险、要求证据。
  2. The Visionary:大局思维、关注机会、探索上行空间。
  3. The Skeptic:挑战假设、找漏洞、扮演魔鬼代言人。
  4. The Pragmatist:关注落地执行,追问“我们真的能做到吗?”
  5. The Contrarian:采取相反立场,揭示被忽视的备选方案。

结果解读分为几种情况:当 5 位顾问一致同意方向时,置信度高(这种情况罕见);当顾问意见分裂但出现模式时,属于有产出的冲突,分裂反映了真实的权衡,主席可能建议混合方案;如果 council 揭示了过多变量,说明问题需要简化。

使用方式

该技能设计用于 Claude Code 和 Claude Cowork 环境。

安装方式一:直接安装。把 SKILL.md 文件放入 Claude 技能目录。例如对 Claude Code:

mkdir -p ~/.config/claude/skills
curl -o ~/.config/claude/skills/llm-council.md \
  https://raw.githubusercontent.com/aiwithremy/claude-skills-llm-council/main/SKILL.md

对 Cursor:

mkdir -p ~/.cursor/skills
curl -o ~/.cursor/skills/llm-council.md \
  https://raw.githubusercontent.com/aiwithremy/claude-skills-llm-council/main/SKILL.md

安装方式二:AI 辅助安装。在新对话中输入:

Please install this Claude skill: 
https://github.com/aiwithremy/claude-skills-llm-council

Set it up so I can use it immediately.

使用模式:通过自然语言触发,例如:

council this: Should I launch a $97 workshop or a $497 course?
run the council on: Which of these 3 positioning angles is strongest?
[paste your options]
pressure-test this:
I'm thinking of pivoting from SaaS to info products. Here's my reasoning...

也可使用上下文丰富的提问,例如给出业务背景、选项与顾虑后问“What should I do?”;还可用于决策记录,把 council 输出保存下来。

配置选项包括:自定义顾问角色(如技术架构师、安全专家、DevOps 工程师、产品经理、工程经理)、加权视角(如把 Pragmatist 的意见加权 2 倍)、限时决策(添加紧迫性约束,如“emergency council - need decision by EOD”)。

高级模式包括:迭代细化(多轮 council)、预演失败分析(对已做决定做压力测试)、比较模式(对多个选项并行运行 council 并排名)。

适用场景

资料给出的良好用例包括:

  • 高风险策略决策(产品方向、定价、定位)
  • 评估权衡不明显的多个选项
  • 重大承诺前对假设进行压力测试
  • 为已拟定的计划获取外部视角
  • 需要看到盲点的场景

不良用例包括:

  • 有唯一正确答案的事实性问题
  • 创意生成任务(写作、编码)
  • 简单处理任务(总结、格式化)
  • 情感上已经下决心的决策

该框架也可集成到工作流中:在文档中记录决策日志、在 Pull Request 中辅助技术选择、在产品规格中记录决策框架与理由。

限制

资料中提到的常见问题:顾问可能过于轻易地一致(问题可能太明显,需补充约束与权衡背景)、输出可能过长(可要求仅给执行摘要或仅给关键冲突与建议)、顾问可能不理解你的领域(需提前提供更多背景、使用领域特定的自定义角色、加入相关指标/基准)、得到好答案后想深入可让特定顾问辩论或展开分歧点。

故障排查方面:技能未触发时,检查技能文件是否在正确目录、重启 Claude Code/Cowork、使用明确触发语如“run the council on:”;输出格式异常时,重申“Use the full LLM Council format with 5 advisors”并检查是否使用受支持的 Claude 模型;性能问题上,council 查询消耗 token 较多,可要求“Quick council with 3 advisors”或“Skip peer review, just give me 5 perspectives”。

最佳实践建议:问题要具体、展示你已经考虑过的内容、说明决策的重要性、接受顾问之间的冲突(分歧是有价值的数据)、果断行动(council 提供信息,你做决定)、记录保存 council 输出。

资源

  • 原始仓库:https://github.com/aiwithremy/claude-skills-llm-council
  • 方法论:https://github.com/karpathy/llm-council
  • 创建者:https://x.com/itsolelehmann