persona-debate

persona-debate

一个 persona = 一个视角。debate = 真正的多视角对话。

大多数 persona skill 被单独调用时只能给出"我（某 persona）会这样想"的独白。但真实世界里的好决策，往往是几位不同背景的人互相挑战之后才浮现的。persona-debate 编排 2-5 个已安装 persona skill 围绕同一问题发言，由一个 moderator agent 充当主席协调轮次，最后汇总分歧、收敛点、一句话"如果必须选"的判语。

灵感来源：诸子.skill（我们无法访问原件，在此基础上重新推导模式）。

Announce at start: "I'm using the persona-debate skill to orchestrate a multi-persona debate with a moderator agent coordinating turns."

Three Modes

辩论的组织方式有三种（细节见 references/modes.md）：

模式	一句话说明	适合
Round-robin	N 位参与者按固定顺序发言，共 3 轮。每轮每人一次。	默认。视角均衡，节奏清晰。
Position-based	开辩前给每位参与者分派立场（支持 / 反对 / 中立），逼出对立。	决策类问题（"要不要做 X？"），需要对立视角。
Free-form	谁相关谁说话，moderator agent 在最后做综合。	探索性问题，参与者专长差异大；但容易跑题，moderator 强制 ≤3 轮。

用户未指定时默认 Round-robin。

How Participants Are Chosen

两条路径：

1. 用户显式列出：例如 "debate with Jobs, Munger, Naval"。本 skill 通过名字匹配已安装 persona skill 的 manifest.json.identity.name / display_name。
2. 由 persona-router 推荐后转入：用户先跑 persona-router 得到一组推荐 persona，再把它们作为辩论参与者传给本 skill。这条路径不需要本 skill 实现路由逻辑——直接接受上游结果。

约束：参与者数量 2 ≤ N ≤ 5。少于 2 没有"辩"，多于 5 难以保持连贯。

Invocation via Moderator Agent

为什么要 moderator：Claude Code 的 skill 之间不应互相直接调用（会绕过主 agent 的上下文管理，也不符合本仓库其他 skill 的做法）。我们用一个 moderator agent 作为"主席"——由主 agent spawn 一次，moderator 再依次"向每位 persona 提问"，把回应收集成一个 transcript。

Moderator agent 的定义在 agents/moderator.md。它会：

• 读取每个参与 persona 的 manifest.json（字段定义见 contracts/manifest.schema.json），从 schema_type 推断可能的论证风格（e.g. mentor 倾向给建议，public-domain 倾向给框架，executor 倾向给操作步骤），从 identity.description 理解人物定位。
• 不重新实现 persona——它扮演的是主席，不是 persona 本人。轮到某 persona 发言时，moderator 模拟该 persona 的发言（基于其 SKILL.md 和 knowledge/ 能暴露出来的信号），质量天花板由 persona skill 自身决定。
• 执行所选模式的轮次控制（详见 references/modes.md）。
• 在结束时产出综合段落。

Turn Structure

每轮的细节（开场白、提问模板、收敛条件、如何把前一位发言者的观点传给下一位）集中在 references/modes.md，避免本文件膨胀。核心结构：

Moderator 开场 → 亮出问题 → [Mode 决定的轮次序列] → Moderator 综合

Output Format

单一 transcript 文件：