用途
n8n-agents-review 是一个用于审查 n8n 工作流及相关代码的检查清单式技能。其目标是在部署前发现 n8n 工作流 JSON、自定义节点代码、凭据定义、部署配置和 Code 节点内容中的错误与反模式，减少生产环境故障。
主要能力
该技能按审查对象提供对应的检查区域，包括：
- 工作流 JSON 校验：检查 nodes[] 中每个节点的 id、name、type、typeVersion、position、parameters 等必填字段，以及工作流根对象的 id、name、active、nodes、connections 字段。
- 连接布线校验：验证 IConnections 三级嵌套结构、连接引用名称与节点名称匹配、连接类型与索引合法性、触发器节点无入边、多输出节点输出数组数量正确（如 IF 节点 main 恰好两个数组）。
- 表达式校验：检查 {{ ... }} 中变量引用的上下文可用性，验证 $jmespath 参数顺序（对象在前、搜索字符串在后），禁止引用不存在节点。
- 凭据校验：检查 ICredentialType 实现的 name、displayName、properties、authenticate 等字段，验证 authenticate.type 为 'generic'，凭据表达式使用 $credentials 前缀，禁止硬编码凭据。
- 节点类型校验：检查 INodeType 实现的 description、execute() 返回类型（Promise<INodeExecutionData[][]>）、触发器节点 inputs 与 group 设置、属性类型与 displayOptions 引用、credentials 数组名称匹配等。
- 错误处理校验：检查错误工作流配置、continueOnFail 输出格式、重试配置、Error Trigger 工作流、onError 设置。
- 部署校验：检查 N8N_ENCRYPTION_KEY、NODE_ENV、N8N_PROTOCOL、WEBHOOK_URL、设置文件权限、N8N_RUNNERS_ENABLED、持久化卷挂载；队列模式额外检查 PostgreSQL、EXECUTIONS_MODE、Redis、共享加密密钥、S3 二进制存储等。
- Code 节点校验：检查返回格式、禁止使用 $itemIndex 与 $secrets、禁止在 Code 节点发起 HTTP 请求或直接访问文件系统、Python 使用括号表示法、二进制数据通过 helper 访问等。
- 安全校验：检查无硬编码凭据、加密密钥显式配置、任务运行器启用、文件访问限制、设置文件权限、环境变量访问阻断、Webhook 认证、HTTPS 强制、安全 Cookie 等。
- 反模式检测：扫描表达式、Code 节点、凭据、部署、工作流等类别的反模式清单。
使用方式
技能提供决策树，根据审查对象选择检查章节：
- 工作流 JSON 文件：执行第 1、2、3、6、10 节检查。
- 自定义节点代码：执行第 5、6、10 节检查（如使用凭据则加第 4 节）。
- 凭据定义：执行第 4 节检查。
- Code 节点内容：执行第 8、10 节检查。
- 部署配置：执行第 7、9 节检查。
- 完整项目审计：依次执行全部章节。
检查完成后，按提供的报告模板输出审查报告，包含目标、类型、日期、汇总统计、关键失败项、警告项和检测到的反模式。
适用场景
适用于在部署前审查 n8n 工作流 JSON、自定义节点代码、凭据定义、Code 节点内容或部署配置，也适用于对 n8n 项目执行完整审计。
限制
该技能为检查清单与审查指南，不自动执行代码或修改工作流；具体检查项以资料列出的内容为准，未列出的功能暂未提供。