code-quality

此技能作為 Turso 資料庫開發流程中嚴格的架構與風格把關者。它專注於資料庫工程中關鍵的正確性要求，並確保系統穩定性不被犧牲。本技能專為需要確保實作符合生產級資料庫標準的 Turso 儲存庫貢獻者而設計。它強調在資料庫核心中，遇到無效狀態時進行受控崩潰，遠比允許靜默的資料損毀要好得多。

• 強制執行嚴格的 Rust 模式，例如使非法狀態無法被表示、利用窮舉模式匹配，以及在關鍵路徑中避免堆疊記憶體分配。

• 透過頻繁的斷言、不變量檢查以及處理所有錯誤路徑來推廣防禦性程式設計，而不是掩蓋邊緣案例或使用快慢修補程式。

• 提供編寫 CPU 友好且具備快取意識的程式碼準則，在微秒級延遲至關重要的場景下，確保行程內 SQL 執行的最佳效能。

• 要求文件需解釋複雜邏輯背後的「原因」而非重複程式碼，並反對冗餘或時間性的註解。

• 防止過度工程，要求變更僅集中於所請求的功能，避免過早抽象化，並強制清理未使用程式碼或舊有駭客式寫法。

• 包含針對索引變更的特定警告，要求與 SQLite 內部排序行為進行嚴格對照，以防止資料不一致。

• 輸入通常是涉及 Turso 資料庫 Rust 模組的程式碼片段、提取請求 (PR) 或設計提案。

• 輸出包括程式碼審查、重構建議或技術指導，確保符合 Turso 對持久性與效能的核心原則。

• 永遠將資料完整性置於功能開發速度之上；假定在足夠長的時間內，每個邊緣案例錯誤都會發生。

• 使用適當的錯誤處理機制（如 Result 型別），並避免會靜默忽略意外分支的 if-else 鏈；對於不可能的邏輯狀態，優先使用顯式斷言或不可達巨集 (unreachable macro)。

• 保持實作專注：若變更未直接服務於需求或改進核心正確性，則不應包含在內。