trigger-setup

trigger-setup 技能提供了將 Trigger.dev 持久化執行平台整合至任何 Node.js 或 Bun 專案所需的基本設定與初始化流程。這是開發者從簡單腳本執行邁向可靠、可重試且可觀測的後台處理的必經起點。此技能引導您完成整個入門生命週期，從安裝 @trigger.dev/sdk 到定義專案結構，以及透過 trigger.config.ts 建立環境連接。它專為希望管理長時間執行任務，同時無需負擔基礎設施維護、排隊系統或複雜重試邏輯的工程師所設計。

• 使用 npx trigger init 進行快速安裝與 CLI 導向的專案初始化。

• 專案全域設定配置，包含任務目錄管理與專案 ID 映射。

• 透過 TRIGGER_SECRET_KEY 為本地、開發與生產環境進行環境變數同步與管理。

• 於程式碼庫內定義任務結構，確保正確的匯出模式與唯一的任務 ID 管理。

• 整合專案架構模式，支援預設配置及複雜的 monorepo 專案佈局。

• 驗證先決條件，包含對 Node.js 18+ 與 Bun 的支援，以及與雲端帳戶的連接。

• 請確保您的任務正確地從 trigger.config.ts 設定的目錄中的檔案匯出。

• 在部署至 Trigger.dev 雲端平台前，請務必使用 npx trigger dev 指令進行本地迭代。

• 維持一致的任務 ID 以避免部署衝突與註冊錯誤。

• 若需進行複雜的任務編排、任務重試或 AI 代理功能，請在基礎環境建立後，搭配 trigger-tasks 與 trigger-agents 技能使用。

• 請定期檢查您的 TRIGGER_SECRET_KEY 是否對應至正確的環境（dev、stg 或 prod），以防止開發工作空間與生產環境任務狀態之間的交叉污染。