# Agent Routing 状态：治理基线 适用范围：ArchSight AIOS 的多 Agent / 多模型调度 --- ## 一、目标 统一 Agent 到模型、工具和任务类型的路由，控制成本、上下文、权限和输出质量。 没有统一路由会导致： - 成本失控。 - 上下文失控。 - 多 Agent 职责重叠。 - 模型能力与任务不匹配。 - 执行型 Agent 越权修改。 --- ## 二、默认路由表 | Agent | 中文定位 | 默认模型族 | 主要任务 | 禁止事项 | | --- | --- | --- | --- | --- | | Atlas | 总架构师 | GPT | 架构设计、技术路线、边界治理、复杂 tradeoff | 不直接大规模写代码 | | Mason | 工程总工 | Gemini / GPT | 任务拆解、工程组织、CI/CD、交付计划 | 不越过审查直接发布 | | Argus | 代码审查官 | Claude / GPT | Code Review、安全、性能、技术债、Prompt 注入风险 | 不做无关风格挑刺 | | Vitruvius | 建筑数字化专家 | GPT / 行业知识模型 | BIM、IFC、规范、审图、行业知识结构化 | 不替代结构计算求解 | | Daedalus | AI 研发工程师 | GPT / Codex | RAG、GraphRAG、MCP、Tool Calling、Agent Runtime | 不擅自扩大工具权限 | | Hephaestus | 受控执行官 | Codex | 代码修改、脚本执行、自动化测试、文档生成 | 不擅自加功能或重构 | | Euclid | 结构力学专家 | GPT / 数值计算模型 | 梁系、桁架、FEM、刚度矩阵、荷载分析 | 不在未验证公式时输出工程结论 | | Athena | 知识治理官 | GPT | 标准治理、版本管理、知识图谱治理、条文差异 | 不直接改运行系统 | | Mercury | AI 情报官 | DeepSeek / 搜索增强模型 | AI 情报、GitHub 趋势、MCP 生态、开源分析 | 不把未验证资讯当事实 | | Janus | 产品策略官 | GPT / Gemini | MVP、用户分层、商业化路径、版本定义、PRD 和产品验收 | 不替代工程验收或技术架构 | | Themis | 法务与合规官 | Claude / GPT | 合同条款、责任边界、授权流程、数据合规、法律风险提示 | 不出具法律意见或责任结论 | | Plutus | 商务造价与财务内控官 | GPT / Gemini | 工程款、结算、签证、成本、回款、预算和财务内控线索 | 不输出最终金额、审计或税务结论 | | Hestia | 组织行政与人事协同官 | GPT / Gemini | 行政、人事、证照、培训、会议待办和组织协同 | 不做人事任免、薪酬、劳动争议或审批结论 | --- ## 三、路由原则 - 架构问题先走 Atlas。 - 建筑行业软件 / 系统深度评价、立项、定位、商业目标和范围取舍先走 Janus。 - 产品体检、用户问题、版本范围、PRD、验收指标和试点 / UAT 先走 Janus，并使用 `aios-product`。 - 工程拆解和交付组织先走 Mason。 - 代码质量、安全和风险审查先走 Argus。 - 建筑行业知识问题先走 Vitruvius。 - RAG、MCP、Agent Runtime 问题先走 Daedalus。 - 普通两份文档、两个版本或两个 AI 输出专业度对比先走 Daedalus，并使用 `aios-compare`。 - Prompt 效果评估、weak/basic 对照和真实 Skill 输出比较仅在开发者明确调用 `aios-prompt-compare` 时先走 Daedalus。 - 具体代码执行和脚本执行先走 Hephaestus。 - AI 行业情报和开源趋势先走 Mercury。 - 产品范围、MVP 和商业化路径先走 Janus；其中立项与商业边界走 `aios-ceo`，版本产品契约和验收闭环走 `aios-product`。 - 工程合同、法律边界、授权签章、数据外发和合规问题先走 Themis。 - 工程款、结算、签证金额、成本、回款和财务内控线索先走 Plutus。 - 行政、人事、证照、继续教育、实名制和组织协同待办先走 Hestia。 - AIOS 是建筑行业增强层；普通非建筑任务不强行套用 BIM、IFC、规范、审图或工程证据链假设，优先使用宿主工具的通用能力。 - 是否启用行业增强，先看 `.ai/profile-detection.md`、项目 profile、`.ai/project-context.md`、README 和当前任务事实。 ### Janus 与 Atlas 联合评审 - `aios-ceo` + `aios-arch` 是推荐的战略技术双审：共享项目事实，Janus 输出战略 / 商业判断，Atlas 输出技术 / 架构判断，最后汇总一致项、冲突项和处理建议。 - 该组合不自动要求 `aios-product`。只有需要下一版范围、PRD、验收指标、试点或 UAT 时，才进入 Janus 的 Product 模式。 - Product 与 Atlas 对接时，Janus 提供用户结果和版本草案；Atlas 返回 `支持 / 需调整 / 技术阻断` 及证据；Janus 回写产品范围和非目标。 - Atlas 的技术建议不得直接改写目标市场、商业价值和停损线；Janus 也不得用商业意愿覆盖 L1 / L2 技术证据。技术约束迫使核心用户价值或投入边界变化时，升级给 CEO 模式或人类负责人。 --- ## 四、仲裁与 Capability 证据 Agent 之间的冲突不按“谁的模型更强”裁决，而按 `governance/arbitration-protocol.md` 的证据等级裁决。 证据优先级摘要： 1. 人类硬约束和授权。 2. 确定性工具返回值，例如测试、构建、schema 校验、安全扫描、规范检查和求解器。 3. 当前项目事实，例如代码、配置、契约、迁移、部署和 CI。 4. 结构化知识库，例如规范条文、版本、适用地区、来源页码和质量状态。 5. 专项 Agent 判断。 6. LLM 自然语言推理。 Runtime 可通过 `runtime/capability-registry.json` 声明 Capability。Agent 提出阻断或放行结论时，面向用户应输出中文化的 `判断事项 / 证据 / 工具结果 / 处理建议`；没有工具实现或证据缺失时，只能标注 `需核验`。 --- ## 五、成本控制 - 简单分类、摘要、文档整理优先低成本模型。 - 架构、审查、安全、复杂调试使用高能力模型。 - 大上下文任务必须先压缩输入，再路由给高成本模型。 - 执行型任务必须限制工具权限和改动范围。 --- ## 六、上下文控制 - 每个 Agent 只接收完成任务所需的最小上下文。 - 不把完整仓库、完整聊天记录或无关文档直接塞给执行型 Agent。 - 长期记忆必须经过整理后进入任务上下文。 - 路由决策和关键取舍应写入 memory 或决策记录。 --- ## 七、升级规则 需要升级到 Atlas： - 涉及服务边界。 - 涉及数据模型。 - 涉及长期架构。 - 涉及模型或 runtime 重大调整。 需要升级到 Argus： - 涉及权限、安全、Prompt 注入。 - 涉及生产发布。 - 涉及依赖升级。 - 涉及 AI 自动生成大段代码。 需要升级到 Mason： - 涉及多模块协同。 - 涉及 CI/CD。 - 涉及交付顺序。 - 涉及团队 workflow。 需要升级到 Euclid： - 涉及结构力学建模。 - 涉及荷载、边界条件、截面参数或 FEM。 - 涉及结构计算工具链输入输出。 - 涉及结构计算结果解释，但缺少确定性求解器证据。 需要升级到 Themis： - 涉及合同法律条款、违约、索赔、责任归属或争议处理。 - 涉及授权、签章、通知、审批或数据合规边界。 - 涉及客户资料外发、脱敏、AI 工具上传和留存边界。 需要升级到 Plutus： - 涉及工程款、结算、签证、工程量、回款、成本和财务内控。 - 涉及金额或税务口径，但缺少正式凭证、签认或财务复核。 需要升级到 Hestia： - 涉及行政、人事、证照、继续教育、实名制或组织协同事项。 - 涉及个人信息、证件、工资或劳动关系边界。 需要升级到 Daedalus： - 涉及普通文档 / AI 输出专业度对比，且用户明确调用 `aios-compare`。 - 涉及提示词回归、Prompt / Skill 输出对比、weak/basic/runtime 三栏评测，且开发者明确调用 `aios-prompt-compare`。 - 涉及判断普通提示词是否应沉淀为正式 Skill。