n8n 节点配置助手
按操作和字段依赖配置 n8n 节点,减少验证错误与静默失败。
文档强调先发现、验证、避免占位凭据,并明确 SQL 参数化、静默丢数据和外部响应码等风险,显示出一定的数据流与安全意识。扣分原因是部署和工作流更新仍被作为常规后续步骤,未要求用户确认、未说明凭据/敏感数据处理边界,也没有回滚、变更隔离或完整外部副作用披露;发布者身份未验证且缺乏可核验来源归属。
文档提供了操作识别、依赖发现、验证迭代和失败排查流程,且 patchNodeField 的多匹配失败说明有一定可诊断性。扣分原因是存在明显自洽性问题:SKILL.md 称时区属于工作流级别,而 OPERATION_PATTERNS.md 又把 timezone 放在规则内;数据库参数字段在不同示例中使用 queryReplacement 与 additionalFields.queryParameters;若干断言依赖未提供的工具、版本或运行时行为。静态校准下未见可复现执行证据,故不超过10分。
README 明确列出触发短语、常见场景、目标工具和覆盖的节点类别,适合 n8n 节点配置任务。扣分原因是非适用范围、版本兼容边界和工具可用性条件说明不足,中文语言支持未声明,且核心能力依赖 n8n-mcp/Claude Code 环境,未证明在中国大陆网络环境中的可达性。
目录结构、渐进式披露、相关文档、示例、陷阱和版本历史较完整,并提供 MIT 许可和作者信息。扣分原因是维护责任、问题反馈渠道、更新路径和变更记录不充分;README 声称存在4个评测但所给材料未包含评测文件或结果,统计数据和“verified end-to-end”声明也缺少随附证据。
核心任务路径清晰:按资源/操作发现字段、处理 displayOptions、验证并迭代,且示例覆盖 HTTP、Slack、数据库、条件节点等常见场景,具有直接参考价值。扣分原因是部分示例可能与实际 n8n 版本不符或相互冲突,部分配置仍需按实例 schema 修正,缺少静态可核验的代表性最终输出;因此只能确认完成核心指导而非稳定产出可直接部署的工作流。
材料包含具体配置、字段名、失败症状和修复建议,具备一定审计线索。扣分原因是关键成功率、耗时、覆盖率和端到端验证均为文档内声明,没有提交的测试套件、CI 结果或第三方交叉佐证;静态审查不能独立复现这些结论,故低于5分。
- 将 timezone、数据库参数字段等版本敏感配置提交前与目标 n8n 实例的 get_node schema 核对。
- 不要把文档中的成功率、评测数量或端到端验证声明视为已证明;材料未提供对应测试证据。
- 部署或更新工作流前应单独确认凭据、外部写入、响应行为和回滚方案。
- n8n-mcp/Claude Code 依赖的大陆网络可达性未在材料中证明。
这个 Skill 能做什么,适合哪些场景?
这是 n8n-skills 仓库中的单个 Agent Skill,专注于操作感知的节点配置。它指导用户根据资源和操作识别必填字段,理解 displayOptions 控制的条件字段,并按需查询节点标准、完整或属性搜索信息。内容覆盖 HTTP、Slack、数据库、条件逻辑、SplitInBatches 和 Google Sheets 等节点配置模式,也强调验证驱动的迭代流程。它适合使用 n8n-mcp 构建工作流的用户,但不负责完整的工作流架构、代码编写或 n8n 部署。
指导调用 get_node 获取节点的标准或完整详情,或使用 search_properties 查找特定字段;根据资源、操作和字段依赖确定配置;建议先配置最小字段,再通过 validate_node 逐步修正;说明何时使用 n8n_update_partial_workflow 的 patchNodeField 进行局部文本替换;提供凭据块、节点 UUID、typeVersion、数据库写操作输出和若干节点族静默失败问题的配置注意事项。
- 正在用 n8n-mcp 配置 Slack、HTTP Request 或数据库节点,需要确定某个操作的必填字段的自动化开发者。
- 配置 POST、PUT 或 PATCH 请求,需要根据 sendBody 和 body 的条件依赖逐步完成 HTTP Request 节点的用户。
- 切换 Slack 等节点操作后遇到字段不匹配,需要重新识别 operation-specific 参数的用户。
- 需要编辑大型 Code 节点、HTML 邮件或 JSON 文本中的局部内容,而不想替换整个字段的用户。
- 配置数据库写操作、Switch、Merge、Webhook 或 Schedule Trigger 节点,并希望规避验证通过后的静默运行问题的用户。
这个 Skill 有哪些优点和局限?
- 明确区分资源、操作与条件字段,适合处理动态必填项。
- 提供 standard、search_properties 和 full 三种渐进式发现路径。
- 强调先最小配置、再验证迭代,包含具体 HTTP、Slack、数据库和条件逻辑示例。
- 覆盖凭据占位符、UUID、typeVersion、输出为空等容易导致运行问题的细节。
- 依赖 n8n-mcp MCP server;技能本身不提供该服务器。
- 主要是配置指导,不是可独立执行的节点配置器或完整工作流生成器。
- 部分建议引用其他技能或仓库文档,例如依赖、操作模式和节点族陷阱的完整说明不在给定 SKILL.md 中。
- 源材料没有提供该单个技能独立的测试结果或跨平台测试证据。
如何安装这个 Skill?
先安装并配置 n8n-mcp MCP server,并准备 Claude Code、Claude.ai 或 Claude API 访问。推荐在 Claude Code 中运行:/plugin install czlonkowski/n8n-skills。手动方式是克隆仓库后执行:git clone https://github.com/czlonkowski/n8n-skills.git,然后将 n8n-skills/skills/n8n-node-configuration/ 复制到 Claude Code 的技能目录。源材料未提供其他客户端的单独安装命令。
如何使用这个 Skill?
在已加载该技能且 n8n-mcp 可用的环境中,直接提出例如“How do I configure the HTTP Request node?”的问题。通常先用 get_node 的 standard 详情,必要时用 search_properties,仍不足时再请求 full 详情;配置后调用 validate_node,根据错误补充字段并重复验证。