kotlin-exposed-patterns

kotlin-exposed-patterns 概览

kotlin-exposed-patterns 是一份面向 Kotlin + JetBrains Exposed 的实用数据库访问指南。它最适合你在认真决定如何组织查询、事务、迁移和仓库边界时使用，而不是只想在 Kotlin 里临时写几条 SQL。

这个技能适合用来做什么

当你需要更清晰的 Exposed DSL 查询、DAO 风格实体访问、HikariCP 配置、Flyway 迁移或 repository 抽象实现路径时，使用 kotlin-exposed-patterns skill 就很合适。它尤其适用于 Database Engineering 场景，因为这类工作很看重 coroutine 安全的事务流转和可维护的数据访问结构。

它为什么有用

这里的价值不在于“Exposed 是什么”，而在于这些部分在生产环境里如何协同：什么时候该用 DSL，什么时候该用 DAO，newSuspendedTransaction 会怎样改变服务边界，以及如何让 schema 迁移和连接池配置保持一致。对希望减少数据层隐含假设的团队来说，kotlin-exposed-patterns 能让安装和选型更容易。

最适合与不适合的场景

这个 skill 很适合 Kotlin 后端服务、API 层，以及已经在使用或计划使用 Exposed 的数据密集型应用。它不太适合你去查通用 SQL 教程、与框架无关的 ORM 对比，或者数据库层之外的完整生产架构指南。

如何使用 kotlin-exposed-patterns skill

先安装并查看正确的文件

使用 npx skills add affaan-m/everything-claude-code --skill kotlin-exposed-patterns 安装。安装后，先阅读 skills/kotlin-exposed-patterns/SKILL.md，再顺着仓库里链接到的示例或文件引用继续看。由于这个 skill 不依赖额外的 rules/、resources/ 或脚本，主要学习路径就是 skill 本体，以及它指向的示例部分。

把你的目标转成可执行的提示

想让 kotlin-exposed-patterns usage 效果最好，就要给它一个具体目标，比如：“用 Exposed DSL、HikariCP、Flyway 和 coroutine transactions 实现一个用户与订单的 repository。” 记得说明数据库、你想用 DSL 还是 DAO、应用是否基于 coroutine，以及是否有 H2 测试、PostgreSQL 生产之类的约束。像“帮我搭 Exposed”这种模糊需求通常只会得到泛泛建议；越具体，越容易得到可落地的模式。

实际提问时该包含什么

一份高质量的 kotlin-exposed-patterns guide 请求，应该说明表结构、查询风格、事务模型和集成点。比如：“展示如何按 UUID 获取用户、为该表写 migration，并用 newSuspendedTransaction 把它封装在 repository interface 后面。” 这样 skill 才有足够上下文去推荐合适模式，而不是把 DSL、DAO 和基础设施问题混在一起。

按这个顺序阅读工作流

先看 “When to Use” 和 “How It Works”，判断 repository pattern 还是直接使用 Exposed 更适合你的代码库。然后查看 DSL 和 DAO 示例，匹配你偏好的风格。如果你是在为 Database Engineering 引入 kotlin-exposed-patterns，要特别关注连接池、迁移和测试数据库选择是如何与业务逻辑分离的。

kotlin-exposed-patterns skill 常见问题

kotlin-exposed-patterns 只适合 Exposed 新手吗？

不是。新手可以用它避免把 DSL、DAO 和事务混在一起，但更适合它的其实是那些希望在真实服务里形成可复用模式的工程师。如果你已经了解 Exposed，它仍然能帮你进一步收紧结构，减少临时拼凑的数据访问代码。

它和普通 prompt 有什么不同？

普通 prompt 可能只给你一个答案，而 kotlin-exposed-patterns 的目标是围绕 Exposed 使用、事务安全、迁移和 repository 边界，形成可重复的工作流。对于需要输出贴合既有代码库而不是通用示例的场景，这一点很重要。

什么时候不该用它？

如果你只需要原生 SQL、非 Kotlin 的持久层技术栈，或者与数据访问无关的架构决策，就可以跳过它。如果你的主要问题是领域建模，而不是数据库实现，它也不是最合适的选择。

它适合生产环境吗？

适合，前提是你的目标是让 Exposed 代码更易维护、更可预测。和生产最相关的部分包括 coroutine 安全事务、基于 HikariCP 的连接、版本化迁移，以及把 SQL 细节隔离在服务之外的 repository 层。

如何改进 kotlin-exposed-patterns skill

直接给出你的数据库具体形态

想让 kotlin-exposed-patterns install 的结果更好，关键是提前描述表、关系和查询需求。把主键、外键、JSON 列，以及是否需要分页、join 或 soft deletes 说清楚。schema 越具体，输出就越不容易滑向泛化的 Exposed 示例。

说明运行层面的约束

如果你在意 PostgreSQL、H2 测试一致性、coroutine 支持或启动时迁移，就明确说出来。这些信息会直接影响 skill 应该如何表述 HikariCP、newSuspendedTransaction 和 Flyway 的用法，也往往决定某种 pattern 是否适合落地。

一次只问一层

为了获得更好的 kotlin-exposed-patterns usage，可以先要 schema，再要 query 层，再要 repository 层，最后再要 tests。这样可以减少意外耦合，也更容易看出输出哪里过于抽象，或者默认了你并不具备的环境。

用真实代码迭代，而不只是看示例

拿到第一版答案后，把这个 pattern 和你当前的模块结构对照，再补充缺失信息：package 名称、service 方法、migration 命名、测试数据库选择等。如果感觉方案过于复杂，就要求一个更窄的版本，聚焦某一条 Exposed 路径，比如只做 DSL 读取或只做 DAO 写入。