Community编程与开发github.com

设计模式

选择、实现、重构和审查22种经典GoF设计模式。适用于需要经过验证的结构(对象创建、接口适配、组合、树结构、遍历、状态依赖、解耦、撤销、访问控制、内存压力)的设计问题,比较相似模式(如工厂方法与抽象工厂、策略与状态、装饰器与代理)时,替换条件语句、继承爆炸或混乱依赖时,以及审计代码库中缺失或过度应用的模式时。

设计模式 是什么?

本技能提供了一份全面且语言无关的GoF 23种设计模式指南,基于《深入设计模式》(Alexander Shvets, 2022)框架。它涵盖了三大核心任务:选择(根据问题症状推荐合适的模式)、实现/重构(在不破坏现有行为的前提下应用模式)以及审查/诊断(识别缺失或过度使用的结构)。技能通过症状-候选模式映射表、约束过滤器(如静态与动态变化、对象与家族)、成对对比决策矩阵和决策树等结构化工具,帮助开发者从实际问题症状出发,逐步缩小到最合适的模式。技能明确区分了何时不应使用模式(如一次性脚本、单纯追求“最佳实践”),并强调了7条基本规则,包括优先选择最小的可行结构、以领域命名角色而非模式名称、以及删除旧路径以避免技术债务。它支持多种集成方式,可以放在项目本地或全局的OpenCode或Claude技能目录中,无需额外配置。

兼容平台✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/libkluid/.skills/tree/main/skills/design-patterns

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

设计模式 是做什么的?

一份基于《深入设计模式》(Alexander Shvets, 2022)框架的 22 种 GoF 模式实用指南。涵盖三大任务:

  1. 选择 —— 将症状转化为候选列表,然后给出一个推荐。
  2. 实现/重构 —— 在不破坏行为的前提下应用模式。
  3. 审查/诊断 —— 发现缺失的结构,更常见的是发现过度应用的結構。

该模式目录刻意保持语言中立。将角色和步骤映射到当前代码库的习惯用法上;不要逐字翻译 Java。

移植性

此技能在目录级别是自包含的。仅复制 SKILL.md 文件就足够了。

  • 项目本地:<repo>/.opencode/skills/design-patterns/SKILL.md
  • 用户全局:~/.config/opencode/skills/design-patterns/SKILL.md
  • 兼容位置:<repo>/.claude/skills/ 或 ~/.agents/skills/ 下的相同结构
  • 技能 ID 是目录名 (design-patterns);前置元数据的 name 仅作为显示标签。

何时使用此技能

  • 一个更改反复波及到不相关的类,或者一个类为每个新情况不断增长分支。
  • 对象构造变成了一堆参数、标志或工厂。
  • 集成了一个与你接口不匹配的第三方或遗留 API。
  • 添加行为组合(压缩 + 加密 + 重试 + 日志记录)会导致子类层次结构爆炸。
  • 行为依赖于生命周期:草稿 → 审核 → 已发布,连接中 → 已连接 → 已关闭,待处理 → 已支付 → 已发货。
  • 一个更改必须通知一组未知或变化的消费者。
  • 操作、撤销、队列化工作或可重放操作需要变成对象。
  • 需要在树或对象图上添加遍历、导出或分析。
  • 内存压力来自许多几乎相同的对象。
  • 审查设计是否存在意大利面条式耦合或推测性抽象。

何时不使用此技能

  • 脚本、一次性迁移或原型,其中结构的成本超过其生命周期的价值。
  • 添加模式的唯一理由是“最佳实践”、一本书或一个 linter。
  • 你无法说出该结构旨在吸收的具体更改。
  • 语言直接提供了该行为(迭代器、事件、模式匹配、依赖注入、闭包)。
  • 团队无法维护这一层间接性。一个被理解了的简单设计胜过一个未被理解的正确模式。

基本规则

  1. 模式是一个涌现出來的结构名称,而不是目标。 推荐结构;仅使用模式名称来解释它。
  2. 应用模式前通过三项测试。 (a) 存在一个具体的力或症状,而非假设性的。 (b) 现在或计划中至少存在两种合理的变体。 (c) 增加的间接性在后续几次更改中能收回成本。
  3. 优先选择最小可行结构: 内联代码 → 函数 → 参数化函数 → 接口+一个实现 → 接口+多个实现 → 完整模式。
  4. 审查时,没有证据绝不添加模式。 引用能证明其合理性的重复、分支数量、依赖边或测量成本。
  5. 按领域命名角色,而不是按模式。 ShippingPolicy 优于 ShippingStrategy;DocumentPublisher 优于 DocumentObserverSubject,除非模式本身就是共享词汇。
  6. 删除旧路径。 如果不制定删除计划就应用模式作为第二条并行路径,这是在制造有额外步骤的技术债务。
  7. 模式可以组合。 大多数真实设计是一个模式内部包含另一个模式(Composite + Visitor,Command + Memento,Mediator + Observer)。首先选择主要力;让协作者跟随。

0. 首先建立上下文

在回答以下问题之前,不要推荐模式。当代码无法回答这些问题时,请询问。

  • 语言与范式。 继承密集型、基于接口的、函数式的还是混合的?它是否具有第一类函数、和类型、模式匹配、生成器、事件、DI?
  • 变化轴。 实际变化的是哪个维度:创建、算法、结构、通信、生命周期、存储还是传输?
  • 变体数量。 现在存在多少种实现?计划了多少种?(“现在一种,下个季度一种”是合理的答案。)
  • 生命周期与所有权。 谁创建、拥有、缓存和销毁对象?是否有组合根或 DI 容器?
  • 并发性。 实例是否在多个线程间共享?通知是同步的吗?命令是否排队?
  • 持久性与分布。 对象或事件是否需要序列化、版本控制、重试或通过网络发送?
  • 性能预算。 是否测量并限制了内存、延迟或分配率?
  • 测试策略。 是否可以在没有真实数据库、时钟、文件系统或网络的情况下测试设计?
  • 团队惯例。 代码库是否已经使用了模式词汇、框架扩展点或架构边界?

记录下答案。没有这个上下文的推荐只是猜测。


1. 选择模式

1.1 症状 → 候选

症状首选候选考虑替代方案
new 分散在业务逻辑中;类型由配置选择工厂方法DI 容器、简单工厂函数
几个相关产品必须匹配(相同主题、驱动程序、供应商)抽象工厂每个产品使用工厂方法、参数化工厂
构造函数有许多可选参数或标志参数构建器命名/可选参数、记录+验证
复制对象需要知道其具体类或私有字段原型拷贝构造函数、序列化往返
一个共享资源需要恰好一个实例和全局访问单例容器范围的单例、模块级实例、显式注入
第三方/遗留接口不匹配适配器更改你的接口、防腐层
两个独立的维度使子类数量倍增(形状 × 颜色、设备 × 操作系统)桥接拆分为两个参数、组合
部分-整体树必须被统一处理组合基于数据模型的普通递归函数
行为组合使子类爆炸(通过邮件+短信+Slack通知)装饰器标志、中间件链、策略列表
客户端淹没在多类子系统中外观窄化模块 API、服务层
数百万个相似对象耗尽内存享元内部共享、结构体数组、惰性数据
访问、懒加载、缓存或远程调用必须透明代理显式缓存层、存储库、客户端包装器
一个请求可以由几个未知顺序的处理程序中的任何一个处理责任链中间件管道、有序函数列表
动作必须排队、重试、记录、撤消或参数化命令闭包、作业队列负载、事件溯源
遍历必须统一且独立于表示迭代器语言迭代器/生成器
许多组件与许多组件通信;可重用的组件无法实现中介者事件总线、应用服务、观察者
撤消/回滚必须恢复状态而不暴露内部细节备忘录事件日志、数据库事务、写时复制快照
一个更改必须通知一组动态变化的消费者观察者消息代理、响应式流、信号
大的 switch 作用于状态;转换分散在各处状态状态机库、转换表、和类型
多个算法用于一项任务;在运行时/配置时选择策略函数参数、表查找、多态
相同的算法骨架,少数步骤变化模板方法策略/组合、高阶函数、钩子
许多不相关的操作作用于一个稳定的对象结构访问者模式匹配、外部函数、序列化器
对树进行聚合操作组合 + 访问者递归折叠、查询 API

1.2 约束过滤器

在应用决胜规则之前先应用这些。它们比任何模式比较都能淘汰更多错误答案。

  • 静态与动态变化。 策略、状态、桥接和代理允许运行时替换。模板方法和基于继承的工厂方法在编译时固定行为。
  • 一个对象 vs. 一个家族。 工厂方法创建一个产品;抽象工厂创建一个兼容的家族;构建器逐步组装一个复杂产品。
  • 包装 vs. 替换 vs. 简化。 装饰器保持接口并添加行为;代理保持接口并控制访问;适配器更改接口;外观在多个对象之上定义一个新的、更简单的接口。
  • 推送 vs. 拉取 vs. 路由。 观察者广播给所有订阅者;中介者通过一个协调者路由交互;责任链传递请求直到有人处理。
  • 状态 vs. 算法。 状态对象相互了解并触发转换;策略对象是独立的并由客户端选择。
  • 结构 vs. 操作。 组合组织对象;访问者在该组织之上添加操作;迭代器提供遍历。
  • 内存 vs. CPU。 享元用 CPU 和复杂性换取 RAM;代理缓存用新鲜度和延迟换取重复工作。
  • 进程边界。 远程代理、命令序列化和跨进程观察者添加了进程内模式所没有的故障模式(重试、排序、幂等性)。

1.3 正面交锋决胜规则

对比对选择前者,当选择后者,当
工厂方法 / 抽象工厂一种产品类型;子类或配置选择具体类几个相关产品必须被创建并保持兼容
抽象工厂 / 构建器产品作为家族立即返回一个复杂产品逐步组装并在最后返回
工厂方法 / 构建器变化在于创建哪个类变化在于如何配置一个复杂对象
构建器 / 原型构造必须逐步验证已经存在一个完全配置的对象并且应该被复制
适配器 / 桥接事后改造不兼容的代码预先设计两个独立的层次结构
适配器 / 外观一个接口必须被转换为另一个许多子系统调用必须合并到一个简单的 API 中
装饰器 / 代理在运行时添加或删除职责;客户端组合包装器控制访问、生命周期、缓存或远程性;代理管理服务
装饰器 / 责任链每个包装器都运行并添加行为处理程序可能停止链
组合 / 装饰器目标是具有统一叶子/容器操作的树目标是在节点上添加额外职责,而非聚合
外观 / 中介者单向简化;子系统不知道外观双向协调;同事知道并调用中介者
中介者 / 观察者中央协调逻辑和星形拓扑一对多广播,没有中央策略
策略 / 状态算法是独立的;客户端切换状态触发它们自己的转换并且相互依赖
策略 / 命令问题是如何执行一个任务问题是执行、存储或撤消什么请求
策略 / 模板方法行为在运行时通过组合在每个对象上变化行为在编译时通过继承在每个子类上变化
责任链 / 观察者恰好一个处理程序应该行动所有订阅者都应该被通知
备忘录 / 命令需求是状态恢复需求是请求封装、排队或重放
备忘录 / 原型必须保持封装并且需要历史记录简单对象的简单副本就足够了
迭代器 / 访问者需求是遍历顺序和访问需求是跨许多元素类型的操作
访问者 / 策略在稳定的元素层次结构上进行许多操作在上下文之上进行一个可互换的算法
享元 / 单例许多按状态键控的不可变共享实例整个进程正好有一个可变实例
组合 / 享元层次结构和统一操作很重要共享叶子状态是内存问题

1.4 决策树

主要驱动力是什么?
├─ 创建对象
│  ├─ 哪个具体类由子类/配置选择?                                 → 工厂方法
│  ├─ 几个相关产品必须匹配?                                      → 抽象工厂
│  ├─ 一个复杂对象,许多可选部分或步骤?                          → 构建器
│  └─ 复制一个已有的已配置对象?                                  → 原型
│     └─ 真的需要一个共享实例?                                  → 单例(最后的手段)
├─ 调整或组织结构
│  ├─ 来自你控制之外的接口不兼容?                               → 适配器
│  ├─ 两个独立的维度使子类数量倍增?                              → 桥接
│  ├─ 具有统一操作的部分-整体树?                                → 组合
│  ├─ 在运行时以组合方式添加/删除行为?                           → 装饰器
│  ├─ 为客户端简化复杂的子系统?                                → 外观
│  ├─ 内存中太多几乎相同的对象?                                → 享元
│  └─ 控制访问、生命周期、缓存或远程性?                          → 代理
└─ 行为和通信
   ├─ 多个处理程序之一,顺序未知?                                → 责任链
   ├─ 请求必须是对象:排队、重试、撤消、重放?                     → 命令
   ├─ 遍历而不暴露表示?                                        → 迭代器
   ├─ 多对多通信需要一个协调者?                                  → 中介者
   ├─ 恢复先前状态而不破坏封装?                                 → 备忘录
   ├─ 通知一组动态的订阅者?                                    → 观察者
   ├─ 行为随生命周期状态变化?                                   → 状态

…

[为翻译而截断]

相关技能