用途
kp-identify 用于诊断某个具体问题适合哪种 Kotlin 特有模式,或在没有适用的 Kotlin 特有模式时,将问题路由到 GoF 模式、语言特性或更简单的替代方案。
适用场景:
- 用户有设计问题,不确定该用哪种 Kotlin 惯用法或模式。
- 混淆相似的 Kotlin 原语(launch 与 async、Flow 与 SharedFlow、sealed class 与 enum)。
- 代码审查中想知道“这个问题有没有 Kotlin 惯用的模式”。
不适用场景:
- 用户已经知道模式 → 直接前往对应技能(例如 kp-coroutine-scope)。
- 问题是经典 GoF 设计问题 → 路由到 gof-identify。
- 问题是领域建模 → 路由到 ddd-design。
主要能力
按以下顺序用诊断问题引导问题定位:
-
是否是封闭的变体集合,且需要编译器强制穷尽性?是 → kp-sealed-when。示例:状态类型、结果类型、命令类型、表达式树、AST 节点。
-
是否与并发有关?
- 想并发执行工作 / 脱离主线程 → 先看 kp-coroutine-scope(生命周期归属),再看 kp-launch-vs-async(用哪个原语),再看 kp-dispatchers(用哪个线程池)。
- 有多个并发操作,需要处理其取消 / 失败 → kp-structured-concurrency。
- 需要协程通过传递消息来协调(pipeline、fan-out、fan-in)→ kp-channels。
- 需要等待多个挂起源中最先就绪的那个(channels、deferreds、timeouts)→ kp-select。
- 想把可变状态限制在单个协程内,通过消息修改 → kp-actor-pattern。
- 把基于回调的 API 包装成 suspend fun(一次性)→ kp-callback-bridging。
- 为协程代码写测试(需要虚拟时间、确定性调度)→ kp-testing-coroutines。
- 是否与随时间产生的值流有关?
- 最新值重要、可观察状态 → StateFlow(见 kp-flow-cold-vs-hot)。
- 事件、无必需当前值、可能带缓冲 → SharedFlow(见 kp-flow-cold-vs-hot)。
- 冷拉取式流、每个收集者重新运行 → Flow(见 kp-flow-cold-vs-hot)。
- 转换 / 组合 / 防抖流 → kp-flow-operators。
- 多次回调发出事件 → kp-callback-bridging(callbackFlow)。
- 是否是配置 / 构造问题,写成配方更易读?
- 类型安全 DSL(HTML、Gradle 配置、builder API)→ kp-type-safe-builders。
- 只是一个带很多参数的对象 → 使用命名参数 + 默认值;不是 DSL。
- 需要经典 Builder(分阶段构造、类型状态)→ gof-builder。
- 是否与可变行为有关?
- 算法在运行时变化 → gof-strategy(Kotlin 中的函数类型)。
- 行为随对象状态变化 → gof-state(Kotlin 中的 sealed class — 见 kp-sealed-when)。
- 在不修改层级结构的情况下为其添加操作 → gof-visitor(Kotlin 中的 sealed + when)。
- 代码是否有 Kotlin 特有的坏味道?
- 过多 !!、滥用 lateinit、作用域函数使用不当、生产环境使用 runBlocking、到处 GlobalScope → 通过 kp-anti-patterns 审查。
- 高阶函数 / 函数作为一等值?
- 将函数作为参数传递或返回 → kp-higher-order-functions。
- 以上都不是?
- 问题可能不需要 Kotlin 特有模式。最常见的是:普通函数、data class、顶层常量,或 GoF 模式(路由到 gof-identify)。
使用方式
该技能以诊断问答的形式使用:依次回答上述问题,根据答案路由到对应的 kp-* 模式技能、GoF 模式技能或领域建模技能。
决策启发式
- 始终优先选择解决问题的最简单构造。协程和 Flow 很强大,但有学习成本——当并发或流确实是问题时才使用它们。
- 当“变体已知且有限”时,sealed class 往往是最干净的答案。
- 对于同一进程内两部分之间的事件式耦合,在 2026 年的 Kotlin 中,SharedFlow 十有八九是正确选择。
反模式
- 单个挂起函数就能解决时却使用协程。
- List 或 Sequence 就能解决时却使用 Flow。
- 命名参数 + 默认值就足够时却构建 DSL。
- 对并非真正封闭变体集合的东西使用 sealed class。
相关技能
- 本插件中全部十个 kp-* 模式技能。
- gof-identify — 用于经典 GoF 问题。
- ddd-design — 用于领域建模问题。
参考资料
- Kotlin Design Patterns and Best Practices(Alexey Soshin)— 本技能所路由到的 Kotlin 特有模式的主要来源。
- Kotlin 官方文档中关于协程、Flow、sealed classes、类型安全构建器的内容。