n8n 子工作流架构指南
帮助你把 n8n 中可复用的多步逻辑封装成清晰、可测试、可被智能体调用的子工作流。
内容明确区分无状态与有状态子工作流，要求披露副作用，并提到验证、错误返回和完成跟踪；但未要求用户确认外部写入、最小权限、敏感数据处理、凭据隔离、回滚或数据流审查，发布者身份也未获验证，因此扣分。
结构、示例和反模式基本一致，并提供异常失败与未识别字段的说明；但依赖未在本文件中验证的 n8n/MCP 行为，缺少实际测试套件和可复现的关键路径，且存在“超过约10节点”与“超过5节点”的触发阈值不一致，故静态评分受限。
目标用户、触发场景、Define Below 与 passthrough 的适用边界、all/each 和同步/异步选择均有说明；但未明确非适用范围的完整清单，没有中文使用指导，也没有证明在中国大陆网络环境下的可达性，故扣分。
文档分层、交叉引用、示例、反模式、清单、版本 1.0.0、兼容性和 MIT 许可均较清楚；但维护责任、变更记录和更新路径不完整，且仓库 README 的技能数量与给定总数存在不一致，故未满分。
可直接指导子工作流拆分、输入输出契约、命名、调用模式和并行化设计，核心任务价值明确；但没有文件内的实际执行结果或代表性产物验证，且关键能力依赖外部 n8n-mcp 环境，静态审查下不能确认结果完整正确，故不超过7分。
提供了具体 MCP 调用、配置片段、决策规则和检查清单，具备一定审计性；但 supplied files 未包含覆盖关键路径的测试套件或真实 CI 执行证据，主要仍是作者文档声明，故仅给有限分数。
- 不要将文档中的 n8n-mcp 能力、并行语义或版本兼容性视为已执行验证；上线前应在隔离实例中测试关键路径。
- 涉及数据库、Data Table、Slack/SMTP 或其他外部写入时，需补充用户确认、权限范围、敏感数据策略、幂等性和可恢复方案。
- 发布者未通过 FollowSkills 企业注册表验证，来源身份应视为未知。
- 触发阈值存在不一致，且缺少明确的中文与中国大陆网络环境说明。
这个 Skill 能做什么，适合哪些场景？
这是 n8n-skills 仓库中的独立子工作流技能，专注于复用逻辑、输入输出契约和工作流模块化。它指导用户先搜索已有工作流，再决定是否抽取逻辑，并配置 Execute Workflow Trigger 的类型化输入。内容覆盖 all 与 each 执行模式、同步与后台调用、无状态与有状态设计，以及按输入形状拆分工作流。它适合使用 n8n-mcp 构建复杂或重复 n8n 工作流的团队，但不负责通用节点配置、部署或完整工作流架构。
指导助手使用 n8n_list_workflows 和 n8n_get_workflow 搜索已有子工作流；配置带有 Define Below 和类型化 workflowInputs.values 的 Execute Workflow Trigger；设计最终 Return 节点及稳定的输入输出契约；选择 mode 为 all 或 each，并决定 waitForSubWorkflow 是否后台执行；通过 verb-first 名称和描述提高发现性；为预期错误返回 { ok: false, error }；使用 validate_workflow 验证、n8n_test_workflow 隔离测试、n8n_executions 检查运行，并在需要时使用 Data Table 支持状态跟踪。
- n8n 开发者在多个工作流中重复解析、认证、重试或格式化逻辑时，将其抽取为共享子工作流。
- 团队维护超过约 10 个节点、且包含可独立测试逻辑的工作流时，用子工作流降低主流程复杂度。
- 需要把可复用流程暴露为 AI agent 工具，并要求智能体填写结构化参数时，使用类型化触发器。
- 处理 JSON 与二进制文件、同步与异步等不同输入契约时，按输入形状拆分外层工作流并复用共享核心。
- 调用方需要逐项执行、后台派发或完成状态跟踪时，选择合适的 mode、waitForSubWorkflow 和 Data Table 模式。
这个 Skill 有哪些优点和局限？
- 明确要求先搜索已有工作流，减少重复建设。
- 详细说明类型化输入、自然输出形状和契约变更风险。
- 覆盖 all/each、阻塞/后台执行及 N+1 输入拆分模式。
- 兼顾无状态复用逻辑与有明确契约的状态操作。
- 提供验证、隔离测试和运行检查的具体工具路径。
- 依赖 n8n-mcp MCP server，不能脱离 n8n-mcp 单独完成这些操作。
- 二进制输入通常必须使用 passthrough，不能干净地作为 agent 工具传递。
- 零输入工作流也只能使用 passthrough，且需要额外清理和文档约束。
- 源材料未说明该单个技能的独立测试命令或独立发布包。
- 主要解决子工作流设计，不涵盖完整的 n8n 部署、通用节点配置或所有工作流模式。
如何安装这个 Skill？
先安装并配置 n8n-mcp MCP server。Claude Code 推荐安装整个仓库：/plugin install czlonkowski/n8n-skills。手动方式是 git clone https://github.com/czlonkowski/n8n-skills.git，然后将 n8n-skills/skills/* 复制到 ~/.claude/skills/。源材料未提供该单个技能的独立插件安装命令。
如何使用这个 Skill？
在已配置 n8n-mcp 的 Claude Code 或 Claude.ai 中提出具体请求，例如：“把这段重复的 n8n 逻辑抽取成可复用子工作流，并使用 Define Below 的类型化输入。”也可以直接提及“sub-workflows”“Execute Workflow”“mode each vs all”或“waitForSubWorkflow”，触发该技能。
这个 Skill 与同类方案有什么区别？
与 n8n 的 Custom Code Tool 相比，子工作流更适合共享、多步骤且需要完整 Code 节点沙箱的逻辑；Custom Code Tool 更适合内联的 agent 工具代码。