n8n-skills

一套包含14个互补的Claude Code技能（加上一个路由器技能和钩子执行层）的集合，用于指导AI助手使用n8n-mcp MCP服务器构建生产级n8n工作流，并部署自托管n8n。

适用场景

• 使用n8n-mcp MCP服务器构建n8n工作流的开发者。
• 需要学习正确n8n表达式语法、有效使用MCP工具、经过验证的工作流模式以及正确节点配置的用户。
• 在Linux虚拟机上部署自托管n8n的用户。

核心能力

该技能包包含14个技能，可根据您的查询自动激活。每个技能针对n8n工作流构建的一个特定方面：

• n8n Expression Syntax（表达式语法）：教授正确的n8n表达式语法和常见模式，包括核心变量（$json, $node, $now, $env）和常见错误目录。
• n8n MCP Tools Expert（MCP工具专家，最高优先级）：指导有效使用n8n-mcp MCP工具，包括工具选择、节点类型格式、验证配置文件、智能参数和自动清理。
• n8n Workflow Patterns（工作流模式）：使用5种经过验证的架构模式（Webhook处理、HTTP API、数据库、AI、定时）构建工作流，附带模式选择指南。
• n8n Validation Expert（验证专家）：解释验证错误并指导修复，提供真实错误目录、误报指南和配置文件选择。
• n8n Node Configuration（节点配置）：提供操作感知的节点配置指导，包括属性依赖规则、操作特定要求和AI连接类型。
• n8n Code JavaScript（JavaScript代码）：在n8n Code节点中编写有效的JavaScript代码，涵盖数据访问模式、关键陷阱（Webhook数据位于$json.body）、正确返回格式以及前5种错误模式。
• n8n Code Python（Python代码）：在n8n Code节点中编写Python代码，了解其限制，包括数据访问、标准库参考以及缺失库的变通方法。
• n8n Code Tool（代码工具）：为AI代理可调用的自定义代码工具编写代码，该节点与常规Code节点不同，具有不同的契约（返回格式为字符串，而非[{json:{...}}]）。
• n8n Error Handling（错误处理）：使故障明显、结构化且可恢复：每个节点的错误输出、retryOnFail、4xx/5xx响应映射和错误触发器工作流。
• n8n Binary & Data（二进制数据）：正确处理文件、图像和二进制数据：$binary与$json的区别、在JSON转换中保持二进制数据、代理工具二进制边界以及聊天界面中显示图像的CDN/URL要求。
• n8n Sub-workflows（子工作流）：构建可重用、可组合的子工作流：使用带类型输入的Execute Workflow Trigger、mode: all与each、waitForSubWorkflow、动词优先命名以及无状态与有状态设计。
• n8n AI Agents（AI代理）：正确设计n8n AI代理：Agent与LLM Chain与Text Classifier的区别、工具名称和描述作为提示、结构化输出、记忆、人机回环和聊天拓扑。
• n8n Multi-Instance（多实例）：当账户有多个n8n实例时定位正确的实例：list/switch形状、会话绑定、写入凭证前验证当前实例以及从错误路由恢复。
• n8n Self-Hosting（自托管，部署/运维）：在全新的Linux虚拟机上端到端部署生产自托管n8n，使用Docker Compose搭配Caddy实现自动HTTPS，支持单机或队列模式，安全默认配置，以及第二天运维操作。

工作方式

这些技能会在您提出相关问题时自动激活。例如：

• “如何编写n8n表达式？” → 激活：n8n Expression Syntax
• “查找一个Slack节点” → 激活：n8n MCP Tools Expert
• “构建一个Webhook工作流” → 激活：n8n Workflow Patterns
• “为什么验证失败？” → 激活：n8n Validation Expert
• “如何配置HTTP Request节点？” → 激活：n8n Node Configuration
• “如何在Code节点中访问Webhook数据？” → 激活：n8n Code JavaScript
• “可以在Python Code节点中使用pandas吗？” → 激活：n8n Code Python
• “为什么我的Code Tool抛出‘Wrong output type returned’错误？” → 激活：n8n Code Tool

技能之间无缝协作。例如，当您问“构建并验证一个Webhook到Slack的工作流”时，多个技能会协同工作：Workflow Patterns、MCP Tools Expert、Node Configuration、Code JavaScript、Expression Syntax和Validation Expert。

此外，该技能包包含一个始终在线的执行层（路由器技能和PreToolUse/PostToolUse钩子），可在决策时刻提供正确的指导。该层仅在Claude Code / Codex插件安装中运行；在Claude.ai上，技能仍会通过描述激活，但不会收到主动提示。

你需要提供

• n8n-mcp MCP服务器：已安装并配置（安装指南）。
• Claude Code、Claude.ai或Claude API访问权限。
• .mcp.json配置：已配置n8n-mcp服务器。

你会获得

• 能够自信地构建生产级n8n工作流，避免常见错误。
• 正确的n8n表达式语法和数据映射。
• 有效使用n8n-mcp MCP工具。
• 针对不同场景的经过验证的工作流模式。
• 正确的节点配置和错误处理。
• 在JavaScript、Python和Code Tool节点中编写正确的代码。
• 关于二进制数据、子工作流、AI代理、多实例和自托管部署的最佳实践。

使用示例

技能会根据您的查询自动激活。参见上方“工作方式”部分的示例。

注意事项

• 前置条件：必须安装并配置n8n-mcp MCP服务器，并拥有兼容的AI助手（Claude Code、Claude.ai或Claude API）。
• 钩子执行层：主动提示（路由器技能、PreToolUse/PostToolUse钩子）仅在Claude Code / Codex插件安装中运行。在Claude.ai上，技能仍会通过描述激活，但不会收到主动提醒。
• 限制：Code Python技能提醒在n8n Code节点中无法使用外部库（如requests、pandas、numpy）。Code Tool技能与常规Code节点具有不同的契约。
• 兼容性：专为使用n8n-mcp MCP服务器构建的n8n工作流设计。自托管技能适用于本地部署，不适用于n8n Cloud。