N8n Validation Expert 说明文档

# n8n 验证专家 为解读和修复 n8n 验证错误提供专家指导。 ## 概述 **技能名称**: n8n 验证专家 **优先级**: 中 **目的**: 解读验证错误，并通过验证循环引导系统性修复 ## 该技能解决的问题 验证错误非常常见： - 验证通常需要迭代（79% 的情况会导致反馈循环） - **7,841 次验证 → 修复周期**（平均 23 秒思考 + 58 秒修复） - 平均 **2-3 次迭代**即可实现有效的配置 **核心见解**：验证是一个迭代过程，而不是一次性修复！ ## 该技能教授的内容 ### 核心概念 1. **错误严重级别** - 错误 (Errors)（必须修复）- 阻塞执行 - 警告 (Warnings)（建议修复）- 不阻塞但提示问题 - 建议 (Suggestions)（可选）- 锦上添花的改进 2. **验证循环** - 配置 → 验证 → 读取错误 → 修复 → 再次验证 - 平均 2-3 次迭代即可成功 - 每个周期平均 23 秒思考 + 58 秒修复 3. **验证配置文件** - `minimal` - 快速检查，最宽松 - `runtime` - 推荐用于大多数用例 - `ai-friendly` - 减少 AI 工作流的误报 - `strict` - 最大安全性，包含许多警告 4. **自动清理系统** - 自动修复算子结构问题 - 在每次保存工作流时运行 - 修复二元/一元算子问题 - 添加 IF/Switch 元数据 5. **误报** - 并非所有警告都需要修复 - 40% 的警告在特定上下文中是可以接受的 - 使用 `ai-friendly` 配置文件可减少 60% 的误报 - 记录已接受的警告 ## 文件结构 n8n-validation-expert/ ├── SKILL.md (690 行) │ 核心验证概念和工作流 │ - 验证理念 │ - 错误严重级别 │ - 验证循环模式 │ - 验证配置文件 │ - 常见错误类型 │ - 自动清理系统 │ - 工作流验证 │ - 恢复策略 │ - 最佳实践 │ ├── ERROR_CATALOG.md (865 行) │ 完整的错误参考及示例 │ - 9 种错误类型及真实示例 │ - missing_required (占错误 45%) │ - invalid_value (28%) │ - type_mismatch (12%) │ - invalid_expression (8%) │ - invalid_reference (5%) │ - operator_structure (2%，自动修复) │ - 恢复模式 │ - 频率总结 │ ├── FALSE_POSITIVES.md (669 行) │ 何时可以接受警告 │ - 警告接受理念 │ - 6 种常见误报类型 │ - 何时可接受