database-driver-design

database-driver-design 概览

这个 skill 是做什么的

database-driver-design skill 旨在帮助你设计可用于生产环境的 Swift 数据库客户端库，而不是只适合演示的原型。它面向 Backend Development 团队，适用于围绕 SwiftNIO 和 Swift Concurrency 构建驱动、wire-protocol 客户端、连接池层以及流式查询 API 的场景。

什么时候最适合用

当你需要关于协议状态机、连接生命周期设计、命令类型系统、结果流中的 backpressure，或 actor/event-loop 对齐的指导时，适合使用这个 database-driver-design skill。尤其是在你想把设计选择放到真实 Swift driver 模式里比较，而不是临时写一个一次性封装时，它会更有帮助。

它能帮你避免什么

它的核心价值，是减少那种后期很难收拾的架构错误：不安全的查询构造、容易泄漏的连接池行为、并发模型不匹配，以及很容易被误用的命令 API。因为这是一个设计指南，所以它更强调正确性和可维护性，而不是单纯追求功能数量。

如何使用 database-driver-design skill

安装并打开正确的入口

先按你的 skill runner 走 database-driver-design install 流程，然后从 SKILL.md 开始。这个 repo 里没有配套的 rules/、resources/ 或 scripts/ 文件夹，所以这个 skill 是刻意做成自包含的。也就是说，你第一次阅读的内容就是全部决策面。

给 skill 一个具体的驱动问题

当你用 database-driver-design usage 时，最好明确描述目标数据库、传输层和你要解决的故障模式。好的输入像是：“为一个基于 NIO 的文本 wire protocol 设计 Swift 客户端，支持流水线查询、连接池和流式行读取”，或者“把这个临时查询层重构成带安全绑定的类型化命令”。像“帮我处理数据库驱动”这种输入太泛，通常不会产出可落地的架构建议。

用包含约束的 prompt

一个好的 database-driver-design guide prompt 应该写清协议风格、并发模型和 API 形态。比如说明你需要 async/await、以 event-loop 为先的 API、结果流式输出、TLS、prepared statements，还是命令取消能力。这样这个 skill 才能聚焦在真正重要的取舍上，而不是泛泛解释驱动概念。

先读这些部分

先看概览，然后看 agent behavior contract，再看围绕命令类型系统、插值、连接池和协议状态机的核心模式。这些部分最影响 database-driver-design 的安装决策质量和实现形态。如果你是在评估 database-driver-design for Backend Development 是否适合，这就是最快理解架构预期的路径。

database-driver-design skill 常见问题

这个只适用于 Swift 数据库驱动吗？

是的，最匹配的场景是 Swift 和基于 SwiftNIO 的客户端设计。如果你是在别的语言里写驱动，这些思路也可能有帮助，但这个 skill 的优化目标是 Swift Concurrency、event loop 和类型安全的命令建模。

它和普通 prompt 有什么不同？

有区别。普通 prompt 也能描述数据库客户端，但 database-driver-design 提供的是一套更聚焦的设计词汇：类型化命令、查询绑定规则、状态迁移、backpressure，以及连接池纪律。通常这意味着更少来回确认，也更少遗漏关键约束。

新手能用吗？

可以，只要目标是搭建或审查一个有一定结构的驱动。你不需要一开始就很懂协议细节，但你需要提供上下文：数据库、传输方式、预期流量模式，以及客户端是同步、异步还是基于流的。

什么时候不该用它？

如果你只需要 ORM 用法、简单 SQL 片段，或者一个通用 repository 层，那就不必用它。这个 skill 面向的是驱动架构和集成细节，不是应用层的查询编写。

如何改进 database-driver-design skill

提供准确的运行模型

最好的结果来自对驱动运行方式的明确说明：每个请求一个连接、连接池、multiplexing，还是流式游标。也要包含预期负载、延迟目标，以及是否需要取消或重试。这些细节会直接影响 database-driver-design 的建议。

尽早说明最难的约束

如果你最大的风险是协议正确性、内存压力、backpressure，或者 actor/event-loop 不匹配，就一开始说清楚。这个 skill 最强的用法，是围绕真实瓶颈做优化，而不是试图一次性解决所有问题。

一次只问一层

想把 database-driver-design usage 用得更好，建议把请求拆成几个设计阶段：API 表面、连接生命周期、查询绑定，然后是流式处理和连接池。这样比一次性要求完整驱动会得到更干净的输出；而且当你拿结果去对照 SKILL.md 时，也更容易审查。

用真实例子反复迭代

第一次回答之后，补充一个真实命令、一个连接失败场景，或者一段示例响应流。这样 skill 就能细化类型形状、错误处理和状态迁移，而不是停留在抽象层。对于 database-driver-design install 的决策来说，这也是最快确认它是否符合你的 backend 工作流的方法。