SuperAPI AI 工具集

architecture-designer

编程与开发

查看项目

更新于 10-16 23:14

技能介绍

用途

Architecture Designer 是一个面向软件架构设计工作的技能,其角色定义为拥有 15 年以上经验、专注于可扩展分布式系统的首席架构师。它用于在系统设计与架构决策环节提供结构化支持。

适用场景

根据技能说明,该技能适用于以下情形:

  • 设计新的系统架构
  • 在架构模式之间进行选择
  • 评审既有架构
  • 创建架构决策记录(ADR)
  • 进行可扩展性规划
  • 评估技术选择

核心工作流

  1. 理解需求——收集功能性需求、非功能性需求与约束条件,并在继续之前确认需求覆盖完整。
  2. 识别模式——将需求匹配到相应的架构模式(参见参考指南)。
  3. 设计——完成架构设计,显式记录权衡,并产出架构图。
  4. 文档化——为所有关键决策编写 ADR。
  5. 评审——与利益相关方进行验证;若评审失败,则带着记录的反馈回到第 3 步。

参考指南

技能中包含按上下文加载详细指导的参考表:

  • 架构模式:references/architecture-patterns.md,在选择单体还是微服务时加载。
  • ADR 模板:references/adr-template.md,在记录决策时加载。
  • 系统设计:references/system-design.md,在需要完整系统设计模板时加载。
  • 数据库选型:references/database-selection.md,在选择数据库技术时加载。
  • 非功能需求清单:references/nfr-checklist.md,在收集非功能需求时加载。

约束

必须做到:为所有重大决策编写 ADR;显式考虑非功能需求;评估权衡而非只关注收益;规划失败模式;考虑运维复杂度;在最终确定前与利益相关方评审。

不应做:为假设的规模进行过度设计;在未评估替代方案的情况下选择技术;忽视运维成本;在不了解需求的情况下进行设计;跳过安全考虑。

输出模板

在设计架构时,技能要求提供以下内容:

  1. 需求摘要(功能性 + 非功能性)
  2. 高层架构图(推荐使用 Mermaid)
  3. 关键决策及权衡(ADR 格式)
  4. 技术建议及理由
  5. 风险与缓解策略

技能中给出的架构图示例为一段 Mermaid 代码,展示客户端、API 网关、认证服务、订单服务、订单数据库(PostgreSQL)、消息队列(RabbitMQ)与通知服务之间的调用关系。

ADR 示例为「ADR-001:使用 PostgreSQL 存储订单」,包含状态(Accepted)、上下文(订单服务需要跨订单、行项目与客户的 ACID 兼容事务和复杂关系查询)、决策(使用 PostgreSQL 作为订单服务的主数据存储)、已考虑的替代方案(MongoDB 缺乏跨文档的强 ACID 保证;DynamoDB 扩展性优秀但复杂查询模式需要反规范化)、后果(正面:强一致性、成熟工具链、复杂查询支持;负面:垂直扩展存在上限,水平分片增加运维复杂度)以及权衡(一致性与查询灵活性优先于无限的横向写入扩展能力)。

来源与许可

该技能引用自 jeffallan/claude-skills,作者为 Jeffallan,许可为 MIT,引用修订版本为 3bf9a24b76a7c122f1fc05e83929fbc84e1c207a。适用平台、价格与收费方式等事实在资料中暂未提供。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明