用途:该技能面向 Trigger.dev 开发者,用于编写、设计和优化生产级后台任务与工作流,包括可靠的异步任务等。任务部署在 Node.js 21+ 环境,使用 @trigger.dev/sdk 包。
主要能力:支持基础任务(task)、带 Zod 校验的 schemaTask;支持从后端或任务内部触发任务;提供 triggerAndWait、batchTriggerAndWait 与 wait.* 等待能力;支持重试配置(maxAttempts、factor、minTimeoutInMs、maxTimeoutInMs)、幂等键(idempotencyKeys)、延迟与 TTL、队列、机器规格、标签、防抖(debounce)与批量触发。机器规格含 micro、small-1x/2x、medium-1x/2x、large-1x/2x。批量最多 1000 项、单批 3MB。
关键规则:始终使用 @trigger.dev/sdk,不使用 @trigger.dev/sdk/v3 或已弃用的 client.defineJob;不要使用 node-fetch,改用内置 fetch;所有任务(含子任务)都必须导出;不要把 wait/trigger 调用包进 Promise.all 或 Promise.allSettled。从任务内部触发时建议使用幂等键。
使用方式:以 task({ id, retry, run }) 定义任务;用 schemaTask 结合 zod 校验并推断 payload 类型;后端触发时可用 import type 避免依赖泄漏;任务内触发用 childTask.triggerAndWait 并检查 result.ok 或 .unwrap()。触发选项含 delay、ttl、idempotencyKey、queue、machine、maxAttempts、tags(最多 10 个)、debounce 等。
适用场景:用户活动更新、Webhook 去重、搜索索引、通知批处理,以及需要重试、幂等、并发与调度控制的异步工作流。
限制:资料未提供收费与价格信息;部分专题细节需参考 basic-tasks.md、advanced-tasks.md、scheduled-tasks.md、realtime.md、config.md 等文档,此处暂未展开。