SuperAPI AI 工具集

trigger-authoring-tasks

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:面向使用 @trigger.dev/sdk 编写后端 Trigger.dev 任务的开发者,提供与已安装 SDK 版本一致的写作参考。

主要能力与内容:任务定义(task()、schemaTask())、run 函数与 ctx、重试、等待、触发与 Result 形态、幂等、metadata、定时任务、队列与并发、trigger.config.ts。完整指南随 SDK 安装,位于 node_modules/@trigger.dev/sdk/skills/trigger-authoring-tasks/SKILL.md;完整文档位于 node_modules/@trigger.dev/sdk/docs/,可按 API 检索,例如 grep -rl "schemaTask" node_modules/@trigger.dev/sdk/docs/。

用法要点:始终从 @trigger.dev/sdk 导入,不要用已弃用的 @trigger.dev/sdk/v3 或 @trigger.dev/core。若路径不存在需先安装 SDK;非扁平布局可用 node -p "require.resolve('@trigger.dev/sdk/package.json')" 定位。

常见错误:triggerAndWait、wait.forToken 返回 Result 而非原始输出,应判断 r.ok 后取 r.output(或用 .unwrap());不要用 Promise.all 包裹 triggerAndWait/batchTriggerAndWait/wait,应使用 batchTriggerAndWait 或顺序循环;后端代码应导入类型并配合 tasks.trigger 触发,而非直接导入任务实例;metadata.set/get 只能在 run() 或任务生命周期钩子内调用;子任务不继承父队列或 metadata,需显式传入;native/WASM 包应加入 trigger.config.ts 的 build.external;全局幂等键需用 idempotencyKeys.create 并指定 scope: "global"。

适用场景与限制:适合编写与调试 Trigger.dev 后端任务;内容为写作参考,具体安装与运行细节以实际 SDK 版本为准,资料未提供其他平台或定价信息。