n8n-goal-loop：用九要素Goal驱动n8n工作流开发闭环

一个将n8n工作流需求转化为结构化Goal的Skill，通过四层访谈对齐和九要素契约，解决AI Agent搭建n8n工作流时常见的需求不清、烂尾跑偏问题。

• 原作者/维护者：buluslan（Blue@新西楼.AI）
• 来源平台：GitHub
• 原始标题：n8n-goal-loop
• 原始链接：https://github.com/buluslan/n8n-goal-loop
• 发布时间：2026-06-15

---

当使用AI Agent（如Claude Code、Codex）搭建n8n工作流时，开发者经常遇到一个核心问题：需求没说清楚就开始动手，导致工作流烂尾、功能跑偏、反复修改却永远做不完。

n8n作为低代码自动化平台，节点众多、数据流转复杂，如果没有清晰的需求定义，Agent很容易陷入"走一步看一步"的混乱状态。字段映射错误、错误处理缺失、单点失败拖垮整批任务——这些问题往往源于初始需求的不完整。

---

n8n-goal-loop是一个n8n工作流开发的Goal生成Skill。它不直接搭建或运行工作流，而是通过结构化的需求对齐流程，帮助用户想清楚工作流的目标、节点链路和交付结果，然后生成一份可直接使用的九要素Goal，驱动Agent完成从构建到测试的完整闭环。

项目基于agent-skills标准，兼容Claude Code、Codex、Cursor、OpenClaw等主流Agent环境。

---

在通用七要素基础上，n8n-goal-loop针对n8n场景新增两个关键要素，形成完整的九要素契约：

序号	要素	核心问题	说明
1	目标结果	要搭什么工作流？	节点链路（输入→处理→输出）+ 最终交付什么
2	数据流契约	数据怎么在节点间流转？	字段映射、输入输出格式——n8n最大坑源
3	错误处理	节点失败了怎么办？	continueOnFail、兜底存储、降级策略
4	验证	怎么证明做成了？	分层测试：脚本测试+端测
5	约束	什么不能碰？	n8n红线：不破坏数据库、不硬编码密钥等
6	边界	只能改哪里？	只动目标工作流，不碰其他工作流和凭证
7	迭代策略	失败后怎么继续？	先小样本跑通，PUT后刷新缓存，最多3轮
8	完成条件	什么时候算完工？	端测全过+业务字段有真实值
9	暂停条件	什么时候停下来问人？	需真实凭证、发布激活、涉及资金、实例异常

标⭐的"数据流契约"和"错误处理"是n8n专属新增。这两个要素正是n8n工作流最容易出问题的地方：字段丢失导致下游节点失败、静默失败导致数据不一致、单点失败拖垮整批任务。

---

n8n工作流复杂，不能期望一次性生成完美Goal。Skill采用四层访谈机制，确保需求充分对齐：

第一层：目标与交付 明确工作流要解决什么问题，最终要产出什么结果。

第二层：节点链路 梳理输入→处理→输出的完整链路，确定每个节点的职责。

第三层：具体服务确认 明确使用的表格服务、AI模型、API接入方式等具体技术选型。

第四层：红线划定 明确绝对不能触碰的边界，如生产数据库、敏感凭证等。

这四层访谈确保在动手写代码之前，用户和Agent对需求有共同理解。

---

Skill内置11个references知识库，覆盖：

• 九要素详解
• 访谈框架
• 6类高频踩坑（节点参数版本、数据流与引用、Code节点沙箱、jsonBody与表达式、凭证与API、实例与部署）
• n8n设计规范
• 代码片段
• 运维规范（SQLite/PG/检查清单）
• 分层测试方法论
• n8n-skills最佳实践
• 环境管理

这些知识库在生成Goal时自动参考，把踩过的坑预编进约束和迭代策略，实现"预防胜于治疗"。

---

生成的Goal会经过lint检查，确保：

• 九要素齐全
• 无方括号占位符（如[待填写]）
• 无危险词（如"直接操作数据库"）

这种把关机制防止Agent带着不完整的Goal进入执行阶段。

---