mcpField
S
senior-system-architecture

senior-system-architecture

github.com/rade-nugroho开发1240 次安装23 周前更新
代码仓库

关于 senior-system-architecture

该架构 Skill 面向负责跨服务设计、评审和迁移规划的架构师。它提供从决策梳理、系统建模到方案权衡、非功能需求评估及迁移演进的工作流程。

主要功能

  1. 01梳理目标、约束与决策可逆性
  2. 02使用 C4-lite 建模系统
  3. 03定义非功能需求与质量属性
  4. 04比较架构方案并记录决策
  5. 05评审风险、数据、安全与可观测性
  6. 06规划遗留系统迁移与切换

适用场景

  1. 01评审跨服务边界与契约
  2. 02比较架构选项及其权衡
  3. 03编写或审查架构决策记录
  4. 04规划遗留系统分阶段替换

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rade-nugroho/agentic-enteprises-skill --skill senior-system-architecture

安装后在 Claude Code 中输入/senior-system-architecture确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
adr_template.md
architecture_review.md
integration_patterns.md
migration_evolution.md
nfr_quality_attributes.md

详细介绍

高级系统架构

适用场景

  • 定义或评审跨服务/系统边界和契约
  • 比较架构方案,明确权衡及对非功能需求(NFR)的影响
  • 为难以逆转的决策编写或评审 ADR
  • 在重大上线或承诺采用供应商方案前进行架构评审
  • 规划从遗留系统迁移(绞杀者模式、并行运行、切换)
  • 建立架构原则、标准和例外处理流程

不适用场景

  • 单团队服务 RFC 和实现拆分 → senior-software-engineer
  • Lakehouse、数据网格或企业数据建模 → data-architect
  • VPC、Kubernetes、Terraform 或 CI/CD 构建 → infrastructure-engineer、devops
  • IDP、黄金路径、Backstage → platform-engineer
  • 里程碑、RAID、指导委员会状态 → technical-program-manager
  • 仅涉及发布切换策略 → deployment-strategist
  • 安全控制目录和企业 GRC → cybersecurity
  • LLM/RAG 系统设计 → ai-engineer
  • 业务战略、问题树、指导委员会案例 → business-consultant
  • 应用 AI/LLM 解决方案架构 → applied-ai-architect-commercial-enterprise
  • 面向客户的解决方案设计、RFP/RFI、PoC 范围、交易集成 → solutions-architect

相关技能

需求技能
服务级 RFC 和代码评审senior-software-engineer
数据领域和治理架构data-architect
云解决方案和迁移架构cloud-architect
企业云治理和落地区域enterprise-cloud-architect
云/网络/IaC 交付infrastructure-engineer、cloud-engineer
平台即产品和黄金路径platform-engineer
多团队上线协调technical-program-manager
发布和回滚规划deployment-strategist
安全架构和控制措施cybersecurity、information-security-engineer
需求和业务约束business-analyst
战略、商业论证、运营模式business-consultant
AI/LLM 解决方案模式ai-engineer
商业/企业应用 AI 架构applied-ai-architect-commercial-enterprise
客户交易解决方案、RFP、PoC 交接solutions-architect

核心工作流

1. 明确决策

绘制方框图前先记录:

  • 业务成果和可衡量的成功标准
  • 约束:预算、时间线、合规要求、现有技术环境
  • 非目标(明确的范围排除项)
  • 利益相关者和决策负责人
  • 可逆性:单向门还是双向门

单向门决策需要 ADR 和架构评审。双向门决策可留在团队 RFC 中处理。

2. 建模系统(C4-lite)

供评审者查看的最低限度视图:

  1. 上下文 — 参与者、外部系统、信任区域
  2. 容器 — 可部署单元、数据存储、队列及各自的负责人
  3. 关键路径 — 仅针对风险最高的流程绘制时序图

为每条箭头标注:同步/异步、协议、身份验证模型和故障行为。

参见 references/integration_patterns.md。

3. 定义非功能需求和质量属性

针对每项能力指定目标(不要使用含糊的“高可用”等说法):

属性目标示例验证方式
可用性每月 99.9%SLO、错误预算
延迟读请求 p99 < 300ms负载测试 + 生产环境 SLO
吞吐量峰值 5k RPS容量模型
持久性RPO 1h,RTO 4h灾难恢复演练
安全性东西向 mTLS、OIDC威胁模型链接
成本每 1M 次请求 <$XFinOps 估算

参见 references/nfr_quality_attributes.md。

4. 评估方案

至少列出两个可行方案,以及“维持现状/最小改动”方案:

标准权重方案 A方案 B
价值实现时间
运维负担
可扩展性余量
与团队技能的匹配度
供应商锁定
安全/合规适配度

推荐一个方案,并记录被否决的方案及原因。

参见 references/adr_template.md。

5. 架构评审

在构建或签署合同之前:

  1. 用一段话重述问题和约束
  2. 更新图表;为契约进行版本管理(OpenAPI、事件架构)
  3. 故障模式:部分服务中断、依赖项不可用、有毒消息
  4. 数据:所有权、保留期限、PII、迁移路径
  5. 可观测性:每个容器的黄金信号
  6. 安全性:授权边界、密钥、爆炸半径
  7. 如果是多阶段发布,将发布和回滚计划关联到 deployment-strategist

参见 references/architecture_review.md。

6. 演进与迁移

替换旧系统时:

  1. 确定可独立迁移的能力切片
  2. 风险较高时,优先采用绞杀者模式,而非大爆炸式迁移
  3. 在切换之前定义对等标准
  4. 规划双写 / 双读的持续时间和数据对账
  5. 通过遥测证明流量为零后,弃用旧路径

参见 references/migration_evolution.md。

何时加载参考资料

  • ADR 格式和标准 → references/adr_template.md
  • 评审检查清单 → references/architecture_review.md
  • 同步、事件、Saga、API → references/integration_patterns.md
  • SLO、容量、灾难恢复、成本 → references/nfr_quality_attributes.md
  • 绞杀者模式和切换 → references/migration_evolution.md

评论

支持 Markdown