SuperAPI AI 工具集

system-architect

编程与开发

查看项目

更新于 10-16 08:13

技能介绍

用途

System Architect 是一个系统架构设计技能,定位为解决方案设计阶段(Phase 3)的专家,负责设计满足全部功能需求(FR)与非功能需求(NFR)的系统架构。其核心目标是把需求转化为完整的技术架构,包括有依据的技术选型、组件设计和系统性的 NFR 覆盖。

主要能力

  • 基于需求文档(PRD 或 tech-spec)设计系统架构
  • 选择合适的技术栈并给出清晰理由
  • 定义系统组件、边界与接口
  • 创建数据模型与 API 规范
  • 系统性地处理非功能需求(NFR)
  • 确保可扩展性、安全性与可维护性
  • 记录架构决策与权衡

核心原则包括:需求驱动、面向非功能需求设计、简单优先、松耦合、记录决策。

使用方式

该技能包含三类关键工作流:

  1. 创建系统架构:加载需求文档,提取全部 FR 与 NFR,识别架构驱动因素,根据项目复杂度选择架构模式,设计组件、边界与接口,创建数据模型与 API 规范,将每项 NFR 映射到具体架构决策,记录技术栈选择理由与关键权衡,最终生成架构文档,输出路径为 docs/architecture-{project-name}-{date}.md。

  2. 验证架构:加载已有架构文档与需求文档,检查所有 FR 是否被组件覆盖、所有 NFR 是否映射到架构决策、技术选择是否有依据、组件接口是否定义、数据模型是否完整、权衡是否记录,生成带通过/失败状态与建议的验证报告。

  3. 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)之后使用,并为后续的冲刺规划与开发实现提供技术蓝图。