@archsight/aios 1.0.0 → 1.0.1

package/runtime/agent-routing.md

@@ -1,92 +1,94 @@
-# 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、SaaS、用户分层、商业化路径 | 不替代工程验收 |
-
----
-
-## 三、路由原则
-
-- 架构问题先走 Atlas。
-- 立项、定位、商业目标和范围取舍先走 Janus。
-- 工程拆解和交付组织先走 Mason。
-- 代码质量、安全和风险审查先走 Argus。
-- 建筑行业知识问题先走 Vitruvius。
-- RAG、MCP、Agent Runtime 问题先走 Daedalus。
-- 具体代码执行和脚本执行先走 Hephaestus。
-- AI 行业情报和开源趋势先走 Mercury。
-- 产品范围、MVP 和商业化路径先走 Janus。
-
----
-
-## 四、成本控制
-
-- 简单分类、摘要、文档整理优先低成本模型。
-- 架构、审查、安全、复杂调试使用高能力模型。
-- 大上下文任务必须先压缩输入，再路由给高成本模型。
-- 执行型任务必须限制工具权限和改动范围。
-
----
-
-## 五、上下文控制
-
-- 每个 Agent 只接收完成任务所需的最小上下文。
-- 不把完整仓库、完整聊天记录或无关文档直接塞给执行型 Agent。
-- 长期记忆必须经过整理后进入任务上下文。
-- 路由决策和关键取舍应写入 memory 或决策记录。
-
----
-
-## 六、升级规则
-
-需要升级到 Atlas：
-
-- 涉及服务边界。
-- 涉及数据模型。
-- 涉及长期架构。
-- 涉及模型或 runtime 重大调整。
-
-需要升级到 Argus：
-
-- 涉及权限、安全、Prompt 注入。
-- 涉及生产发布。
-- 涉及依赖升级。
-- 涉及 AI 自动生成大段代码。
-
-需要升级到 Mason：
-
-- 涉及多模块协同。
-- 涉及 CI/CD。
-- 涉及交付顺序。
-- 涉及团队 workflow。
+# 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、SaaS、用户分层、商业化路径 | 不替代工程验收 |
+
+---
+
+## 三、路由原则
+
+- 架构问题先走 Atlas。
+- 建筑行业软件 / 系统深度评价、立项、定位、商业目标和范围取舍先走 Janus。
+- 工程拆解和交付组织先走 Mason。
+- 代码质量、安全和风险审查先走 Argus。
+- 建筑行业知识问题先走 Vitruvius。
+- RAG、MCP、Agent Runtime 问题先走 Daedalus。
+- 具体代码执行和脚本执行先走 Hephaestus。
+- AI 行业情报和开源趋势先走 Mercury。
+- 产品范围、MVP 和商业化路径先走 Janus。
+- AIOS 是建筑行业增强层；普通非建筑任务不强行套用 BIM、IFC、规范、审图或工程证据链假设，优先使用宿主工具的通用能力。
+- 是否启用行业增强，先看项目 profile、`.ai/project-context.md`、README 和当前任务事实。
+
+---
+
+## 四、成本控制
+
+- 简单分类、摘要、文档整理优先低成本模型。
+- 架构、审查、安全、复杂调试使用高能力模型。
+- 大上下文任务必须先压缩输入，再路由给高成本模型。
+- 执行型任务必须限制工具权限和改动范围。
+
+---
+
+## 五、上下文控制
+
+- 每个 Agent 只接收完成任务所需的最小上下文。
+- 不把完整仓库、完整聊天记录或无关文档直接塞给执行型 Agent。
+- 长期记忆必须经过整理后进入任务上下文。
+- 路由决策和关键取舍应写入 memory 或决策记录。
+
+---
+
+## 六、升级规则
+
+需要升级到 Atlas：
+
+- 涉及服务边界。
+- 涉及数据模型。
+- 涉及长期架构。
+- 涉及模型或 runtime 重大调整。
+
+需要升级到 Argus：
+
+- 涉及权限、安全、Prompt 注入。
+- 涉及生产发布。
+- 涉及依赖升级。
+- 涉及 AI 自动生成大段代码。
+
+需要升级到 Mason：
+
+- 涉及多模块协同。
+- 涉及 CI/CD。
+- 涉及交付顺序。
+- 涉及团队 workflow。