SuperAPI AI 工具集

architecture-design

设计与创作

查看项目

更新于 10-15 23:24

技能介绍

用途:在启动新产品或重大功能、选择架构模式与数据库、评估可扩展性瓶颈、规划容量、生成架构图(Mermaid、PlantUML、ASCII)或编写架构决策记录(ADR)时,提供系统化的架构设计流程与分析。

主要能力:梳理功能与非功能需求及约束;评估现有项目结构(MVC、分层、六边形、微服务等)与代码组织问题;分析依赖树中的循环依赖、耦合与过期包;按团队规模、部署需求与数据边界选择架构模式;数据库选型;输出 Mermaid ER 图并定义实体归属;定义 API 契约(方法、路径、请求/响应与错误码);生成 C4 或流程图;编写 ADR;识别单点故障、数据一致性与扩展瓶颈并给出缓解措施。

使用方式:先提供产品描述、技术栈、当前阶段、团队规模与预期规模(用户、请求/秒、数据量);若缺失会询问核心用例、目标规模、团队后端经验与硬性约束。随后按工作流产出结构化架构文档,包含需求摘要、架构评估、系统图、领域模型、模块边界表、API 契约、ADR、依赖分析与风险缓解表。

适用场景与判断:1-3 名开发者建议模块化单体;4-10 名可选模块化单体或面向服务;10 人以上可考虑微服务。快速 MVP 用模块化单体,独立部署用微服务,复杂领域用 DDD,读写差异大用 CQRS,需审计用事件溯源,第三方集成用六边形。数据库方面,结构化关系与 ACID 需求指向 SQL,灵活模式指向 NoSQL;常见默认 PostgreSQL,另含 MongoDB、Redis、DynamoDB、TimescaleDB、CockroachDB/Spanner 的适用场景。

设计原则与限制:每个实体明确归属,API 从第一天起加版本,列表接口分页,统一错误结构,写操作幂等,避免分布式事务。可与其他技能链式配合技术选型、安全评审与代码审查。具体环境依赖与安装方式暂未提供。