Skip to content

staruhub/ClaudeSkills / skills/Geek-skills-solution-architect

solution-architect

Verified

解决方案架构师助手。当用户要设计新系统架构、评审现有架构、做技术选型决策、诊断性能/可扩展性/可用性问题、规划架构演进或重构时使用。覆盖微服务、事件驱动、云原生等架构模式,技术趋势通过实时搜索获取而非依赖内置知识。不用于:具体功能的代码实现、安全漏洞审计(用security-audit)、产品需求分析(用product-manager)、只需一句话回答的技术常识问题。

references/架构评审清单.md

View on GitHub
# 架构评审清单

## 一、功能性评审

### 1.1 需求满足度
- [ ] 所有功能需求是否都已在架构中体现?
- [ ] 非功能需求(性能、安全等)是否考虑?
- [ ] 是否有遗漏的关键功能?
- [ ] 是否考虑了未来扩展需求?

### 1.2 业务逻辑
- [ ] 业务流程是否正确映射到架构?
- [ ] 领域模型是否清晰?
- [ ] 边界上下文是否合理划分?
- [ ] 是否符合业务规则和约束?

## 二、质量属性评审

### 2.1 性能
- [ ] 是否满足响应时间SLA? (如99th < 100ms)
- [ ] 是否满足吞吐量要求? (如10000 TPS)
- [ ] 是否有性能瓶颈?
- [ ] 是否有缓存策略?
- [ ] 数据库查询是否优化?
- [ ] 是否考虑CDN和静态资源优化?

### 2.2 可扩展性
- [ ] 系统是否可以水平扩展?
- [ ] 服务是否无状态设计?
- [ ] 数据库是否支持扩展(分片/读写分离)?
- [ ] 是否有自动伸缩机制?
- [ ] 扩展瓶颈在哪里?

### 2.3 可用性
- [ ] 目标可用性是多少? (99.9%/99.99%/99.999%)
- [ ] 是否有冗余设计(多副本/多AZ)?
- [ ] 是否有故障转移机制?
- [ ] 是否有健康检查?
- [ ] 是否有降级和熔断策略?
- [ ] RTO和RPO是否明确?

### 2.4 可靠性
- [ ] 是否有容错机制?
- [ ] 数据一致性如何保证?
- [ ] 是否有重试和补偿机制?
- [ ] 是否处理分布式事务?
- [ ] 消息队列是否保证delivery?

### 2.5 安全性
- [ ] 是否有认证机制? (OAuth/JWT)
- [ ] 是否有授权控制? (RBAC/ABAC)
- [ ] 数据传输是否加密? (HTTPS/TLS)
- [ ] 敏感数据存储是否加密?
- [ ] 是否防范常见攻击? (SQL注入/XSS/CSRF)
- [ ] 是否遵循零信任原则?
- [ ] API是否有速率限制?
- [ ] 是否有安全审计日志?

### 2.6 可维护性
- [ ] 代码是否模块化?
- [ ] 服务职责是否清晰?
- [ ] 是否遵循SOLID原则?
- [ ] 是否易于测试?
- [ ] 文档是否齐全?
- [ ] 是否有充分的注释?

### 2.7 可观测性
- [ ] 是否有日志记录? (集中式日志)
- [ ] 是否有指标监控? (Prometheus/Grafana)
- [ ] 是否有分布式追踪? (Jaeger/Zipkin)
- [ ] 是否有告警机制?
- [ ] 是否有仪表板?
- [ ] 关键业务指标是否可见?

## 三、架构设计评审

### 3.1 架构风格
- [ ] 选择的架构模式是否合适? (微服务/单体/Serverless)
- [ ] 是否过度设计?
- [ ] 是否适合团队规模和能力?
- [ ] 是否考虑了演进路径?

### 3.2 服务设计
- [ ] 服务划分是否合理?
- [ ] 服务粒度是否适当?
- [ ] 服务间依赖是否清晰?
- [ ] 是否避免了循环依赖?
- [ ] 是否有API版本管理策略?

### 3.3 数据设计
- [ ] 数据模型是否合理?
- [ ] 数据库选型是否恰当?
- [ ] 是否需要读写分离?
- [ ] 是否需要分库分表?
- [ ] 数据一致性策略是否清晰?
- [ ] 是否有数据备份和恢复方案?

### 3.4 API设计
- [ ] API设计是否RESTful或符合规范?
- [ ] 是否有统一的错误处理?
- [ ] 是否有请求/响应校验?
- [ ] 是否有API文档? (Swagger/OpenAPI)
- [ ] 是否考虑向后兼容?

### 3.5 集成设计
- [ ] 同步vs异步通信选择是否合理?
- [ ] 消息队列使用是否恰当?
- [ ] 是否有服务发现机制?
- [ ] 是否有API网关?
- [ ] 外部系统集成是否有超时和重试?

## 四、技术选型评审

### 4.1 技术栈
- [ ] 技术选型是否有充分理由?
- [ ] 是否考虑了团队技能?
- [ ] 是否评估了学习曲线?
- [ ] 是否有POC验证?
- [ ] 是否考虑了供应商锁定风险?

### 4.2 第三方依赖
- [ ] 依赖的开源项目是否活跃维护?
- [ ] 许可证是否合规?
- [ ] 是否有安全漏洞?
- [ ] 是否有替代方案?

### 4.3 云服务
- [ ] 云服务商选择是否合理?
- [ ] 是否评估了成本?
- [ ] 是否考虑了多云/混合云策略?
- [ ] 是否有云迁移计划?

## 五、部署与运维评审

### 5.1 部署架构
- [ ] 部署架构是否清晰?
- [ ] 是否有蓝绿部署/金丝雀发布策略?
- [ ] 是否支持回滚?
- [ ] 部署自动化程度如何?

### 5.2 CI/CD
- [ ] 是否有CI/CD流程?
- [ ] 构建流程是否自动化?
- [ ] 测试是否自动化?
- [ ] 部署是否自动化?

### 5.3 环境管理
- [ ] 是否有开发/测试/预发/生产环境?
- [ ] 环境配置是否外部化?
- [ ] 环境间差异是否最小化?

### 5.4 运维考虑
- [ ] 是否易于监控和调试?
- [ ] 是否有运维手册?
- [ ] 故障处理流程是否清晰?
- [ ] 是否有on-call机制?

## 六、成本评审

### 6.1 基础设施成本
- [ ] 是否评估了云服务成本?
- [ ] 是否有成本优化策略?
- [ ] 是否考虑了Reserved Instance/Spot Instance?
- [ ] 存储成本是否合理?

### 6.2 开发成本
- [ ] 开发时间估算是否合理?
- [ ] 是否需要额外招聘?
- [ ] 是否需要外部咨询?
- [ ] 培训成本是否考虑?

### 6.3 运维成本
- [ ] 运维人力成本?
- [ ] 工具和服务订阅费用?
- [ ] 维护和升级成本?

## 七、风险评审

### 7.1 技术风险
- [ ] 使用的技术是否成熟?
- [ ] 是否有技术深坑?
- [ ] 团队是否有相关经验?
- [ ] 是否有技术备选方案?

### 7.2 性能风险
- [ ] 是否有性能测试计划?
- [ ] 预期流量峰值是否考虑?
- [ ] 性能瓶颈是否识别?

### 7.3 安全风险
- [ ] 是否有安全威胁模型?
- [ ] 是否有渗透测试计划?
- [ ] 敏感数据处理是否合规?

### 7.4 依赖风险
- [ ] 外部依赖是否有SLA?
- [ ] 是否有降级方案?
- [ ] 供应商风险是否评估?

### 7.5 合规风险
- [ ] 是否符合行业法规? (GDPR/等保)
- [ ] 数据存储位置是否合规?
- [ ] 审计要求是否满足?

## 八、文档评审

### 8.1 架构文档
- [ ] 是否有系统架构图?
- [ ] 是否有部署架构图?
- [ ] 是否有数据流图?
- [ ] 是否有时序图?
- [ ] 是否有架构决策记录(ADR)?

### 8.2 设计文档
- [ ] 是否有详细设计文档?
- [ ] 是否有接口文档?
- [ ] 是否有数据模型文档?

### 8.3 运维文档
- [ ] 是否有部署文档?
- [ ] 是否有运维手册?
- [ ] 是否有故障处理文档?

## 九、团队和流程评审

### 9.1 团队能力
- [ ] 团队是否具备所需技能?
- [ ] 是否需要培训?
- [ ] 是否需要招聘?
- [ ] 团队规模是否匹配架构复杂度?

### 9.2 开发流程
- [ ] 开发流程是否清晰?
- [ ] 代码审查机制是否有效?
- [ ] 测试流程是否完善?
- [ ] 发布流程是否顺畅?

### 9.3 沟通协作
- [ ] 跨团队协作机制是否清晰?
- [ ] 接口责任是否明确?
- [ ] 冲突解决机制是否有效?

## 十、评审输出

### 10.1 评审会议记录
```
会议时间: [日期时间]
参会人员: [列表]
架构师: [姓名]

评审结果: [通过/有条件通过/不通过]

主要问题:
1. [问题描述] - [严重程度: 高/中/低]
2. [问题描述] - [严重程度: 高/中/低]

改进建议:
1. [建议内容]
2. [建议内容]

后续行动:
- [ ] [任务] - [负责人] - [截止日期]
- [ ] [任务] - [负责人] - [截止日期]

下次评审时间: [日期]
```

### 10.2 评分卡

| 评审项 | 权重 | 评分(1-5) | 加权分 |
|--------|------|-----------|--------|
| 功能完整性 | 20% | | |
| 性能 | 15% | | |
| 可扩展性 | 15% | | |
| 可用性 | 15% | | |
| 安全性 | 15% | | |
| 可维护性 | 10% | | |
| 成本合理性 | 5% | | |
| 技术选型 | 5% | | |
| **总分** | **100%** | | |

评分说明:
- 5分: 优秀,超出预期
- 4分: 良好,满足要求
- 3分: 合格,基本满足
- 2分: 需改进
- 1分: 不合格

### 10.3 决策
- **通过**: 总分≥4.0,无高严重度问题
- **有条件通过**: 总分≥3.5,有中等问题需在X周内解决
- **不通过**: 总分<3.5或有高严重度问题

## 十一、持续改进

### 回顾
- 定期(季度)回顾架构
- 评估架构决策效果
- 收集团队反馈

### 优化
- 识别技术债务
- 制定偿还计划
- 渐进式架构演进

### 学习
- 总结经验教训
- 更新最佳实践
- 团队知识分享
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall