Metago Architecture Design

---
name: "metago-architecture-design"
description: "架构设计技能。根据业务需求生成完整系统架构方案，含架构模式选择、模块分解、接口契约、数据流设计、技术选型依据。遵循高内聚低耦合、可扩展、可维护原则，输出含决策依据的架构文档。"
version: "1.0.0"
author: "MetaGO"
category: "科技开发"
platforms: ["cursor","claude-code","codex","trae","codebuddy","qoder","zcode","workbuddy","qclaw","ima"]
trigger:
  - "帮我设计架构"
  - "系统架构设计"
  - "技术选型方案"
  - "模块分解设计"
  - "生成ADR"
---

# 架构设计（metago-architecture-design）

## 描述
根据业务需求生成完整系统架构方案，覆盖架构模式选择、模块分解、接口契约设计、数据流规划、技术选型。输出含决策依据和权衡分析的架构文档。

## 触发条件
- 用户请求架构设计、系统设计、技术选型时激活
- 新项目启动阶段
- 系统重构/迁移规划阶段
- 与 `metago-action-plan` 协同：重大技术决策时强制触发

## 核心流程

### 1. 需求分解
- 功能性需求拆解（核心用例、边缘场景）
- 非功能性需求量化（QPS、延迟、可用性、数据规模）
- 约束条件识别（预算、团队规模、技术栈、合规要求）
- 演进路径规划（MVP → 完整版 → 规模化）

### 2. 架构模式选择
- 评估候选架构模式（单体/微服务/事件驱动/分层/CQRS）
- 基于需求约束的权衡分析
- 架构决策记录（ADR - Architecture Decision Record）
- 替代方案与降级策略

### 3. 模块分解
- 领域驱动设计（DDD）边界划分
- 模块职责定义（单一职责原则）
- 模块间依赖关系（无循环依赖）
- 接口契约定义（输入/输出/异常）

### 4. 数据流设计
- 数据模型设计（ER 图、字段约束）
- 数据流向（同步/异步、推/拉）
- 一致性策略（强一致/最终一致）
- 缓存策略与失效机制

### 5. 技术选型
- 技术栈评估（成熟度、社区、性能、人才市场）
- 选型依据记录（为什么选 A 不选 B）
- 风险评估（供应商锁定、废弃风险）
- 替代方案储备

## 架构原则检查清单

- [ ] 高内聚低耦合（模块内聚度 ≥ 0.8，耦合度 ≤ 0.3）
- [ ] 单一职责（每个模块只做一件事）
- [ ] 开闭原则（对扩展开放，对修改关闭）
- [ ] 可独立部署（模块可独立部署和回滚）
- [ ] 可水平扩展（无状态服务可水平扩展）
- [ ] 故障隔离（单点故障不影响全局）
- [ ] 可观测性（日志、指标、追踪完备）

## 输出格式

```
【架构设计文档】

## 1. 需求摘要
- 核心用例：...
- 性能指标：QPS=X, 延迟≤Xms, 可用性≥X%
- 约束条件：...

## 2. 架构概览
架构模式：[模式名]
选择依据：[权衡分析]
替代方案：[方案 B, 方案 C]

## 3. 模块设计
| 模块 | 职责 | 接口 | 依赖 |
|------|------|------|------|
| ... | ... | ... | ... |

## 4. 数据流
[数据流向图描述]
一致性策略：...

## 5. 技术选型
| 层次 | 技术 | 选型依据 | 替代方案 |
|------|------|----------|----------|
| ... | ... | ... | ... |

## 6. 演进路径
- MVP：...
- V1：...
- 规模化：...

## 7. 风险与缓解
| 风险 | 概率 | 影响 | 缓解措施 |
|------|------|------|----------|
| ... | ... | ... | ... |
```

## 与其他技能的协同
- 与 `metago-action-plan` 协同：架构设计输出联动行动计划生成
- 与 `metago-decision-eval` 协同：架构决策需通过决策评估
- 与 `metago-critique` 协同：架构方案需通过 L1-L5 批判性分析
- 与 `metago-whatif` 协同：反事实推演验证架构韧性
- 与 `metago-coupling-optimize` 协同：模块耦生度量化优化