name: 架构规划 description: 创建详细的架构计划，包括决策记录和风险评估。用于规划重要功能或系统变更。
架构规划技能
目的
为系统设计生成一致、彻底的架构文档。
使用时机
- 规划重要功能实现
- 做出技术或模式决策
- 设计新模块或服务
- 在重大重构工作之前
- 系统集成规划
模板
主要模板
- templates/architecture-doc.md - 完整架构文档
- templates/decision-record.md - ADR（架构决策记录）格式
- templates/risk-assessment.md - 风险矩阵模板
模式库
参考已建立的架构模式：
- patterns/microservices.md - 微服务架构
- patterns/monolith.md - 单体架构
- patterns/serverless.md - 无服务器架构
决策框架
何时创建ADR
当以下情况时，创建正式的架构决策记录：
- 选择技术（数据库、框架、库）
- 选择架构模式（单体与微服务）
- 定义集成方法（同步与异步）
- 做出安全模型更改
- 难以逆转的决策
ADR格式（轻量级）
# ADR-[N]: [标题]
**状态:** 提议 | 接受 | 弃用 | 取代
**日期:** [YYYY-MM-DD]
## 上下文
[为什么需要这个决策？情况是什么？]
## 决策
[决定是什么？]
## 后果
[这个决策带来什么后果？]
风险评估矩阵
使用此矩阵对风险进行分类：
| 概率 ↓ / 影响 → | 低 | 中 | 高 |
|---|---|---|---|
| 高 | 中 | 高 | 关键 |
| 中 | 低 | 中 | 高 |
| 低 | 低 | 低 | 中 |
风险类别
- 技术: 技术限制、复杂性、性能
- 时间线: 时间表影响、依赖关系
- 集成: 外部系统依赖、API变更
- 安全: 漏洞、合规要求
- 运营: 部署、监控、维护
架构文档章节
必选章节
- 概述 - 高级描述
- 设计决策 - 关键选择及理由
- 组件设计 - 责任和接口
- 风险评估 - 已识别的风险及缓解措施
可选章节（根据需要）
- 数据流程图
- 集成点
- 安全考虑
- 性能要求
- 迁移策略
质量检查清单
在最终确定架构文档之前：
- [ ] 所有主要决策都有文档记录，并考虑了选项
- [ ] 每个决策都提供了理由
- [ ] 明确说明了权衡
- [ ] 识别了风险并制定了缓解策略
- [ ] 与现有代码库模式对齐（来自研究）
- [ ] 集成点明确定义
- [ ] 组件职责清晰且不重叠
- [ ] 考虑了安全影响
- [ ] 解决了性能要求
输出位置
将架构文档保存到：docs/plans/architecture-{session}.md
将ADRs保存到：docs/plans/adr-{number}-{title}.md
与工作流程集成
- 研究阶段 提供代码库上下文和模式
- 提问阶段 提供验证的需求
- 架构规划 创建设计文档（此技能）
- 任务分解 将架构转换为可执行任务
- 实施 遵循批准的plan