n8n 验证专家
帮助 AI 解释 n8n 验证结果，并逐步修复会阻止工作流运行的问题。
技能本身主要提供只读解释与修复建议，并在工作流审查清单中提示凭据、注入风险及自动修复需用户确认；但自动修复示例直接展示 applyFixes:true，缺少统一的确认、权限隔离、回滚和数据流披露。凭据安全覆盖不完整，且发布者身份未验证，因此扣除15分。
文档结构完整，包含错误分类、异常处理、恢复策略和失败反馈，静态可见的主路径较可信；但未执行验证，且表达存在不一致，例如部分内容称表达式引用会被验证捕获，其他内容又明确称只能在执行时失败。版本依赖和若干工具行为也缺少可复现证据，因此按静态上限保守扣分。
触发词、典型场景、验证配置文件和不应忽略的警告均有明确说明，适合使用 n8n-mcp 的 Claude Code 用户；但非适用范围、实际输入输出边界、中文支持及中国大陆网络可达性未说明，并依赖 n8n-mcp 2.63.0以上的行为，因此扣除5分。
SKILL.md、错误目录、误报指南和审查清单形成较好的渐进式文档结构，包含安装前提、示例、限制、相关技能、MIT许可上下文、作者和版本历史；但维护责任、更新渠道、变更记录和依赖兼容矩阵不完整，部分外部统计与链接材料未在技能内可核验，因此扣除6分。
错误分类、配置示例、验证循环、配置文件选择和恢复操作能直接指导核心排错任务，静态看具有明显实用价值；但示例和声明未经过执行验证，部分建议依赖具体服务器版本或其他技能，用户仍需结合实际 n8n 环境复核，因此扣除9分。
文档提供大量代码示例和版本条件，具备有限的静态审计线索；但没有提交的测试套件、CI覆盖、第三方执行记录或独立复核证据，7,841次遥测、错误比例、94%成功率等关键声明无法从给定文件验证，因此仅给出低分。
- 不要把文档中的遥测数字、成功率、错误占比或“真实示例”当作已独立验证的证据。
- 自动修复可能改变工作流；在生产环境应用前应检查权限、变更范围、凭据和回滚方案，并取得用户确认。
- 核心行为依赖 n8n-mcp 版本，尤其是2.63.0以上；应在目标服务器上复核验证配置文件、表达式解析和自动清理行为。
- 该技能未说明中文交互质量或中国大陆网络环境下的服务可达性。
这个 Skill 能做什么，适合哪些场景？
这是 n8n-skills 仓库中的单项技能，专门处理 n8n 节点和工作流验证。它区分必须修复的错误、可酌情处理的警告和可选建议，并解释 minimal、runtime、ai-friendly 与 strict 验证配置。技能还介绍验证循环、自动清理、自动修复和常见工作流结构问题。它适合使用 n8n-mcp 构建或审查 n8n 工作流的 Claude Code、Claude.ai 或其他兼容 Agent Skills 的环境。
指导用户读取 validate_node 与 validate_workflow 的 valid、errors、warnings、suggestions 和 summary 字段；解释 missing_required、invalid_value、type_mismatch、invalid_expression、invalid_reference 以及 patchNodeField 错误；建议使用 get_node、cleanStaleConnections 和 n8n_autofix_workflow；说明如何选择验证 profile、处理连接和表达式问题、判断警告是否为可接受的最佳实践建议，并提供现有工作流审查清单的使用方向。
- 使用 n8n-mcp 创建节点后，用户需要理解 validate_node 返回的字段缺失或类型错误。
- 工作流验证失败，用户需要定位断开的节点引用、表达式错误或连接问题。
- 用户想选择 runtime、ai-friendly 或 strict profile，以决定验证应关注运行阻断问题还是最佳实践。
- 验证结果包含警告时，用户需要判断错误处理、重试、限流或无界查询建议是否必须处理。
- 工作流更新后出现可自动修复的问题，用户需要预览或应用 n8n_autofix_workflow 提供的修复。
- 现有工作流虽然通过验证，用户仍需要检查静默连接错误、注入风险或缺少错误路径。
这个 Skill 有哪些优点和局限？
- 覆盖节点验证、完整工作流验证、验证 profile、错误分类和修复循环。
- 明确区分阻断执行的错误、安全与弃用警告、最佳实践建议和可选优化。
- 提供 n8n_autofix_workflow、cleanStaleConnections 和自动清理行为的具体用法。
- 针对 n8n-mcp 2.63.0 及以上版本说明了验证器行为和经典误报的变化。
- 它是解释和修复指导技能，不是独立的 n8n 验证引擎；需要 n8n-mcp MCP server。
- 源材料没有提供单独技能的测试结果或独立安装包说明。
- 自动修复无法处理所有问题，例如不存在的节点连接、分支数量不匹配和某些损坏状态。
- 内容主要针对 n8n-mcp 工作流场景，不是通用工作流验证器。
如何安装这个 Skill？
先安装并配置 n8n-mcp MCP server，以及 Claude Code、Claude.ai 或 Claude API 访问权限。安装整个仓库时，可使用 /plugin install czlonkowski/n8n-skills；也可以克隆仓库并执行 cp -r n8n-skills/skills/* ~/.claude/skills/，然后重新加载 Claude Code。若只使用本技能，应将 skills/n8n-validation-expert/ 作为技能文件夹安装到目标客户端支持的技能目录；源材料未说明其他客户端的具体复制路径。
如何使用这个 Skill？
在已配置 n8n-mcp 的环境中直接提出相关请求，例如“为什么这个 n8n 工作流验证失败？”或“解释 validate_workflow 的 warnings 并告诉我哪些需要修复”。技能会在验证失败、出现警告、需要选择验证 profile、解释验证结果或使用自动修复时提供指导。常用流程是 validate → 阅读错误 → 修复 → 再次验证，通常需要 2 至 3 轮。
这个 Skill 与同类方案有什么区别？
与直接查看验证输出相比，本技能提供错误分类、profile 选择、迭代修复和自动修复指导；源材料未提供与其他专门验证产品的直接比较。