database-driver-design

database-driver-design 技能總覽

這個技能是做什麼的

database-driver-design 技能能幫你設計可直接上線的 Swift 資料庫用戶端函式庫，而不只是能 demo 的原型。它特別適合後端開發團隊，用來打造建構在 SwiftNIO 與 Swift Concurrency 之上的 driver、wire-protocol client、連線池，以及串流查詢 API。

什麼情況最適合用

當你需要釐清 protocol state machine、連線生命週期設計、command typing、結果串流中的 backpressure，或 actor / event-loop 的對齊方式時，這個 database-driver-design 技能特別有用。如果你是在拿真實的 Swift driver 模式做設計比較，而不是只寫一個一次性的 wrapper，它會更對味。

它能幫你避免什麼

它的主要價值，是幫你減少那些事後很難收拾的架構錯誤：不安全的查詢組裝、漏水式的連線池行為、並行模型不一致，以及很容易被誤用的 command API。這是一份設計指南，所以它提升的是正確性與可維護性，而不是單純堆功能數量。

如何使用 database-driver-design 技能

安裝並開啟正確的入口

先依照你的 skill runner 使用 database-driver-design install 流程，接著從 SKILL.md 開始。這個 repo 裡沒有 rules/、resources/ 或 scripts/ 這些支援資料夾，所以這個技能是刻意做成自包含的。也就是說，你第一次閱讀時看到的內容，就是完整的決策面。

給這個技能一個具體的 driver 問題

database-driver-design usage 最有效的情境，是你把目標資料庫、傳輸層，以及正在處理的失敗模式講清楚。強而有力的輸入會像是：「設計一個使用 NIO、支援 pipelined queries、連線池與 streaming rows 的 text-based wire protocol Swift client」，或是「把這個臨時 query layer 重構成具型別 commands 與安全 bindings」。像「幫我處理 database driver」這種太寬的說法，通常不足以產生可落地的架構建議。

用明確標出限制條件的提示

好的 database-driver-design guide prompt 應該包含 protocol 風格、並行模型和 API 形狀。例如，你要明確說明是否需要 async/await、event-loop-first API、結果串流、TLS、prepared statements，或 command cancellation。這樣技能就能把重點放在真正重要的取捨上，而不是重講一遍通用 driver 概念。

先讀這幾個部分

先從總覽開始，再看 agent 行為合約，接著讀 command typing、interpolation、pooling 和 protocol state machines 這幾個核心模式。這些內容最直接影響安裝決策品質，也最影響最後實作的樣子。如果你是在評估 database-driver-design for Backend Development 是否適合，這是最快理解架構期待的路徑。

database-driver-design 技能 FAQ

這只適用於 Swift database driver 嗎？

是，最適合的情境是 Swift 與 SwiftNIO-based 的 client 設計。如果你是在其他語言寫 driver，這些觀念仍可能有幫助，但這個技能是以 Swift concurrency、event loops 與 type-safe command modeling 為最佳化目標。

它跟一般 prompt 有什麼不同？

有。一般 prompt 也能描述 database client，但 database-driver-design 提供的是更聚焦的設計語彙：typed commands、查詢綁定規則、狀態轉換、backpressure，以及 pooling discipline。這通常代表更少來回補充，也更少漏掉關鍵限制。

初學者可以用嗎？

可以，只要目標是帶結構地建立或檢視一個 driver。你不需要一開始就具備很深的 protocol 專業知識，但你需要提供情境：資料庫、傳輸方式、預期流量型態，以及 client 是同步、非同步還是以串流為主。

什麼情況不該用？

如果你只需要 ORM 用法、簡單 SQL 片段，或一個通用 repository layer，就先不要用。這個技能是給 driver 架構與整合細節用的，不是給應用層查詢撰寫用的。

如何改善 database-driver-design 技能

提供精確的營運模型

最好的結果，來自你明確說出 driver 要怎麼運作：一個 request 一條 connection、連線池、multiplexing，或 streaming cursors。也請包含預期負載、延遲目標，以及是否需要 cancellation 或 retries。這些細節會直接影響 database-driver-design 的建議方向。

先把最難的限制攤開來

如果你最大的風險是 protocol correctness、記憶體壓力、backpressure，或 actor/event-loop 不匹配，就先直接講。這個技能在能圍繞真實瓶頸做最佳化時最強，而不是試著一次解決所有問題。

一次只問一層

若想讓 database-driver-design usage 表現更好，建議把需求拆成設計階段：先是 API surface，再來是 connection lifecycle、query binding，最後才是 streaming 與 pooling。這樣比一口氣要求完整 driver 更容易產出乾淨結果；而且當你拿結果對照 SKILL.md 時，也更方便 review。

用真實範例反覆修正

第一輪回答後，回饋一個真實 command、一個連線失敗案例，或一段 sample response stream。這能讓技能去修正型別形狀、錯誤處理與狀態轉換，而不是停留在抽象層。對 database-driver-design install 的決策來說，這也是最快確認這個技能是否貼合你後端工作流程的方法。