Skill/流程自动化/n8n Loops
流程自动化 563 仓库 Star

n8n Loops

让多条数据按正确方式处理

n8n Loops 是 n8n 团队维护的循环与批处理 Skill。它先判断数据是否只需按条执行、应整体汇总一次,还是需要显式批次与分页,再选择相应节点设置。适合处理多条记录、接口限流和分页同步,尤其用于排查同一汇总或通知被重复执行的情况。

你需要准备:现有 n8n 流程、接口说明、数据样例和处理频率

一桉AI 整理 · 2026.10.31 更新 · 查看 GitHub 来源

粘贴到 Codex,它会先检查安装条件,再引导你使用。

n8n Loops 能帮你做什么?

  • 分清逐条与整体处理

    检查输入条数和节点模式,明确哪些动作应处理每条记录,哪些汇总、通知只应执行一次。

  • 选择分页与批次方式

    优先使用接口节点自带分页;需要限速、分块或每批控制时再安排显式循环。

  • 验证真实执行次数

    用小样本查看输入、输出与运行记录,检查是否遗漏数据,或因汇合方式产生重复响应。

什么时候适合用?

下面是用法示例,可换成你的材料和目标。

  • 每天同步多页订单

    例如依据接口分页方式获取所有页面,再按服务限流分批处理,核对记录数量与重复情况。

  • 汇总完成后只发一次通知

    例如多条数据处理完后生成一份总结,检查汇总节点和通知节点是否被逐条触发。

怎么开始使用?

从材料到结果流程示意,非实测结果

你提供的材料

准备这些材料批次与分页流程

现有 n8n 流程、接口说明、数据样例和处理频率

处理流程示意

  1. 01

    确认数据与处理方式

  2. 02

    配置批次或接口分页

  3. 03

    验证数量与结束条件

准备什么,会得到什么?

准备的材料
现有 n8n 流程、接口说明、数据样例和处理频率
交付的结果
  • 逐条、汇总、分页或批次的节点配置与流程调整方案。
  • 小样本执行次数、数据数量和重复处理的验证记录。

使用前要知道

需要已连接的 n8n 实例、MCP、OAuth 和服务凭证,并保留完整插件。部分配置接口要求较新版本;批次不等于并发,修改后仍需检查实际运行记录。

常见问题

为什么同一条总结发了几十次?

常见原因是多条输入让汇总或通知节点重复执行。需要核对节点模式、汇总表达式和分支汇合,明确哪些步骤只应执行一次。

只要处理多条数据就要加循环节点吗?

多数节点本身能逐条处理输入。显式批次适合限速、分批恢复等场景,分页接口也应先检查 HTTP 节点已有的分页能力。

GitHub 与官方参考

依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。

  • n8n-loops-official · SKILL.md ↗2026-10-31 核对
  • n8n 官方 Skills · 连接与安装说明 ↗2026-10-31 核对
来源与使用条件
原始项目
n8n-io/skills ↗
Skill 名称
n8n-loops-official
Skill 目录
skills/n8n-loops-official
仓库 Star
563 · 2026-10-31 核对,仅代表仓库关注度。
许可说明
Apache-2.0
使用条件
需要可访问的 n8n 实例,开启 instance-level MCP 并在 Codex 连接、完成 OAuth。官方文档列 n8n 2.2.0+;应核对实际节点版本、API 凭证和限流。按上游文档安装完整插件与参考文件。
注意事项
n8n 团队官方 Skill,README 明确 Codex 支持。安装 Skill 不等于实例、凭证和 MCP 已就绪;节点行为需用样例验证,本站未实测。
查看安装与使用提示词
请帮我准备并使用 n8n Loops Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。

【来源与目标】
原始仓库:https://github.com/n8n-io/skills
所选目录:skills/n8n-loops-official
参考分支:main
原始目录 frontmatter name:n8n-loops-official
安装后的目标调用名:n8n-loops-official
来源页面:https://github.com/n8n-io/skills/tree/main/skills/n8n-loops-official
安装路线核对日期:2026-11-01
n8n-loops-official:当前源 SKILL.md:https://github.com/n8n-io/skills/blob/main/skills/n8n-loops-official/SKILL.md
n8n-io/skills:当前安装说明:https://github.com/n8n-io/skills/blob/main/README.md
n8n:当前 Codex 插件清单:https://github.com/n8n-io/skills/blob/main/.codex-plugin/plugin.json

【先检查环境,再安装】
先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。
下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。
这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。

所选 Skill 的具体安装步骤:
1. 检查 Codex >=0.142.0(当前上游要求 root-plugin marketplace 支持),并识别是否已有 n8n-skills 插件/同名散装目录;避免重复安装。
2. 按当前 README 运行 codex plugin marketplace add n8n-io/skills,然后 codex plugin add n8n-skills@n8n-io,保留整个插件、using-n8n-skills-official 元协议与全部引用资料。
3. 按上游说明重新加载 Codex,在宿主原生界面审阅并信任实际 SessionStart、PreToolUse、PostToolUse Hooks;不把文档复制当成这些 Hooks 已安装。
4. 需要实际操作实例时,先确认用户自有 n8n >=2.2.0,并在 Settings → Instance-level MCP 启用;具体功能还需核对下面列出的版本条件。
5. 需要使用 setNodeSettings 接口时,实例必须为 n8n 2.24+;基础 MCP 下限 2.2.0 不代表这个接口可用。先检查版本,再决定可使用的配置方式。
6. Codex 不会替插件自动配置 MCP。后续获准连接时用 codex mcp add n8n-mcp --url <用户实际实例的 HTTPS 地址>/mcp-server/http,或 GUI Settings → MCP servers → Add server → Streamable HTTP 添加真实 URL;配置后按要求重载。不要提交示例占位域名。
7. OAuth 在首次使用或 Authenticate 中由用户完成;安装验收不连接实例、不登录,也不读取凭据。未认证时只报告插件已具备指南、实例操作尚未就绪。

必须保留的资源:
- 完整 n8n-skills 插件(.codex-plugin/plugin.json、hooks/、skills/)
- skills/using-n8n-skills-official/ 元协议与 n8n-expressions-official、n8n-node-configuration-official 等被引用 Skills
- skills/n8n-loops-official/(完整目录)
- skills/n8n-loops-official/references/LOOP_OVER_ITEMS.md
- skills/n8n-loops-official/references/HTTP_PAGINATION.md
- node-configuration 的 MERGE_NODE.md 与所需 sub-workflows 指南(保持整插件引用)

已知依赖:需要可访问的 n8n 实例,开启 instance-level MCP 并在 Codex 连接、完成 OAuth。官方文档列 n8n 2.2.0+;应核对实际节点版本、API 凭证和限流。按上游文档安装完整插件与参考文件。
原项目许可:Apache-2.0
特别条件:n8n 团队官方 Skill,README 明确 Codex 支持。安装 Skill 不等于实例、凭证和 MCP 已就绪;节点行为需用样例验证,本站未实测。
需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。

【安装后验收】
读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。
1. 本地核对插件来源、Skill、using-n8n-skills-official 与 hooks 配置可读、引用文件存在;仅检查当前已知 Codex/n8n 版本和已有连接状态。
2. 安装验收不创建工作流/表、不发 HTTP 请求、不发布或启动执行。未来已获准连接后优先只读列举目标元数据,分清连接/认证失败与 Skill 文件缺失。
Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。
分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。

【接着引导我使用】
请使用实际可用的 $n8n-loops-official;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。
- 给出真实工作流或数据结构、每页/每批规则、速率限制与期望合并结果;先判断节点原生逐 item 处理、分页还是 Loop Over Items,不无故套循环。
- 先产出草稿与边界检查;实例已连接且写入/运行获准后才实施与样例验证,留意输出数量、终止条件和重试。

我想完成的任务:
检查我的 n8n 数据处理需求和当前流程,确认应逐条处理、只执行一次还是分批分页。配置循环、限流与结束条件,用代表性样例核对输出数量和重复项;发布或调用有写入影响的接口前先交付方案。

需要我提供的材料:
现有 n8n 流程、接口说明、数据样例和处理频率

期望得到:
流程修改或配置方案、样例验证结果,以及重复和限流检查说明。

先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。

相关 Skill

  • n8n Data Tables工作流状态表
  • n8n Error Handling流程错误处理
  • Prospecting潜在客户筛选

复制到 Codex

浏览器暂未允许直接复制。点击下方文字,按 Ctrl+C(Mac 按 ⌘C)复制,再粘贴到 Codex。

三步开始使用

  1. 找到想做的事,点击「复制提示词」。
  2. 打开 Codex,把提示词粘贴进去并发送。
  3. 按它的提示提供文件或材料,继续完成任务。

按需安装就好,不用一次装完。部分 Skill 需要软件、账号或付费服务,Codex 会先检查使用条件。