Receber por email
← Voltar para o catálogo

architecture

Architecture design skill: ADR records, system design checklists, scalability assessment, architecture patterns. Use for complex system design and architecture decisions.

45estrelas
Atualizado há 4 meses

Ver no GitHub ↗ Licença: MIT

Como adicionar

/plugin marketplace add xiaobei930/cc-best

O comando exato pode variar conforme o repositório. Confira o README no GitHub.

Para o autor da skill

Cole no README do seu repo

Mostra que sua skill está catalogada na Skillteca, gera backlink e tráfego rastreável.

[![Skillteca](https://www.skillteca.com.br/api/badge/architecture-xiaobei930/svg)](https://www.skillteca.com.br/skills/architecture-xiaobei930)

Alerta por categoria

Receba novas skills de Design e Frontend toda segunda

1 email curto, só com as skills novas de Design e Frontend. 4 minutos de leitura, sem spam, cancela com 1 clique.

Você confirma o email no primeiro envio. Sem spam. Cancela com 1 clique.

Ler descrição completa

架构设计技能

本技能提供架构设计的完整指南,包括 ADR 记录、设计检查清单、可扩展性评估、架构模式速查等最佳实践。

子文件

  • [lead-methodology.md](lead-methodology.md) - Lead 角色方法论(技术设计、任务分解)
  • [pm-methodology.md](pm-methodology.md) - PM 角色方法论(需求分析、决策框架)

架构决策记录 (ADR)

对于重要的架构决策,创建 ADR 记录:

ADR 模板 (docs/decisions/ADR-XXX.md)

# 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 | 单体应用足够 | | 成长期 | 1K-10K | 优化数据库查询,添加缓存 | | 扩展期 | 10K-100K | 服务拆分,读写分离 | | 规模化 | >100K | 微服务,分布式缓存,多区域 |

常见瓶颈与解决方案

| 瓶颈 | 解决方案 | | ------------ | ---------------------------- | | 数据库读取慢 | 索引优化 → 读写分离 → 缓存层 | | API 响应慢 | 异步处理 → 消息队列 → CDN | | 内存不足 | 分页加载 → 流式处理 → 扩容 | | 并发冲突 | 乐观锁 → 分布式锁 → 事件溯源 |

架构模式速查

后端模式

| 模式 | 适用场景 | 复杂度 | | ---------- | ---------------- | ------ | | 分层架构 | 大多数 CRUD 应用 | 低 | | 六边形架构 | 需要高可测试性 | 中 | | CQRS | 读写负载差异大 | 高 | | 事件溯源 | 需要完整审计轨迹 | 高 | | 微服务 | 团队多、规模大 | 高 |

前端模式

| 模式 | 适用场景 | | ----------------- | -------------- | | 组件组合 | 构建复杂 UI | | 状态提升 | 组件间共享状态 | | Context + Reducer | 全局状态管理 | | 自定义 Hooks | 复用有状态逻辑 | | 渲染属性 | 灵活的组件复用 |

数据访问模式

| 模式 | 说明 | | ------------- | ------------------ | | Repository | 抽象数据访问层 | | Unit of Work | 事务管理 | | DAO | 数据访问对象 | | Active Record | 模型直接操作数据库 |

架构评审清单

在提交设计方案前:

  • [ ] 是否遵循现有架构模式
  • [ ] 是否考虑了向后兼容性
  • [ ] 是否有明确的错误处理策略
  • [ ] 是否考虑了监控和可观测性
  • [ ] 是否有性能基准和目标
  • [ ] 是否考虑了安全性
  • [ ] 是否有回滚方案

与 /cc-best:lead 角色的配合

/cc-best:lead 技术设计
    ↓
  需要架构决策?
    ├─ 是 → 创建 ADR 记录
    └─ 否 → 继续设计
    ↓
  设计检查清单
    ↓
  任务分解
    ↓
  /cc-best:dev 开始实现
记住: 架构决策要记录理由——ADR 不是文档负担,而是未来自己和团队的决策参考。
Compartilhar X LinkedIn