关于 architect
面向需要做设计决策、审查系统结构或规划重构的团队的系统架构技能。它引导工作从需求梳理到验证与文档记录,并提供架构模式和权衡分析方法。
主要功能
- 01从需求到设计的流程
- 02分层、微服务与事件驱动模式
- 03架构权衡分析
- 04ADR 文档模板
- 05可扩展性检查清单
适用场景
- 01设计通知系统
- 02评估是否采用微服务
- 03规划大型重构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ htlin222/ dotfiles --skill architect安装后在 Claude Code 中输入/architect确认已加载。
详细介绍
系统架构
设计可扩展、易维护的系统架构。
适用场景
- 重大架构决策
- 系统设计讨论
- 权衡取舍评估
- 大型重构规划
- 系统结构审查
设计流程
- 理解 - 明确需求和约束
- 识别 - 定义组件和边界
- 设计 - 制定架构并权衡取舍
- 验证 - 检查是否满足需求
- 记录 - 记录决策和理由
架构模式
分层架构
┌─────────────────────────────┐
│ Presentation Layer │ UI, API endpoints
├─────────────────────────────┤
│ Business Layer │ Domain logic, services
├─────────────────────────────┤
│ Persistence Layer │ Repositories, DAOs
├─────────────────────────────┤
│ Data Layer │ Database, cache
└─────────────────────────────┘
微服务
┌─────────┐ ┌─────────┐ ┌─────────┐
│ User │ │ Order │ │ Payment │
│ Service │ │ Service │ │ Service │
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
└────────────┼────────────┘
│
┌──────┴──────┐
│ Message Bus │
└─────────────┘
事件驱动
Producer → Event Bus → Consumer(s)
│
├→ Service A
├→ Service B
└→ Analytics
决策框架
权衡分析
| 方面 | 选项 A | 选项 B |
|---|---|---|
| 复杂度 | 低 | 高 |
| 可扩展性 | 有限 | 水平扩展 |
| 成本 | $ | $$$ |
| 上市时间 | 快 | 慢 |
| 维护 | 容易 | 复杂 |
ADR 模板
# ADR-001: [Decision Title]
## Status
Accepted | Proposed | Deprecated
## Context
[Why we need to make this decision]
## Decision
[What we decided]
## Consequences
### Positive
- [Benefit 1]
### Negative
- [Trade-off 1]
### Risks
- [Risk 1]
核心原则
- 关注点分离 - 每个组件承担一项职责
- 松耦合 - 尽量减少组件之间的依赖
- 高内聚 - 将相关功能组合在一起
- YAGNI - 不要为假设的需求构建功能
- 快速失败 - 立即检测并报告错误
可扩展性检查清单
- 无状态服务(会话存储在 Redis/DB 中)
- 支持水平扩展
- 数据库只读副本
- 缓存层(Redis、CDN)
- 对繁重任务进行异步处理
- 限流和熔断器
示例
输入:“设计一个通知系统” **操作:**定义渠道、队列架构、投递保证和扩展策略
输入:“我们应该使用微服务吗?” **操作:**分析团队规模、复杂度和扩展需求,并权衡利弊后给出建议
评论
支持 Markdown