n8n JavaScript 代码节点助手
帮助你在 n8n Code 节点中编写可靠、高效的 JavaScript。
文档明确限制认证辅助函数、环境变量和 require(),并建议使用凭据化 HTTP Request 节点,体现了一定的最小权限和数据流意识;但仍提供任意 HTTP 请求、手工传递令牌、DELETE 和持久化静态数据示例,没有用户确认、敏感数据脱敏、外部影响提示或回滚方案,且发布者身份未验证,因此扣分。
内容覆盖模式选择、返回格式、常见错误、异常输入和沙箱限制,快乐路径较完整;但存在节点引用语法前后不一致、部分示例假定输入结构、空输入和错误处理覆盖不完整等问题,且静态审查无法复现关键路径,因此按静态上限保守扣分。
目标受众、Code 节点场景、Custom Code Tool 的排除条件以及与原生节点的替代关系描述清楚;但触发范围过宽,许多版本和实例配置依赖未形成明确边界,没有中文使用支持证据,也未充分说明不同 n8n 版本的适用性,因此扣分。
文档有快速开始、分层主题、相关文件、检查清单、模式示例和限制说明,许可证元数据为 MIT;但缺少明确维护责任人、版本策略、变更日志、更新路径和可验证来源,且部分引用文件在给定材料中不完整,因此扣分。
提供大量可直接改写的 JavaScript、数据访问、性能和错误模式,能够覆盖常见 Code 节点任务;但多个示例依赖未声明输入、存在潜在运行语义问题,且没有静态可核验的真实输出或测试证据,故仅部分认可其可用性。
材料包含具体代码、错误信息、配置名和版本相关断言,具有一定审计价值;但“production-tested”“measured”等关键说法没有提交的测试套件、CI 覆盖或第三方交叉证据,静态审查也无法独立复现,因此低分。
- 不要将示例中的任意 HTTP 请求、手工 Authorization 令牌、DELETE 或 $getWorkflowStaticData 直接用于生产;先确认数据流、凭据范围、外部副作用和恢复方案。
- 部分 n8n 版本、任务运行器和实例环境变量会改变可用 API;执行前应在目标实例验证 helper、返回形状、节点引用和 allowlist 配置。
- 文档含有前后不一致或假定输入结构的示例,不能把“production-tested”和性能数字视为已由本次评估验证。
这个 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 问题。
- 需要在 n8n Code 节点中聚合、排序、去重或统计多条输入数据的自动化开发者。
- 需要解析 Webhook 请求并正确读取 $json.body 中字段的工作流构建者。
- 需要在 Code 节点中执行自定义数据转换、业务规则或复杂条件处理的用户。
- 需要排查 Code 节点返回格式、执行模式、循环累积或大批量数据性能问题的用户。
- 需要在 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 节点。