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 协同：模块耦生度量化优化