SA Master 系统架构师

要解决什么问题

真实架构师的时间往往耗在「把 PRD 和概念图整理成可评审的架构资产」以及「对照架构说明书审开发详细设计」上。若缺少统一模板与知识沉淀，产出容易各说各话，接口边界、部署与非功能要求也常滞后于总体设计。

SA Master Agent 的定位是辅助生成：在 BA 已给出需求规格说明书（PRD）和概念级图（业务流程图 / ER 图 / DFD）的前提下，结合 Qdrant 架构知识库，分阶段产出标准化文档，并对场景级详细设计做架构一致性与需求完整性评审。最终决策权仍在真实 SA 手中。

技能如何工作

智能体通过远程 MCP（https://mcp.smartmoves.com.cn/sa/mcp，streamable-http）暴露工具，各子技能采用 context 阶段调度：首次调用须传 {"stage":"init"} 确认基准路径，再在 user message 首行以 基准路径：{路径} 进入后续阶段。

四条能力链路如下：

• 系统技术架构总体设计（sa_architecture_design）：从业务解析、知识检索到分层、模块、接口、数据、部署与非功能架构，产出《系统技术架构设计说明书》及 Mermaid 图与备选方案。
• 系统边界接口设计（sa_api_design）：在架构 §6 与数据字典等输入下，定义对外暴露、外部调用与内部关键接口及协议规范。
• 部署实施指南（sa_deployment_guide）：以架构设计说明书为基线，按需独立推进环境规划、CI/CD、监控日志、回滚容灾等子流程。
• 详细设计评审（sa_detailed_design_review）：对照架构说明书与用户故事，给出通过 / 有条件通过 / 不通过的评审结论与改进建议。

服务端响应中的 [DOC]、[ASK]、[NOTIFY] 等协议块负责文档落盘与阶段续调；可用 get_session_info 查看进度，export_artifacts 导出产出物。

适用边界与注意点

• 职责范围：仅系统架构设计相关分析与文档，不写业务代码、不做 UI 视觉、不替代 BA 澄清需求、不代替真实 SA 做最终选型决策。
• 输入前提：架构内容必须基于已有业务资产，不得凭空编造实体、流程或需求逻辑；不确定方案应标「待验证」。
• 客户端依赖：首次加载需成功连接 MCP；连接失败则工具不可用。问候类开场会展示技能清单表格，若用户直接进入具体任务则跳过引导。