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），以防止开发工作空间与生产环境任务状态之间的交叉污染。