mastra

Mastra 技能旨在協助開發者使用 Mastra 框架構建 AI 應用程式，並作為權威的技術參考資源。為了降低使用過時訓練資料的風險，本技能嚴格執行「驗證優先」的方法，確保所有程式碼產出均基於本地環境中安裝的 Mastra 版本。它專為軟體工程師、AI 架構師及需要將基於 LLM 的代理、複雜工作流程、RAG 系統與記憶體模組整合至 TypeScript 生態系統中的開發人員所設計。透過提供依賴項檢查、內建文件導覽與遠端 API 同步等整合工具，此技能可作為 Mastra 專案開發的控制中心，涵蓋專案架構規劃、常見型別錯誤排除及框架版本遷移。

• 使用本地 node_modules 檢索功能進行即時文件驗證，確保程式碼與當前安裝版本相容。

• 提供建構自主代理 (Agents)、流程導向工作流程 (Workflows) 及工具整合的結構化指南。

• 針對 TypeScript 設定（ES2022/Module 要求）與執行時期錯誤提供進階除錯支援。

• 透過標準化註冊指令碼，管理各提供者的 LLM 模型路由設定。

• 支援 Mastra Studio 環境安裝，實現互動式測試與效能監控。

• 提供版本遷移協助，管理核心元件的重大變更與升級。

• 在產生程式碼前，務必執行本地搜尋指令，以避免對建構子特徵產生錯誤認知。

• 在實作模型路由字串前，使用提供的供應商註冊指令碼驗證可用模型。

• 請確保 TSConfig 配置符合指定的 ES2022 模組解析設定，以防止匯入或模組失敗。

• 對於 API 表層與型別定義，應優先參考內建文件而非外部知識庫。

• 輸入：使用者對於代理行為、工作流程邏輯或 RAG 架構的需求。輸出：針對當前 Mastra 版本優化的驗證程式碼片段、架構模式與故障排除步驟。