fable-council

Fable Council

在确定架构方案前，召集 AI 编码 Agent 组成评审团。提出方案 → 听取每个已安装 Agent CLI 的独立评估 → 修订，并在有限轮次的审议中重复这一过程。

目的

确保复杂方案经过多 Agent 审议并达成跨模型共识。利用互补模型（Claude、Codex、Cursor、Gemini、Grok、OpenCode）发现盲点、质疑有缺陷的假设，并制定稳健的工程方案。

适用场景

• 规划高风险架构变更、大规模重构或迁移时。
• 用户要求召集评审团或征求其他意见时（“请评审团讨论”“咨询其他 Agent”）。
• 在多种相互竞争的实施策略之间进行讨论时。

不适用场景

• 范围明确的单文件 Bug 修复或常规实施任务（使用 fable-execute 或 fable-tdd）。
• 本地系统未安装其他 Agent CLI 时（改为单独使用 fable-plan）。
• 实施完成后的差异验证或代码审查（使用 fable-review 或 fable-judge）。

输入

• draft_plan：主 Agent 的初始架构提案。
• member_clis：主机上已检测到或由用户指定的 Agent CLI 二进制文件列表。
• rounds_count：要求的审议轮数（默认值：1）。

预期输出

• counciled_plan：经多 Agent 评议和完善后的最终综合方案。
• deliberation_transcript：结构化的对话记录，包含成员评议、采纳的修改和驳回的论点。

流程

1. 解析请求：提取核心任务、要求的轮数（X），并识别主机上的主运行时（SELF）。
2. 检测成员：探测 PATH 中可用的 CLI（claude、codex、cursor-agent、gemini、grok、opencode），并排除 SELF。
3. 初始化会话：创建 ~/.council/<timestamp>-<slug>，并将原始任务保存至 task.md，将初始方案保存至 plan-v1.md。
4. 审议循环（1..X）：
   • 为每个成员生成带有严格只读执行标志的提示词。
   • 在后台进程中并发调用所有成员，超时时间约为 300 秒。
   • 收集并解析成员回复。
   • 修订方案：采纳有效评议；对于有缺陷的建议，明确说明技术理由并予以驳回。
   • 生成 plan-v(R+1).md 和 changes-v(R+1).md。
5. 整理最终答复：先呈现审议对话，再呈现最终定稿的共识方案。

决策规则

• 评审团运行期间，主 Agent 绝不实施任何变更；仅进行规划和审议。
• 评审团成员以只读模式调用（--mode plan、-s read-only、--skip-trust）。
• 所有成员建议均按技术价值评估，而非依据模型权威性判断。
• 若有具体的技术依据，可以保留原有立场。

工具策略

• 使用非交互标志并行执行成员 CLI 二进制文件。
• 严格限制超时时间（例如，通过 Perl alarm 或 macOS 上的进程管理器实现）。
• 向无头模型（例如 Grok）传递系统提示词覆盖项，以避免其因未经授权的工具调用而停滞。

证据要求

• 将审议会话产物保存在 ~/.council/ 下。
• 提供原文引述，并说明采纳或驳回建议的理由。

故障处理

• 如果成员 CLI 超时或出错，记录超时情况，并继续审议，不要因此阻塞当前轮次。
• 如果机器上不存在辅助 Agent CLI，明确声明这是一个未经评审团审议的单独方案。

完成标准

• 完成全部 X 轮审议，且未发生死锁。
• 清晰呈现审议记录和最终综合方案。
• 交付内容已准备好供人工签署确认，之后方可开始执行。