temporal

此技能作為將舊版 Netflix Conductor 基於 JSON 的工作流遷移至現代、型別安全的 Temporal Python 專案的專用助理。它專為從宣告式 Conductor DSL 轉換為使用 Temporal Python SDK 的程式碼優先編排的工程師所設計。代理程式自動化了從分析 Conductor 任務原語到生成健壯、生產級專案結構（包含活動、工作流定義與啟動指令碼）的全生命週期。

除了遷移之外，該技能還提供了一套完整的工具來處理 Temporal 開發生命週期。它透過 temporal server start-dev 處理本地伺服器編排，管理 Worker 程序生命週期，並提供對工作流執行狀況的深度觀察能力。使用者可以直接從開發環境中監控 Worker 健康狀況、檢查工作流任務歷史，並排查非確定性錯誤或卡住的活動。

• 自動化遷移管線：解析 Conductor JSON 定義以生成地道的 Temporal Python 程式碼，包含型別安全的活動與工作流邏輯。

• 本地伺服器管理：透過確保 Temporal 伺服器連線與清理工作空間的指令碼來簡化開發流程。

• Worker 生命周期控制：智慧管理後台 Worker 程序，確保在驗證週期中舊的 Worker 被終止並部署新的執行個體。

• 可觀察性與疑難排解：內建工具用於列出 Worker、追蹤日誌、檢查工作流狀態，以及解析錯誤歷史，以區分任務卡頓與活動失敗。

• 專案支架：生成包含 uv 配置、文件與標準化啟動指令碼的完整專案結構，以確保部署的一致性。

• 目標客群：負責遷移複雜狀態微服務或工作流驅動應用程式的後端與平台工程師。

• 操作限制：需要 Python 3.11+ 與 uv 套件管理工具；主要針對本地開發 (gRPC 連接埠 7233) 與單一遷移任務設計。

• 工作流監控：對於識別工作流任務卡頓與活動重試之間的差異至關重要；務必擷取來自啟動輸出的 Workflow ID 以進行精確追蹤。

• 清理機制：使用專用的指令碼 (如 kill-worker.sh) 來防止在管理多個本地 Worker 程序時產生資源洩漏。

• 整合：主要作為 Claude Code 環境中的插件運作，協助在遷移過程中進行迭代重構與自動化錯誤修正。