persona-router

Persona Router

从已安装的 N 个 persona skill 里，挑出最懂这个问题的 1-3 个。

Announce at start: "I'm using the persona-router skill to scan installed persona manifests and recommend the best matches for your question."

Overview

当你蒸馏了十几个 persona skill（同事、导师、公众人物、领域专家……），每次面对一个新问题，你都要在脑子里过一遍"这个问题谁最懂"。Router 把这步自动化：读所有 persona 的 manifest.json，按问题语义打分，给出排序推荐，你挑一个或几个触发。

Router 不回答问题，只负责把合适的 persona 推到你面前。

When Router Adds Value (Be Honest)

PRD 明确指出：

"router 和 debate 在 persona skill 数量 <10 之前没价值。" — docs/.../prd.md §8 Q6

在下面这些情况，不要用 router：

场景	更好的做法
只装了 1-3 个 persona	直接叫名字
问题明显属于某个 persona 的主场	直接触发那个 persona
你想要的是"多方辩论"而非"挑人"	直接用 persona-debate
persona 总数 <10	手动挑更快，router 开销反而亏

Router 的回报曲线在 persona 数 >= 10 后才变陡。

The Single Input Contract

Router 只读一种输入：符合 contracts/manifest.schema.json 的 manifest.json 文件。

这是 router 唯一认识的格式。任何 persona skill 如果没有合规的 manifest，router 会直接跳过（并在报告中列出）。Contract 路径（相对仓库根）：

plugins/persona-distill/contracts/manifest.schema.json

Schema 里 router 实际用到的字段：

• schema_type — 9 种 persona schema 之一
• identity.name / identity.display_name / identity.description / identity.domains / identity.subject_type — 匹配语义
• components_used — 19 个共享组件的激活集合（v0.3.0 起含 execution-profile）
• triggers — 触发短语（用来做二次验证）
• density_score / validation_score — 质量信号
• unvalidated — 未验证警告

不在 schema 里的字段 router 一律忽略。

Four-Step Workflow

┌─────────────────────────────────────────────────────────────┐
│                    PERSONA ROUTER FLOW                      │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Step 1: 接收用户问题                                        │
│           ↓                                                 │
│  Step 2: 扫描 installed persona skills                      │
│           └─ 读所有 manifest.json                           │
│              （符合 contracts/manifest.schema.json）         │
│           ↓                                                 │
│  Step 3: 在匹配维度上打分                                    │
│           ├─ schema_type relevance                          │
│           ├─ identity.domains keyword overlap               │
│           ├─ components_used coverage                       │
│           └─ density_score / validation_score 调权           │
│           ↓                                                 │
│  Step 4: 输出 1-3 条推荐（rationale 可见）                   │
│           └─ 按 templates/recommendation-template.md 格式   │
│                                                             │
└─────────────────────────────────────────────────────────────┘