开发与工程 n8njavascriptworkflow-automationcode-nodeapi-integrationdata-transformation

n8n JavaScript 代码节点助手

帮助你在 n8n Code 节点中编写可靠、高效的 JavaScript。

FollowSkills 评估 · FSRS-2.0
不推荐
47/ 100 五分制 2.4 / 5
信任安全11 / 25 · 2.2/5

文档明确限制认证辅助函数、环境变量和 require(),并建议使用凭据化 HTTP Request 节点,体现了一定的最小权限和数据流意识;但仍提供任意 HTTP 请求、手工传递令牌、DELETE 和持久化静态数据示例,没有用户确认、敏感数据脱敏、外部影响提示或回滚方案,且发布者身份未验证,因此扣分。

可靠稳定9 / 20 · 2.3/5

内容覆盖模式选择、返回格式、常见错误、异常输入和沙箱限制,快乐路径较完整;但存在节点引用语法前后不一致、部分示例假定输入结构、空输入和错误处理覆盖不完整等问题,且静态审查无法复现关键路径,因此按静态上限保守扣分。

适用触发11 / 15 · 3.7/5

目标受众、Code 节点场景、Custom Code Tool 的排除条件以及与原生节点的替代关系描述清楚;但触发范围过宽,许多版本和实例配置依赖未形成明确边界,没有中文使用支持证据,也未充分说明不同 n8n 版本的适用性,因此扣分。

规范维护8 / 15 · 2.7/5

文档有快速开始、分层主题、相关文件、检查清单、模式示例和限制说明,许可证元数据为 MIT;但缺少明确维护责任人、版本策略、变更日志、更新路径和可验证来源,且部分引用文件在给定材料中不完整,因此扣分。

有效结果5 / 15 · 1.7/5

提供大量可直接改写的 JavaScript、数据访问、性能和错误模式,能够覆盖常见 Code 节点任务;但多个示例依赖未声明输入、存在潜在运行语义问题,且没有静态可核验的真实输出或测试证据,故仅部分认可其可用性。

证据核验3 / 10 · 1.5/5

材料包含具体代码、错误信息、配置名和版本相关断言,具有一定审计价值;但“production-tested”“measured”等关键说法没有提交的测试套件、CI 覆盖或第三方交叉证据,静态审查也无法独立复现,因此低分。

证据充分度: 评估于 2026年7月20日 审查版本 05eea4848c12
使用前请注意
  • 不要将示例中的任意 HTTP 请求、手工 Authorization 令牌、DELETE 或 $getWorkflowStaticData 直接用于生产;先确认数据流、凭据范围、外部副作用和恢复方案。
  • 部分 n8n 版本、任务运行器和实例环境变量会改变可用 API;执行前应在目标实例验证 helper、返回形状、节点引用和 allowlist 配置。
  • 文档含有前后不一致或假定输入结构的示例,不能把“production-tested”和性能数字视为已由本次评估验证。
评估证据 [1][2][3][4][5]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

该技能专门指导 n8n Code 节点中的 JavaScript 编写、数据访问、转换和错误排查。它涵盖 All Items 与 Each Item 两种执行模式、Webhook 数据结构、返回格式、HTTP 请求、日期处理和 JMESPath 查询。内容还包括批处理循环、跨迭代数据、pairedItem 以及常见生产环境问题。它适合需要在 n8n 中实现复杂逻辑的用户,但简单字段映射、基础筛选和仅需 HTTP 请求的场景更适合使用原生节点。

读取 $input.all()、$input.first()、$input.item 和命名节点数据;生成符合 n8n 要求的 JSON 项目数组;指导使用 this.helpers.httpRequest()、DateTime、$jmespath() 和工作流静态数据;解释 All Items 与 Each Item 模式的选择和性能差异;处理聚合、筛选、解析、转换、批处理、循环累积和错误返回;识别 Webhook 的 $json.body 嵌套、返回值错误、沙箱限制和 pairedItem 问题。

  1. 需要在 n8n Code 节点中聚合、排序、去重或统计多条输入数据的自动化开发者。
  2. 需要解析 Webhook 请求并正确读取 $json.body 中字段的工作流构建者。
  3. 需要在 Code 节点中执行自定义数据转换、业务规则或复杂条件处理的用户。
  4. 需要排查 Code 节点返回格式、执行模式、循环累积或大批量数据性能问题的用户。
  5. 需要在 n8n 中进行简单未认证 HTTP 请求或处理日期、JSON 结构和文本数据的开发者。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖 n8n Code 节点最常见的数据访问、返回格式和错误模式。
  • 明确说明 All Items 与 Each Item 的适用场景和性能差异。
  • 包含 SplitInBatches、跨迭代累积和 pairedItem 等生产环境陷阱。
  • 提供 10 类生产模式及输入校验、异常处理和提前过滤建议。
局限
  • 只针对 n8n Code 节点,不覆盖 AI Agent Custom Code Tool 的运行时契约。
  • 认证、分页和重试等复杂 HTTP 调用优先需要 HTTP Request 节点或其他工作流设计。
  • require()、$env 和部分认证辅助函数受 n8n 实例配置或沙箱限制。
  • 来源没有提供该单独技能在不同平台上的独立测试结果。

如何安装这个 Skill?

该技能属于 czlonkowski/n8n-skills 集合。Claude Code 插件方式:执行 /plugin install czlonkowski/n8n-skills。手动方式:执行 git clone https://github.com/czlonkowski/n8n-skills.git,然后将 n8n-skills/skills/* 复制到 ~/.claude/skills/。使用前还需要安装并配置 n8n-mcp MCP 服务器以及 .mcp.json。单独上传到 Claude.ai 时,下载并上传对应的 n8n-code-javascript 技能文件夹;其他平台的单独安装步骤未在来源中具体说明。

如何使用这个 Skill?

安装后直接提出相关任务,例如“如何在 n8n Code 节点中访问 Webhook 数据?”或“为 Run Once for All Items 模式编写一个聚合所有输入金额的 JavaScript”。需要为 AI Agent 挂载 Custom Code Tool 时,不要使用本技能,应改用 n8n-code-tool 技能。

这个 Skill 与同类方案有什么区别?

来源明确建议:简单字段映射使用 Set/Edit Fields,基础筛选使用 Filter,简单条件使用 IF 或 Switch,仅需 HTTP 请求时使用 HTTP Request 节点;这些场景不一定需要 Code 节点。

常见问题

这个技能是否免费?
来源显示仓库采用 MIT License,但未说明其他运行成本。使用时仍需要 n8n-mcp MCP 服务器和 n8n 环境。
它能处理需要认证的 API 请求吗?
技能建议优先使用带凭据的 HTTP Request 节点。Code 节点中的认证辅助函数被 deny-list,只有工作流数据中已有令牌时才建议手动设置 Authorization 头。
为什么 Code 节点返回 primitive 会失败?
n8n 需要项目结构;建议返回 `[{json: {...}}]`。字符串、数字、null 或 undefined 没有可包装的数据,可能触发“Code doesn't return items properly”。
它适合所有数据转换任务吗?
不适合。来源建议先考虑表达式、Edit Fields 或原生节点;Code 节点更适合跨项目聚合、复杂逻辑、递归处理和异步工作。

同仓库的其他 Skills

均来自 czlonkowski/n8n-skills

开发与工程

n8n Python 代码节点指南

帮助你在 n8n Code 节点中可靠编写受限环境下的 Python。

开发与工程

n8n 表达式语法助手

帮助你编写、检查并修复 n8n 工作流表达式。

自动化与运维

n8n 工作流架构模式

用经过验证的架构模式设计、验证和部署可靠的 n8n 工作流。

开发与工程

n8n AI 代码工具指南

帮助你为 n8n AI Agent 编写符合工具运行契约的 JavaScript 或 Python 代码。

自动化与运维

n8n 节点配置助手

按操作和字段依赖配置 n8n 节点,减少验证错误与静默失败。

自动化与运维

n8n 文件与二进制数据指南

帮助你在 n8n 中正确传递文件、处理二进制数据,并让 AI 工具和聊天界面可靠使用文件。

自动化与运维

n8n MCP 工作流路由器

为 n8n-mcp 工作流任务匹配正确技能并降低生产故障。

自动化与运维

n8n MCP 工具专家

指导 AI 正确搜索、验证、创建和维护 n8n 工作流。

自动化与运维

n8n 故障处理指南

让 n8n 工作流的失败可路由、可告警、可恢复。

自动化与运维

n8n 多实例定位助手

帮助 MCP 会话安全选择、验证并切换目标 n8n 实例,避免误读和误写。

自动化与运维

n8n AI Agent 架构指南

帮助你为 n8n AI Agent 正确选择节点、连接工具并处理记忆、结构化输出与人工审核。

自动化与运维

n8n 子工作流架构指南

帮助你把 n8n 中可复用的多步逻辑封装成清晰、可测试、可被智能体调用的子工作流。

自动化与运维

n8n 验证专家

帮助 AI 解释 n8n 验证结果,并逐步修复会阻止工作流运行的问题。

自动化与运维

n8n 自托管部署助手

在 Linux 服务器上通过 Docker、Caddy 和自动 HTTPS 部署生产级自托管 n8n。

相关 Skills