n8n 工作流架构模式
用经过验证的架构模式设计、验证和部署可靠的 n8n 工作流。
文档强调凭据系统、最小权限、参数化查询、人工确认副作用、测试前使用安全数据，以及间接提示注入风险，显示主要安全风险可见；但示例仍包含删除、外部写入、激活和命令执行等高影响操作，回滚与数据流披露不完整，且发布者身份未验证，因此扣分。
结构化清单、错误处理和生命周期建议使快乐路径可理解；但SKILL.md与README.md对核心模式数量不一致，激活方式相互矛盾，部分代码/配置示例可能依赖具体版本，且没有静态可见的覆盖关键路径的测试证据，因此受静态上限限制并扣分。
受众、触发场景和主要工作流类型描述清晰，覆盖Webhook、API、数据库、AI和定时任务；但“所有创建或设计请求都必须调用”过于宽泛，非适用边界、版本差异和中文/大陆网络环境说明不足，因此扣分。
文档分层较清楚，包含索引、清单、示例、相关技能、依赖和MIT许可元数据；但版本与变更记录、维护责任、更新路径和故障排查不足，且文件数量、模式数量、统计数据和“完整示例”表述存在不一致，因此扣分。
模式选择、架构骨架、常见陷阱和检查清单可直接帮助规划n8n工作流，具备明显实用价值；但输出主要是指导性文本而非经验证的可部署工作流，部分示例需要人工校正，静态评估不能证明结果正确性，因此扣分。
文件提供了代码片段、检查清单和若干模板/统计声称，具有有限可审计材料；但没有引用、独立复现记录、CI或提交的评测套件，关键数字和“proven”声明无法由给定文件交叉验证，因此扣分。
- 不要将示例视为已验证的生产配置；部署、激活、数据库写入、消息发送和删除操作前应进行人工审查并使用可回滚或沙盒数据。
- SKILL.md与README.md在核心模式数量、统计数字和激活流程上存在不一致，应先核对实际n8n版本与节点行为。
- 涉及第三方API、AI工具和外部内容时，应限制凭据权限、验证输入并防止提示注入；部分外部服务的可达性和中文支持未说明。
这个 Skill 能做什么，适合哪些场景？
这是 n8n-skills 仓库中的一个独立 Agent Skill，专注于工作流架构设计，而不是整个技能集合。它覆盖 Webhook、HTTP API、数据库、AI Agent、批处理和定时任务六类核心模式，并提供模式选择指南。技能还提供从规划、实现、验证、测试到激活的工作流清单，强调连接检查和真实副作用测试。它适合使用 n8n-mcp 构建 n8n 自动化的用户，但不替代节点配置、表达式或错误处理等相关技能。
指导助手根据场景选择 n8n 工作流模式，规划触发器、数据源、转换、输出和错误处理节点；提供线性、分支、并行、循环和错误处理架构示例；说明 SplitInBatches、嵌套循环、API 分页和批量性能优化；指导助手调用 validate_workflow、n8n_get_workflow、n8n_test_workflow、n8n_executions 和 n8n_update_partial_workflow 等 n8n-mcp 操作进行验证、连接检查、测试和激活；列出 Google Sheets、Google Drive、Webhook 数据结构和认证相关的常见陷阱。
- n8n 开发者需要接收 Stripe、表单或 GitHub Webhook，并在处理后更新数据库或发送通知时，使用 Webhook Processing 模式。
- 自动化工程师需要从 REST API 获取数据、转换后写入数据库或第三方服务时，使用 HTTP API Integration 模式。
- 数据工程师需要按批次处理超出 API 限制的大型数据集，或实现多层分页循环时，使用 Batch Processing 模式。
- 团队需要构建带模型、工具和记忆的聊天机器人或多步推理流程时，使用 AI Agent Workflow 模式。
- 运维或业务团队需要每天生成报告、定期同步数据或执行维护任务时，使用 Scheduled Tasks 模式。
这个 Skill 有哪些优点和局限？
- 覆盖六类常见 n8n 工作流架构，包含具体流程图和选择条件。
- 提供从规划到部署的检查清单，并明确验证不等于逻辑正确。
- 包含批处理、嵌套循环、分页和高数据量处理的性能建议。
- 提供针对 Webhook、Google Sheets、Google Drive 和认证配置的具体陷阱说明。
- 依赖 n8n-mcp MCP server 和 n8n 实例，不能单独执行完整工作流。
- 技能正文引用了其他 n8n 技能和详细模式文件，但提供的材料未包含这些文件的内容。
- 源材料没有提供该独立技能的测试结果或跨平台运行记录。
- 工作流测试可能触发写入、消息发送和外部 API 调用等真实副作用。
如何安装这个 Skill？
先安装并配置 n8n-mcp MCP server，并准备 n8n 实例和 .mcp.json。使用 Claude Code 时，可直接运行 /plugin install czlonkowski/n8n-skills；也可克隆仓库后运行 cp -r n8n-skills/skills/* ~/.claude/skills/，然后重新加载 Claude Code。Claude.ai 的安装方式是下载该技能文件夹，压缩后通过 Settings → Capabilities → Skills 上传。
如何使用这个 Skill？
安装后，在构建或优化 n8n 工作流的提示中描述目标，例如：Build and validate a webhook workflow that receives a form submission, updates a database, and sends a Slack notification. 技能会帮助选择架构、规划节点、处理批量和错误场景，并指导验证、测试和激活。