pi-multi-research 1.0.0

package/README.md

@@ -0,0 +1,70 @@
+# multi-research
+
+多模型对照调研：派 **多个采用不同模型**的内置 `researcher` **并行调研同一个问题**，再由 `oracle` 交叉检验、合并成一份带对照、冲突标注、来源裁决与模型质量观察的中文分析报告。
+
+## 它解决什么问题
+
+单个模型调研有盲区与偏差。让多个不同厂商的模型独立回答同一问题，再交第三方评审合并，能得到：
+
+- 事实交叉验证（多模型一致的结论更可信）
+- 冲突显性化（分歧点及其双方依据一目了然）
+- 来源权威裁决（冲突时按来源可信度下结论）
+- 模型质量对比（顺带观察哪个模型调研更可靠）
+
+## 设计要点
+
+**零自定义 agent**：模型通过调度时的 `model:` 参数传给内置 `researcher`（pi-subagents 自带）。唯一的配置点是 SKILL.md 里的**模型名单**——换/加模型只改那一处，没有 agents 文件、没有安装同步问题。
+
+## 安装
+
+本技能依赖 `pi-subagents`（提供内置 `researcher` / `oracle` 和 `workflowScript` 并行调度）：
+
+```bash
+# 前置依赖
+pi install npm:pi-subagents
+
+# 安装本技能
+pi install npm:pi-multi-research
+
+# 项目级安装
+pi install -l npm:pi-multi-research
+
+# 本地开发：在 pi-packages 仓库根目录执行
+pi install ./skills/multi-research
+```
+
+不再推荐从 GitHub 根仓库安装合集或复制目录；GitHub monorepo 仅用于源码和文档维护。本地路径安装适合开发和测试未发布版本。
+
+## 使用
+
+对任意 agent 说一句即可，例如：
+
+> 用 multi-research 调研：武汉今日天气
+
+指定部分模型（简称或完整 ID）：
+
+> 用 glm、qwen 调研：<问题>
+
+指定主题标签与落盘位置：
+
+> 用 multi-research 调研「<问题>」，主题标签 xxx，落盘到 docs/research/
+
+产出：`docs/research/YYYY-MM-DD-<topic>/` 下每个模型一份简报 + 1 份 oracle 合并分析（`00-analysis.md`）。
+
+## 目录结构
+
+```text
+multi-research/
+├── package.json    # pi-multi-research：独立 npm 包 manifest
+├── SKILL.md        # 主流程：解析模型名单 → 并行调研 → oracle 评审 → 合并落盘
+└── README.md       # 本文件
+```
+
+## 换模型 / 加模型
+
+改 SKILL.md 顶部的「模型名单」（或简写映射）列表即可，流程与安装都不动。模型必须存在于 pi 的模型注册表。
+
+## 前提与成本
+
+- 默认名单走 B.AI / opencode 免费通道；`oracle` 使用当前 pi-subagents 配置的模型，具体费用取决于本地配置。
+- GLM 模型只接受 low/high/max 思考级别，名单里必须写 `bai/glm-5.3-flash:high`（medium 会 400）。

package/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: multi-research
+description: 多模型对照调研——派多个采用不同模型的内置 researcher 并行调研同一问题，再由 oracle 交叉检验、合并成一份带对照与裁决的中文分析报告
+---
+
+对用户给出的同一个问题，并行派出若干**不同模型**的 `researcher`（pi-subagents 内置）独立调研，最后由 `oracle`（内置）交叉检验并合并产出**一份**分析报告：逐字段对照、冲突标注、来源裁决、模型质量观察。
+
+本 skill **不依赖任何自定义 agent**：模型通过调度时的 `model:` 参数传入。唯一的"配置点"是下面的默认模型名单——**增删改模型只动这一个列表**。
+
+## 模型名单（唯一的配置点）
+
+默认（一次并行调研 = 派一个 researcher × 每个模型）：
+
+- `bai/glm-5.3-flash:high` —— 智谱 GLM（注意必须带 `:high`：该模型只接受 low/high/max 思考级别，拒绝默认的 medium）
+- `bai/qwen3.8-flash` —— 阿里 Qwen
+- `opencode-zen-free/mimo-v2.5-free` —— 小米 MiMo
+
+简写映射（触发消息里说简称用）：
+
+| 简写 | 完整模型 ID |
+|---|---|
+| `glm` | `bai/glm-5.3-flash:high` |
+| `qwen` | `bai/qwen3.8-flash` |
+| `mimo` | `opencode-zen-free/mimo-v2.5-free` |
+
+## 触发解析
+
+用户消息两种形式：
+
+- **不指名模型**："用 multi-research 调研 <问题>" → 默认名单全部
+- **指名模型**："用 glm、qwen 调研 <问题>" → 只派简写映射对应的模型（未匹配的简写 → 提示用户，仍跑其余）
+
+可选参数（原样沿用）：`主题标签 <topic>`（目录命名，缺省用问题前几个词做 slug）、落盘根（缺省 `docs/research/`）。
+
+## 前置
+
+`researcher` 与 `oracle` 均为 pi-subagents 内置 agent，**无需安装任何自定义 agent 文件**。若想加失败兜底，在 `settings.json` 的 `subagents.agentOverrides.researcher.fallbackModels` 配置即可。
+
+## 执行步骤
+
+### 1. 准备输出目录
+
+日期取当天 UTC+8：`docs/research/YYYY-MM-DD-<topic-slug>/`，创建目录。
+
+### 2. 并行调研（每模型一个 researcher，workflowScript 一次跑完）
+
+```js
+subagent({ workflowScript: `
+  const topic = "<topic-slug>";
+  const q = "<问题>";
+  const dir = "docs/research/YYYY-MM-DD-${topic}";
+  const models = ["<模型ID1>", "<模型ID2>", ...]; // 来自模型名单/用户指名
+  const arms = models.map((m, i) => ({
+    key: "arm" + i,
+    agent: "researcher",
+    model: m,
+    task: "问题：" + q + "\\n输出：用 write 把中文调研简报到 " + dir + "/arm" + i + ".md（若 write 失败，直接在回复中返回完整简报文本）",
+    output: dir + "/arm" + i + ".md"
+  }));
+  const results = await runs.all(arms);
+  return results;
+`})
+```
+
+产出文件建议原名：`glm.md` / `qwen.md` / `mimo.md`（按实际模型名，便于阅读）。
+
+要点：
+- `model:` 用「完整 provider/id」，可带思考后缀（如 `bai/glm-5.3-flash:high`），后缀优先于 agent 默认 thinking。
+- 每个 child 的 `output` 用绝对路径或项目根相对路径，互不覆盖。
+- 任一支失败：记录原因，其余支照常；最终分析标注缺失支。
+
+### 3. oracle 交叉检验 + 合并分析
+
+3 份简报齐后派 `oracle`（内置，`thinking: high`，无 web 工具，只读文件——保证它不重新检索）：
+
+```js
+subagent({ agent: "oracle", context: "fresh", output: false,
+  task: `读取并交叉检验以下关于"<问题>"的中文调研简报：
+  - <abs>/glm.md
+  - <abs>/qwen.md
+  - <abs>/mimo.md
+  只基于文件内容（不要联网），产出一份中文分析，包含：
+  1. 逐字段对照表（同一事实维度下各方的数值/说法/来源并排）
+  2. 一致性结论：一致的点；冲突的点（各自依据与来源）
+  3. 来源可信度裁决：对冲突点按来源权威性给出结论与理由
+  4. 合并后的最终回答（Summary 级直接结论）
+  5. 模型质量观察：哪份简报更全面/更准确/引用更可靠，各一句话
+  6. 缺失支的影响（若有）` })
+```
+
+oracle 的 tools 不含 `write`，分析在其返回文本里；由父会话把返回内容落盘为 `<dir>/00-analysis.md`（`output: false` 避免它写别处）。
+
+### 4. 汇报
+
+向用户给出：最终合并回答（几句话说清结论）→ 关键分歧点一句话总结 → 报告路径。
+
+## 输出约定
+
+```
+docs/research/YYYY-MM-DD-<topic-slug>/
+├── <模型1>.md        # 各模型独立简报（带来源与检索时间）
+├── <模型2>.md
+├── ...
+└── 00-analysis.md    # oracle 交叉检验 + 合并分析
+```
+
+全部中文；简报必须带来源 URL 与检索时间。
+
+## 灵活性
+
+- **换模型/加模型**：改「模型名单」列表（或简写映射）一处即可，无需改流程、无需装 agents。
+- **临时指定**：触发消息里点名模型简称或完整 ID。
+- **失败兜底**：`settings.json` → `agentOverrides.researcher.fallbackModels`。

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "pi-multi-research",
+  "version": "1.0.0",
+  "description": "Pi skill: multi-model cross-checked research — dispatch several researchers on different models in parallel for the same question, then an oracle cross-checks and merges them into one Chinese analysis report with comparison, conflicts, source adjudication, and model-quality observations.",
+  "license": "MIT",
+  "keywords": ["pi-package", "pi-skill", "research", "multi-model", "oracle", "cross-check"],
+  "files": ["SKILL.md", "README.md"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/the-ultra-nexus/pi-packages.git"
+  },
+  "pi": {
+    "skills": ["./"]
+  },
+  "peerDependencies": {
+    "pi-subagents": "*"
+  }
+}