trigger-dev-tasks

Trigger.dev Task Expert 是一款專為開發高可靠性、長時間執行後端工作流的開發者所設計的進階程式與架構助手。它提供關於使用 @trigger.dev/sdk 實作任務系統的精確指導，確保您的背景任務具備高擴展性、可觀測性與生產就緒品質。無論您是開發需要鏈式呼叫、狀態管理或人機驗證流程的複雜 AI 代理，此技能都能確保您遵循關於可靠性與效能的最佳實踐。

• 完整支援使用 task 與 schemaTask 定義任務，並透過 Zod 驗證來確保執行時期的型別安全。

• 進階協調能力，包含 triggerAndWait、batchTriggerAndWait 與無依賴的子任務管理。

• 精確控制任務執行，包括冪等鍵 (idempotency keys)、自訂重試、指數退避 (exponential backoff) 與併發速率限制。

• 針對建置時期擴充功能的整合專業知識，例如用於瀏覽器自動化與媒體處理的 FFmpeg、Puppeteer 與 Playwright。

• 機器規格預設值 (micro 至 large)、Cron 定時排程與使用防抖動 (debouncing) 進行 Webhook 去重的設定指導。

• 優先使用原生的 fetch API 而非 node-fetch，以確保執行環境的相容性。

• 避免將 wait 與 trigger 呼叫包裹在 Promise.all 中，以防止任務檢查點 (checkpoint) 執行期間發生錯誤。

• 針對所有具備副作用的操作使用冪等鍵，以保證重試時的正確性。

• 利用 logger.info 與 logger.error 在 Trigger.dev 儀表板中取得完整的觀測數據。

• 將相關邏輯歸納為非導出的子任務，以維持乾淨且模組化的程式碼庫結構。

• 參考提供的架構指南，以了解處理長時間執行、非終止工作流與人機驗證機制 (waitpoints) 的最佳做法。