n8n-syntax-trigger-nodes 是 n8n-claude-skill-package 中面向 n8n v1.x 触发器节点开发的技能包,目标是帮助开发者在构建自定义触发节点时避免不正确的生命周期实现。
用途 该技能用于指导创建自定义触发器节点,覆盖事件/定时器、轮询(polling)、Webhook 三种触发模式,帮助判断不同需求应选用哪种模式,并给出各模式的最小实现结构。
主要能力
- 模式选择决策树:外部服务调用你的端点时用 Webhook 模式;需要周期性检查 API 时用轮询模式;监听事件、按计划运行或流式数据时用事件/定时器模式。
- 关键规则提示:触发器节点必须设置 inputs: [],group 中必须包含 'trigger';触发数据必须双重数组包装 this.emit([[items]]);事件触发器需提供 manualTriggerFunction 以支持编辑器中的“Test Workflow”;分配资源时需实现 closeFunction 清理;轮询触发器必须实现去重。
- 事件/定时器模式:使用 trigger() 与 ITriggerFunctions,说明手动模式与生产模式的区分、setInterval 持久监听与 closeFunction 清理,以及通过 this.saveFailedExecution 记录非致命错误、this.emitError 处理致命错误。
- 轮询模式:使用 poll() 与 IPollFunctions,需设置 polling: true;无新数据时返回 null 而非空数组;使用 this.getWorkflowStaticData('node') 持久化上次时间戳/ID 以去重。
- Webhook 模式:使用 webhook() 与 IWebhookFunctions,说明 onReceived、lastNode、responseNode 三种响应模式,以及 getBodyData、getHeaderData、getQueryData、getParamsData、getRequestObject、getResponseObject、getNodeWebhookUrl 等方法。
- Webhook 生命周期:对需要在外部服务注册 Webhook 的触发器,提供 webhookMethods 的 checkExists、create、delete 流程说明。
- 节点描述要求:group: ['trigger']、inputs: []、outputs、polling、webhooks,以及可选的 eventTriggerDescription、activationMessage。
使用方式 该技能以参考文档形式组织,包括 references/methods.md(各接口与类型完整说明)、references/examples.md(定时、Webhook、轮询触发器的完整实现)、references/anti-patterns.md(常见错误与修复)。开发者可在编写自定义触发器节点时对照示例结构与规则实现。
适用场景 适用于为 n8n v1.x 开发自定义触发器节点、实现 Webhook 或轮询处理器、为外部服务注册 Webhook 生命周期,以及排查触发器不触发、重复处理、资源泄漏等问题。
限制 资料聚焦 n8n v1.x 触发器节点语法与生命周期,未提供安装命令、版本兼容范围、许可与收费信息,相关内容暂未提供。示例代码需结合 n8n 官方接口与项目实际情况使用。