用途
System Architect 是一个系统架构设计技能,定位为解决方案设计阶段(Phase 3)的专家,负责设计满足全部功能需求(FR)与非功能需求(NFR)的系统架构。其核心目标是把需求转化为完整的技术架构,包括有依据的技术选型、组件设计和系统性的 NFR 覆盖。
主要能力
- 基于需求文档(PRD 或 tech-spec)设计系统架构
- 选择合适的技术栈并给出清晰理由
- 定义系统组件、边界与接口
- 创建数据模型与 API 规范
- 系统性地处理非功能需求(NFR)
- 确保可扩展性、安全性与可维护性
- 记录架构决策与权衡
核心原则包括:需求驱动、面向非功能需求设计、简单优先、松耦合、记录决策。
使用方式
该技能包含三类关键工作流:
-
创建系统架构:加载需求文档,提取全部 FR 与 NFR,识别架构驱动因素,根据项目复杂度选择架构模式,设计组件、边界与接口,创建数据模型与 API 规范,将每项 NFR 映射到具体架构决策,记录技术栈选择理由与关键权衡,最终生成架构文档,输出路径为 docs/architecture-{project-name}-{date}.md。
-
验证架构:加载已有架构文档与需求文档,检查所有 FR 是否被组件覆盖、所有 NFR 是否映射到架构决策、技术选择是否有依据、组件接口是否定义、数据模型是否完整、权衡是否记录,生成带通过/失败状态与建议的验证报告。
-
NFR 覆盖检查:运行 NFR 检查脚本识别全部 NFR 类别,审查架构文档的 NFR 覆盖情况,生成覆盖矩阵,指出已覆盖与缺失的 NFR,并给出建议。
可用脚本:
- NFR 检查:bash scripts/nfr-checklist.sh
- 架构验证:bash scripts/validate-architecture.sh docs/architecture-myproject-2025-12-09.md
架构文档结构包含:系统概览、架构模式、组件设计、数据模型、API 规范、NFR 映射、技术栈、权衡分析、部署架构、未来考虑。模板位于 templates/architecture.template.md。
该技能还采用并行子代理策略,包括需求分析工作流(2 个并行代理分别分析 FR 与 NFR)、组件设计工作流(每个主要组件一个代理)、NFR 映射工作流(每个 NFR 类别一个代理)。
适用场景
- 为新项目设计系统架构
- 进行有依据的技术栈选型
- 定义系统组件及其交互
- 系统性处理非功能需求
- 创建数据模型与 API 规范
- 记录架构模式与决策
- 对照需求验证架构
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。架构模式选择需根据项目复杂度进行,避免过度设计;对于不明确的需求应提出疑问而非假设。该技能属于解决方案设计阶段,需在需求文档(PRD 或 tech-spec)之后使用,并为后续的冲刺规划与开发实现提供技术蓝图。