architecturelisted

# 架构设计技能 本技能提供架构设计的完整指南，包括 ADR 记录、设计检查清单、可扩展性评估、架构模式速查等最佳实践。 ## 子文件 - [lead-methodology.md](lead-methodology.md) - Lead 角色方法论（技术设计、任务分解） - [pm-methodology.md](pm-methodology.md) - PM 角色方法论（需求分析、决策框架） ## 架构决策记录 (ADR) 对于重要的架构决策，创建 ADR 记录： ### ADR 模板 (`docs/decisions/ADR-XXX.md`) ```markdown # ADR-XXX: [决策标题] ## 状态 Proposed | Accepted | Deprecated | Superseded by ADR-YYY ## 上下文 [描述导致这个决策的背景、问题或需求] ## 决策 [明确说明做出的决策] ## 理由 [解释为什么选择这个方案] ## 备选方案 ### 方案 A: [名称] - 优点: ... - 缺点: ... ### 方案 B: [名称] - 优点: ... - 缺点: ... ## 后果 ### 正面 - [好处1] - [好处2] ### 负面 - [代价1] - [代价2] ### 风险 - [风险1] → 缓解: [措施] ## 相关决策 - ADR-XXX: [相关决策] ## 日期 YYYY-MM-DD ``` ### 何时创建 ADR | 场景 | 是否需要 ADR | | ------------------------------ | ------------- | | 选择主要技术栈（框架、数据库） | ✅ 必须 | | 定义核心架构模式 | ✅ 必须 | | 引入新的外部依赖 | ⚠️ 视影响范围 | | API 设计重大变更 | ✅ 必须 | | 简单的实现细节 | ❌ 不需要 | --- ## 系统设计检查清单 设计方案前，检查以下维度： ### 功能性需求 - [ ] 用户故事是否清晰完整 - [ ] API 契约是否定义明确 - [ ] 数据模型是否满足需求 - [ ] 边界条件是否考虑 ### 非功能性需求 - [ ] **性能**: 响应时间目标？吞吐量要求？ - [ ] **可扩展性**: 预期用户量？数据增长？ - [ ] **可用性**: 可接受的停机时间？ - [ ] **安全性**: 认证授权？数据保护？ ### 技术设计 - [ ] 架构图是否清晰 - [ ] 组件职责是否明确 - [ ] 数据流是否完整 - [ ] 错误处理策略是否定义 - [ ] 测试策略是否规划 ### 运维考虑 - [ ] 部署策略是否明确 - [ ] 监控告警是否规划 - [ ] 日志策略是否定义 - [ ] 回滚方案是否准备 --- ## 可扩展性评估 ### 扩展阶段规划 | 阶段 | 用户量 | 架构要求 | | ------ | -------- | -------------------------- | | MVP | <1K