用途
research-hub Multi-AI Router 是一个规划路由器，用于研究领域中的多智能体协调。它本身不执行任务，而是写出协调计划与各叶子任务的简要说明，由受支持的叶子执行。
主要能力
当前支持的叶子集合为：
- codex-delegate：实现密集或重复性工作，带有结构化的 result.json 契约。
- antigravity-delegate：范围狭窄、非诚实性关键的机械工作，带有 agy_result_*.md 契约。
已归档的 Gemini delegate 不是受支持的叶子。长上下文阅读、中日韩文起草、科学判断、治理与最终审查仍由主模型负责，除非操作者已单独验证了其他适配器。
何时调用
仅当单轮需要两个或以上委派任务、且至少一个任务操作 research-hub 产物时调用。示例：
- Codex 搭建测试脚手架，同时 Antigravity 对不相交的 fixture 子树应用已批准的元数据转换。
- 两个独立的 Codex 任务准备各自的适配器，随后由主模型进行协调。
- Antigravity 执行有边界的转录，然后 Codex 消费已验证的产物生成确定性报告。
若只有一个委派任务，直接使用其叶子技能。对于通用的、非研究类的多智能体工作，使用 agent-collab-workspace:agent-task-splitter。
不应调用的情况
- 单个 Codex 或 Antigravity 任务。
- 单次 research-hub auto --llm-cli ... 运行。
- 翻译、长篇中日韩文起草、文献判断、安全、治理或最终审查。这些保留给主模型。
- 委派任务会并行编辑重叠文件的工作。
前置条件与健康检查
在写计划之前：
- 验证每个具名叶子技能与包装器存在。
- 运行叶子文档化的预检（codex --version 或 agy --version）。
- 若计划调用 research-hub，运行 research-hub doctor。
- 将不可用的叶子记录为阻塞项。绝不静默替换为未验证的执行器。
- 若 research-hub CLI 缺失，不要发出调用它的命令。仅使用健康委派包装器的计划可以继续。
输出产物
写入 .coord/multi_ai_plan.md，若已有其他计划处于活动状态，则写入带 plan-id 后缀的同级文件。使用 references/multi_ai_plan_template.md。
每个任务声明：
- 唯一 id 与 agent（codex、antigravity 或 primary）；
- 简要说明路径；
- 依赖关系；
- 可验证的成功标准；
- 其确切的 result_artifact 路径与显式的 result_contract 判别符；
- 范围内路径与停止条件。
路由器写出每个非内联简要说明。叶子绝不编辑计划，也绝不提交或推送。
协调
- 启动任务前等待依赖完成。
- 读取确切声明的 result_artifact：
- Codex：包装器 .result.json 加上 diff 与测试。
- Antigravity：有边界的 agy_result_*.md 加上独立验证的文件与哨兵检查。
- 将实际更改的文件与证据同任务及轮次标准比对。
- 拒绝范围漂移或不受支持的完成声明。
- 追加新的修复任务，而不是修改已完成任务的历史。
- 主模型执行判断、最终审查以及任何提交/推送。
单 LLM 的 research-hub 路由
--llm-cli 选项是 research-hub 运行时特性，不是路由器决策：
research-hub auto "TOPIC" --with-crystals --llm-cli codex python -c "from research_hub.auto import detect_llm_cli; print(detect_llm_cli())"
仅使用当前检测返回且与所请求任务兼容的 CLI。不要仅因旧命令仍出现在历史中而保留已退役的模型路由。
护栏
- 每个路由器计划至少两个委派任务。
- 不伪造引用、元数据、工具输出或完成状态。
- Antigravity 仅接收有边界的机械工作；它绝不审查或做出科学/治理决策。
- 无重叠的写入所有权。
- 不要用不同的 plan_id 覆盖活动计划。
- 未经工作流的人工门控，不要变更远程库、覆盖 vault 笔记、发布、合并或删除。