generate-sdk-types

generate-sdk-types 技能為使用模型上下文協議 (MCP) 結合 Rust 後端與 TypeScript 客戶端的專案，提供一套穩健的自動化流程以維護型別一致性。它連接了 Rust ToolDefinition 結構體與 TypeScript 介面，有效消除手動同步的負擔並防止開發週期中的型別偏移。此技能專為維護跨語言 SDK 的開發者設計，特別是當後端工具架構頻繁變動時。透過從運作中的 Rust 服務自動擷取 JSON 架構並轉換為強型別的 TypeScript 定義，確保客戶端的工具執行與後端實作完美對齊。常見的使用案例包括在修改 MCP 工具、更新參數架構或進行協議變更後刷新 SDK 定義。此工具依賴 Pierre 伺服器環境與 Bun 執行時期來促進架構解析與檔案產生。它確保伺服器公開的每個工具皆已註冊於 SDK 的型別登錄檔中，使開發者能編寫型別安全的客戶端程式碼。主要功能包括自動型別同步、內建型別一致性驗證、完整的工具註冊生命週期支援，以及與 CI/CD git diff 分析的無縫整合。實際使用流程包含在修改 Rust 工具登錄檔後執行產生指令碼、驗證輸出是否符合既有架構，並將產生的型別提交至儲存庫。過程需啟動後端服務、透過 Node.js 或 Bun 執行產生邏輯、格式化產生的原始碼，並執行型別檢查測試以確保編譯成功。限制條件包含對 Pierre 生態系統的強制依賴、產生期間需有運作中的伺服器實例，以及必須嚴格遵守 SDK 的來源目錄結構。輸出結果為一組 TypeScript 介面與一個集中式的工具登錄常數，透過為所有可用工具提供自動完成與靜態型別驗證，簡化了客戶端開發流程。