n8n 表达式语法助手
帮助你编写、检查并修复 n8n 工作流表达式。
内容明确提醒环境变量和凭据风险，并建议使用凭据系统；但示例仍展示将 API 密钥放入请求头或 URL，且建议删除 Set 节点并改线，缺少用户确认、备份、回滚和数据流审查，因此扣分。未见恶意代码、隐蔽外泄或明显越权。
结构清晰，覆盖常见语法、错误和调试流程，正常路径基本可理解；但没有可执行测试或 CI 证据，部分断言依赖 n8n 版本和节点上下文，且若干规则（如 Webhook 结构、凭据字段、IIFE 支持及性能数据）缺少边界说明，因此静态评分不超过 10 并扣分。
目标用户、触发词和主要场景定义较清楚，覆盖表达式、Webhook、Code 节点及节点引用；但非适用范围、版本差异、输入形态和中文使用说明不足，也未说明 n8n 部署环境限制，因此扣分。核心功能不依赖海外在线服务。
文档分为主指南、错误目录、示例和 README，包含安装依赖、相关技能、MIT 许可证、更新时间和基本评估声明；但维护责任、变更日志、版本兼容矩阵、完整安装路径和问题升级渠道不完整，且 README 的仓库级信息不能完全替代该技能自身治理信息，因此扣分。
示例和速查表可直接帮助处理多数表达式书写问题，核心任务价值明确；但关键示例没有执行证据，部分建议可能需要按 n8n 版本或节点类型调整，性能与“95%覆盖”等效果声明也未被文件内测试充分支持，因此仅给静态上限内的中等分数。
存在固定 revision、具体代码样例、错误目录和声明的评估场景，但文件未提供提交的测试套件、CI 结果、第三方复核或可复现执行记录；“真实工作流”“MCP 测试”“性能测量”等主要是作者声明，因此不超过静态上限 5 并扣分。
- 不要将 API 密钥放入 URL 或普通表达式文本；优先使用 n8n 凭据，并确认实例的环境变量访问策略。
- 删除或改线 Set 节点前应获得用户确认并保留可恢复副本；该建议可能改变数据流。
- 在目标 n8n 版本和具体节点中验证 $node、$('Node')、Webhook body、IIFE、凭据字段及表达式性能行为。
- 示例中的外部 API、SQL 拼接和 Webhook 输入未覆盖转义、缺失字段、数组为空、敏感数据日志及错误响应处理。
这个 Skill 能做什么，适合哪些场景？
这是 czlonkowski/n8n-skills 仓库中的一个独立技能，专门指导 n8n 表达式的编写、验证和常见错误修复。它覆盖双大括号语法、$json、$node、$now、$env、Webhook 数据结构以及节点间数据映射。技能还说明何时应使用表达式、Edit Fields 中的 IIFE 或 Code 节点，并讨论表达式复杂度、节点数量和执行性能。它适合使用 n8n 构建工作流、排查字段映射错误，或需要通过 n8n-mcp 验证表达式的用户。
指导模型在 n8n 字段中生成带 {{}} 的表达式，读取当前节点和其他节点的数据，访问 Webhook 的 body、查询参数和请求头，处理嵌套对象、数组、字符串、数字和 Luxon 日期时间。它识别缺少大括号、字段名未使用括号表示法、节点名称大小写错误、Webhook 路径错误以及在 Code 节点中误用表达式等问题，并提供修正写法。它还给出使用表达式、Edit Fields IIFE 和 Code 节点进行数据转换的决策顺序，以及分支汇合和 Set 节点使用方面的建议。
- n8n 工作流开发者在 Webhook 到 Slack 的流程中，需要正确读取 $json.body 下的用户数据。
- 自动化工程师在引用名为 HTTP Request 的上游节点时，需要处理带空格且区分大小写的节点名称。
- 工作流维护者遇到表达式显示为字面文本、字段未定义或方法不存在等错误，需要定位并修复路径。
- 需要在 n8n 字段中完成日期格式化、数组处理、字符串拼接或条件判断的用户。
- 希望判断复杂表达式是否应拆分为多个节点，或是否需要改用 Code 节点的 n8n 使用者。
这个 Skill 有哪些优点和局限？
- 覆盖当前节点、其他节点、Webhook、环境变量和日期时间等常见表达式场景。
- 明确列出 Code 节点、Webhook 路径和凭据字段中不应使用表达式的情况。
- 提供常见错误、修复示例、分支汇合和数据转换层级建议。
- 可作为 n8n-skills 集合的一部分安装，也可单独上传该技能文件夹。
- 依赖 n8n-mcp MCP server 的验证能力，技能本身不是独立的 n8n 执行器。
- 源材料没有提供独立测试结果、平台覆盖数据或性能基准的复现方法。
- 性能数字来自材料所述的 n8n 2.x 实例，不能据此保证所有 n8n 环境表现一致。
- 完整错误目录和真实工作流示例位于未提供正文的 COMMON_MISTAKES.md 与 EXAMPLES.md。
如何安装这个 Skill？
该技能属于 n8n-skills 集合。Claude Code 可直接安装集合：/plugin install czlonkowski/n8n-skills；也可克隆仓库并复制技能目录：git clone https://github.com/czlonkowski/n8n-skills.git，然后将 n8n-skills/skills/n8n-expression-syntax 复制到 ~/.claude/skills/。使用前，集合文档要求配置 n8n-mcp MCP server。Claude.ai 可下载 skills/n8n-expression-syntax 文件夹并通过 Settings → Capabilities → Skills 上传。API/SDK 的具体安装步骤在所给材料中未展开。
如何使用这个 Skill？
安装后用自然语言提出相关请求，例如“如何在 n8n 中正确读取 Webhook 的 email 字段？”或“检查 {{$node["HTTP Request"].json.data}} 是否正确”。技能会在涉及 {{}}、$json、$node、Webhook 数据、表达式错误或性能取舍时自动激活。需要实际验证时，可使用 n8n-mcp validation tools；材料未说明该技能自身会独立执行验证。