architecture-assessment

name	architecture-assessment
description	Architecture quality assessment. 当用户需要评估架构质量、检查系统性能、分析安全风险或评估可扩展性时使用此skill。

Architecture Assessment

架构评估技能，从多个维度评估系统架构质量。

评估维度 (ATAM + 更多)

┌─────────────────────────────────────────────────────────┐
│                  架构质量评估                            │
├──────────────┬──────────────┬──────────────┬─────────────┤
│  性能        │  安全性      │  可用性       │  可维护性   │
├──────────────┼──────────────┼──────────────┼─────────────┤
│  性能测试    │  安全审计    │  容错设计     │  代码质量   │
│  容量规划    │  威胁建模    │  监控告警     │  文档完整   │
│  瓶颈分析    │  合规检查    │  灾难恢复     │  测试覆盖   │
└──────────────┴──────────────┴──────────────┴─────────────┘

1. 性能评估

性能指标定义

指标	定义	目标值示例
响应时间 (RT)	请求到响应的时间	P99 < 200ms
吞吐量 (TPS)	每秒处理事务数	> 1000 TPS
并发用户	同时活跃用户数	> 5000
资源利用率	CPU/内存/磁盘使用	CPU < 70%
错误率	失败请求占比	< 0.1%

性能测试类型

□ 负载测试 (Load Testing)
  - 验证预期负载下的性能
  - 关注: RT, TPS, 资源利用率

□ 压力测试 (Stress Testing)
  - 超过预期负载，探索极限
  - 找到系统崩溃点

□ 容量测试 (Capacity Testing)
  - 确定最大容量
  - 规划扩容依据

□ 尖峰测试 (Spike Testing)
  - 突发流量冲击
  - 验证弹性伸缩

性能评估报告模板

## 性能评估

### 当前性能状态
| 指标 | 当前值 | 目标值 | 状态 |
|------|--------|--------|------|
| P50 响应时间 | XX ms | < 100ms | ✅/❌ |
| P99 响应时间 | XX ms | < 200ms | ✅/❌ |
| TPS | XXX | > 1000 | ✅/❌ |
| 错误率 | X.X% | < 0.1% | ✅/❌ |

### 瓶颈分析
1. [瓶颈点]
2. [瓶颈点]

### 优化建议
| 优化项 | 预期收益 | 实施成本 | 优先级 |
|--------|---------|---------|--------|
|        |         |         |        |

2. 安全性评估

安全评估框架

□ 身份认证 (Authentication)
  - 密码策略
  - 多因素认证
  - 社交登录

□ 访问控制 (Authorization)
  - 权限模型 (RBAC/ABAC)
  - 最小权限原则
  - API 鉴权

□ 数据保护 (Data Protection)
  - 传输加密 (TLS)
  - 存储加密
  - 敏感数据脱敏

□ 安全审计 (Audit)
  - 操作日志
  - 异常检测
  - 合规报告

OWASP Top 10 检查

□ A01: Broken Access Control
□ A02: Cryptographic Failures
□ A03: Injection
□ A04: Insecure Design
□ A05: Security Misconfiguration
□ A06: Vulnerable Components
□ A07: Auth Failures
□ A08: Data Integrity Failures
□ A09: Logging Failures
□ A10: SSRF

威胁建模 (STRIDE)

威胁类型	描述	缓解措施
Spoofing	冒充身份	强认证
Tampering	数据篡改	完整性校验
Repudiation	否认操作	数字签名/审计日志
Information Disclosure	信息泄露	加密/访问控制
DoS	服务拒绝	限流/冗余
Elevation of Privilege	权限提升	最小权限原则

3. 可用性评估

可用性指标

可用性级别	年停机时间	适用场景
99.9%	8.7 小时	普通业务
99.99%	52 分钟	重要业务
99.999%	5 分钟	关键系统

容错设计检查

□ 冗余设计
  - 服务多实例部署
  - 数据多副本存储
  - 跨可用区/区域部署

□ 故障隔离
  - 舱壁模式
  - 断路器模式
  - 限流熔断

□ 故障恢复
  - 自动故障转移
  - 数据一致性修复
  - 服务快速重启

监控告警检查

□ 基础设施监控
  - CPU/内存/磁盘
  - 网络流量

□ 应用监控
  - 请求量/响应时间
  - 错误率
  - 业务指标

□ 日志监控
  - 集中式日志
  - 日志分析
  - 异常聚合

□ 告警配置
  - 告警阈值
  - 告警升级
  - 告警收敛

4. 可维护性评估

代码质量指标

指标	优秀	良好	差
测试覆盖率	> 80%	60-80%	< 60%
圈复杂度	< 10	10-20	> 20
重复代码	< 3%	3-10%	> 10%
文档覆盖率	> 80%	50-80%	< 50%

架构可维护性检查

□ 模块化程度
  - 模块间耦合度
  - 模块内聚力
  - 接口稳定性

□ 技术债务
  - 已知问题数量
  - 遗留代码比例
  - 重构需求

□ DevOps 成熟度
  - 部署频率
  - 变更前置时间
  - 变更失败率

5. 可扩展性评估

水平扩展 vs 垂直扩展

维度	垂直扩展	水平扩展
扩展方式	增加单机资源	增加机器数量
限制	硬件上限	架构设计
成本	线性增长	线性增长
复杂度	低	高

扩展性设计模式

□ 无状态设计
  - Session 外置
  - 本地无状态存储

□ 分片策略
  - 数据分片
  - 服务分片

□ 异步处理
  - 消息队列
  - 事件驱动

□ 读写分离
  - 主从复制
  - CQRS

综合评估报告模板

# 架构质量评估报告

## 评估概要
- **系统**: [系统名称]
- **评估日期**: [日期]
- **评估人**: [姓名]
- **总体评级**: [A/B/C/D]

## 维度评分

| 维度 | 评分 | 主要发现 |
|------|------|---------|
| 性能 | X/10 | [简述] |
| 安全性 | X/10 | [简述] |
| 可用性 | X/10 | [简述] |
| 可维护性 | X/10 | [简述] |
| 可扩展性 | X/10 | [简述] |

## 详细发现

### 严重风险 (必须解决)
| 问题 | 影响 | 建议 |
|------|------|------|
|      |      |      |

### 中等风险 (尽快解决)
| 问题 | 影响 | 建议 |
|------|------|------|
|      |      |      |

### 低风险 (持续改进)
| 问题 | 影响 | 建议 |
|------|------|------|
|      |      |      |

## 改进路线图

### Phase 1 (0-3个月)
- [ ] 改进项1
- [ ] 改进项2

### Phase 2 (3-6个月)
- [ ] 改进项1
- [ ] 改进项2

### Phase 3 (6-12个月)
- [ ] 改进项1
- [ ] 改进项2

## 结论
[总结和建议]

快速评估 Checklist

性能
□ 有性能测试报告吗？
□ 响应时间是否满足 SLA？
□ 存在已知的性能瓶颈吗？

安全
□ 做过安全审计吗？
□ 敏感数据是否加密？
□ 有入侵检测机制吗？

可用性
□ SLA 是什么？
□ 当前可用性是多少？
□ 有灾难恢复计划吗？

可维护性
□ 代码质量如何？
□ 有自动化测试吗？
□ 文档是否最新？

可扩展性
□ 系统能承受 10 倍增长吗？
□ 扩展瓶颈在哪？
□ 扩容需要多长时间？