migrate-oai-app

此技能為希望將舊版 OpenAI Apps SDK 應用程式遷移至 Model Context Protocol (MCP) Apps SDK (@modelcontextprotocol/ext-apps) 的開發人員提供自動化且具指導性的路徑。它專為需要將專有的 window.openai 模式轉移至 MCP 所提供之標準化、開放且互動式 UI 協定的工程師與平台開發人員而設計。此技能充當遷移架構師的角色，確保先前綁定於 OpenAI 運行環境的邏輯能正確重構以適應 MCP 生命週期。

• 提供將 OpenAI Apps 轉換為符合 MCP 標準的伺服器與 UI 的分步遷移指導。

• 提供全面的 API 映射表，協助將舊版 window.openai 呼叫替換為現代化的應用程式實例與處理常式。

• 提供使用 registerAppTool 與 registerAppResource 輔助工具來現代化伺服器端邏輯的基礎架構指導。

• 提供內容安全策略 (CSP) 審核的自動化工作流程，以便在部署前識別必要的資源、連線與框架網域。

• 支援包括 React、Vue、Svelte、Preact 與 Solid 在內的主要前端框架整合。

• 提供管理應用程式狀態與主機環境內容的最佳實作，無需依賴全域 window 物件。

• 首先使用提供的 git 指令複製當前的 SDK 儲存庫，確保擁有最新的參考文件與範例伺服器模板。

• 請參閱位於 /tmp/mcp-ext-apps/docs/migrate_from_openai_apps.md 的遷移參考指南，以獲取精確的程式碼庫映射對照。

• 請務必優先使用套件管理程式來安裝依賴項目，以確保版本相容性，而非手動硬編碼版本號。

• 透過追蹤現有建置版本中的所有網路來源，將其歸類為資源、連線與框架網域，藉此執行詳盡的 CSP 調查。

• 在連線之前實作事件處理常式 (ontoolinput, ontoolresult)，以確保與主機環境進行可靠的通訊。

• 請注意，某些 OpenAI 特有功能（如 widgetState 或直接檔案上傳）在 MCP 中沒有直接的對應項目，需要改用伺服器端狀態管理模式。

• 在完成遷移工作之前，請務必完成「完成前檢查清單 (Before Finishing checklist)」，確保您的應用程式符合現代 MCP 主機所需的安全與效能標準。