关于 senior-system-architecture
该架构 Skill 面向负责跨服务设计、评审和迁移规划的架构师。它提供从决策梳理、系统建模到方案权衡、非功能需求评估及迁移演进的工作流程。
主要功能
- 01梳理目标、约束与决策可逆性
- 02使用 C4-lite 建模系统
- 03定义非功能需求与质量属性
- 04比较架构方案并记录决策
- 05评审风险、数据、安全与可观测性
- 06规划遗留系统迁移与切换
适用场景
- 01评审跨服务边界与契约
- 02比较架构选项及其权衡
- 03编写或审查架构决策记录
- 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.mdarchitecture_review.mdintegration_patterns.mdmigration_evolution.mdnfr_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)
供评审者查看的最低限度视图:
- 上下文 — 参与者、外部系统、信任区域
- 容器 — 可部署单元、数据存储、队列及各自的负责人
- 关键路径 — 仅针对风险最高的流程绘制时序图
为每条箭头标注:同步/异步、协议、身份验证模型和故障行为。
参见 references/integration_patterns.md。
3. 定义非功能需求和质量属性
针对每项能力指定目标(不要使用含糊的“高可用”等说法):
| 属性 | 目标示例 | 验证方式 |
|---|---|---|
| 可用性 | 每月 99.9% | SLO、错误预算 |
| 延迟 | 读请求 p99 < 300ms | 负载测试 + 生产环境 SLO |
| 吞吐量 | 峰值 5k RPS | 容量模型 |
| 持久性 | RPO 1h,RTO 4h | 灾难恢复演练 |
| 安全性 | 东西向 mTLS、OIDC | 威胁模型链接 |
| 成本 | 每 1M 次请求 <$X | FinOps 估算 |
参见 references/nfr_quality_attributes.md。
4. 评估方案
至少列出两个可行方案,以及“维持现状/最小改动”方案:
| 标准 | 权重 | 方案 A | 方案 B |
|---|---|---|---|
| 价值实现时间 | |||
| 运维负担 | |||
| 可扩展性余量 | |||
| 与团队技能的匹配度 | |||
| 供应商锁定 | |||
| 安全/合规适配度 |
推荐一个方案,并记录被否决的方案及原因。
参见 references/adr_template.md。
5. 架构评审
在构建或签署合同之前:
- 用一段话重述问题和约束
- 更新图表;为契约进行版本管理(OpenAPI、事件架构)
- 故障模式:部分服务中断、依赖项不可用、有毒消息
- 数据:所有权、保留期限、PII、迁移路径
- 可观测性:每个容器的黄金信号
- 安全性:授权边界、密钥、爆炸半径
- 如果是多阶段发布,将发布和回滚计划关联到
deployment-strategist
参见 references/architecture_review.md。
6. 演进与迁移
替换旧系统时:
- 确定可独立迁移的能力切片
- 风险较高时,优先采用绞杀者模式,而非大爆炸式迁移
- 在切换之前定义对等标准
- 规划双写 / 双读的持续时间和数据对账
- 通过遥测证明流量为零后,弃用旧路径
参见 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