技能介绍
n8n-skills 是一套包含 14 个互补的 Claude Code 技能（外加一个路由器技能和钩子执行层）的集合，用于指导 AI 助手使用 n8n-mcp MCP 服务器构建生产级 n8n 工作流，并部署自托管 n8n。作者是 czlonkowski，项目在 GitHub 上获得 5.9K Stars，采用 MIT 许可。
适用场景
- 使用 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，支持单机或队列模式，安全默认配置，以及第二天运维操作。
限制与兼容性
- 钩子执行层：主动提示（路由器技能、PreToolUse/PostToolUse 钩子）仅在 Claude Code / Codex 插件安装中运行。在 Claude.ai 上，技能仍会通过描述激活，但不会收到主动提醒。
- 限制：Code Python 技能提醒在 n8n Code 节点中无法使用外部库（如 requests、pandas、numpy）。Code Tool 技能与常规 Code 节点具有不同的契约。
- 兼容性：专为使用 n8n-mcp MCP 服务器构建的 n8n 工作流设计。自托管技能适用于本地部署，不适用于 n8n Cloud。
效果预览
工作方式
这些技能会在你提出相关问题时自动激活。例如：
- “如何编写 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 钩子），可在决策时刻提供正确的指导。
你需要提供
- n8n-mcp MCP 服务器：已安装并配置（安装指南）。
- Claude Code、Claude.ai 或 Claude API 访问权限。
- `.mcp.json` 配置：已配置 n8n-mcp 服务器。
你会获得
- 能够自信地构建生产级 n8n 工作流，避免常见错误。
- 正确的 n8n 表达式语法和数据映射。
- 有效使用 n8n-mcp MCP 工具。
- 针对不同场景的经过验证的工作流模式。
- 正确的节点配置和错误处理。
- 在 JavaScript、Python 和 Code Tool 节点中编写正确的代码。
- 关于二进制数据、子工作流、AI 代理、多实例和自托管部署的最佳实践。
使用示例
技能会根据你的查询自动激活。例如可以直接这样提问：
- 请使用 n8n-skills 帮助我设计一个包含错误处理机制的 Webhook 工作流，并确保其符合生产环境的最佳实践。
- 请根据 n8n-skills 的最佳实践，指导我如何正确配置 AI Agent 节点及其工具调用。
- 我遇到了 n8n 验证错误，请使用 n8n-skills 的验证专家技能帮我分析并修复此问题。
