用途:该技能面向 n8n 工作流的验证与排错,帮助解读验证错误、警告与建议,并给出修复方向。
主要能力:区分错误(必须修复,阻断执行)、警告(不阻断但可能有隐患)与建议(可选优化),覆盖 missing_required、invalid_value、type_mismatch、invalid_expression、invalid_reference 等常见类型;支持节点级 validate_node 与工作流级 validate_workflow;提供四种校验配置档:minimal(仅结构检查)、runtime(推荐默认,含错误与安全、弃用警告)、ai-friendly(追加最佳实践建议)、strict(追加残留属性等更严格检查)。自动清理系统会在保存时规范化运算符结构,如二元运算符移除多余 singleValue、一元运算符补充 singleValue: true,并补齐 IF/Switch 的 conditions.options。
使用方式:遵循“校验→读错→修复→再校验”的迭代循环,通常需 2-3 轮;先看 valid 字段,再逐条修复 errors,评估 warnings,可选用 n8n_autofix_workflow 按 confidenceThreshold 与 fixTypes 预览或应用修复,连接失效时用 cleanStaleConnections 处理。
限制:校验只检查结构、参数与表达式,不会实际运行工作流;自动清理无法修复指向不存在节点的连接、分支数量不匹配及矛盾状态;部分已知误报(如错误输出配置、$ 前缀、Python 代码节点空代码等)需结合具体版本判断,文档给出上游问题编号供核对。