1. 基本信息
项目自述名称：所在仓库自述为「n8n Skills」（n8n 官方出品的技能合集插件，插件 ID
n8n-skills）；本技能自身文档标题为「n8n Sub-workflows」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | n8n-subworkflows-official-n8n-io-skills | — |
| 作者/维护者 | n8n 团队（官方组织 n8n-io，插件 manifest 标注 author: n8n，主页 n8n.io） | GitHub API + 仓库 .claude-plugin/plugin.json |
| 来源链接 | https://github.com/n8n-io/skills/tree/main/skills/n8n-subworkflows-official | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 376 | GitHub API |
| 该子技能单独统计 | GitHub 不提供子目录级 star 数；改查该文件自身的 commit/issue 记录作为佐证（见第 6、8 章） | 说明性备注 |
| Forks | 39 | GitHub API |
| 最新版本 | 插件 v1.1.0 | 仓库 .claude-plugin/plugin.json |
| 安装方式 | Claude Code / Codex 插件市场一条命令；其他平台可用 skills.sh 或手动复制 SKILL.md | 官方 README |
2. 功能介绍与亮点
核心能力：教 Claude Code / Codex 等编程 Agent 在 n8n 里正确使用子工作流（Sub-workflow，n8n 里“可复用函数”的实现方式）——用 Execute Workflow Trigger 声明输入参数、主体做事、末节点返回输出，调用方像调用普通节点一样调用它。正文开篇即点破痛点：不用子工作流时，同一段逻辑会散落在多个 workflow 里各自维护，改一处漏一处、“看似相同”的副本悄悄跑偏。围绕这个痛点给出一套完整决策框架：一张“该不该抽取子工作流”的判断树（可复用性/节点数/是否为通用关注点/是否只是单次 HTTP 调用）、无状态 vs 有状态两类子工作流的区分与各自的正确写法、Execute Workflow Trigger 的“Define Below”类型化字段与两种 passthrough 例外场景（二进制数据、零输入子工作流）、调用方 mode: 'all' 与 'each'（唯一的真并行手段）的选择依据、以及“发现优先于重建”的搜索前置协议（按 tags/query 检索已有子工作流，避免重复造轮子）。附带 11 条反模式对照表与 2 篇专项参考文档（命名与发现规范、三类进阶模式）。
亮点：
- 把“审计日志”这种常见的旁路副作用抽象为“fire-and-forget”有状态子工作流的标准范式（
waitForSubWorkflow: false），并明确提醒“不要因为用户没要求就加审计日志”，避免过度设计； - 反模式表点出一个容易踩坑但官方文档少提的细节：子工作流被命名/描述为“纯函数”却悄悄写日志表，会让调用方误判可安全重试，正文给出“要么把副作用写进契约，要么移出去”两条明确修法；
- n8n 官方团队亲自打造并维护（README 明示“Built by the n8n team”），子目录本身在 2026-07-20 有过一次针对 n8n 2.27.0 新版 tag 检索机制的实质性内容更新，随插件版本持续迭代而非一次性产物。
3. 适用场景
固定分类：集成与工作流自动化
- 已经在用 n8n 搭建自动化 workflow、发现同一段逻辑（日期解析、鉴权校验、通知发送等）在多个 workflow 里重复出现的开发者；
- 需要设计 20+ 节点的复杂 workflow、想用子工作流把线性主流程拆成可读、可单独测试、可替换实现的模块的场景；
- 需要“发起后不等待”的并行处理（如批量派发独立任务、逐条落库轮询完成状态）、想知道 n8n 里唯一的真并行手段该怎么正确搭的团队。
受益人群：已经或计划用 n8n 搭建中大型自动化流程、对“什么时候该抽取子工作流、抽取后契约怎么设计”缺乏经验的初中级开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方
/plugin marketplace add n8n-io/skills+/plugin install n8n-skills@n8n-io一键安装，README 逐步给出命令。 - Codex：✅ 原生支持——官方文档给出对应的
codex plugin marketplace add/codex plugin add命令（需 Codex ≥ 0.142.0）。 - OpenClaw：❓ 未验证——README 仅笼统提及“其他平台”可尝试 skills.sh（
npx skills add n8n-io/skills），未点名验证 OpenClaw，skills.sh 官网当前公开支持列表中也未见该仓库上榜。 - Hermes Agent：❓ 未验证——同一插件包内另一姊妹技能
n8n-debugging曾被 Hermes 内置安全扫描器标记为 dangerous 拦截安装（因排障指引涉及向 workflow 文件写入 issue 编号，被判定为“持久化”风险），本技能内容经查未见同类持久化指引，但由于全部技能随插件一次性安装，实际接入效果仍待验证。
5. 推荐理由
n8n 官方团队出品，把“什么时候该抽取子工作流”这个初学者最容易凭直觉乱来的判断，钉成一张可直接照做的决策树，并配上无状态/有状态两类契约设计规范、mode: 'all' vs 'each' 的并行语义辨析、“发现优先于重建”的搜索协议。11 条反模式表覆盖的坑（重复造轮子、副作用悄悄污染“纯函数”契约、passthrough 误用导致 Agent 工具传不进参数）都是实际生产 workflow 里会真实发生、但官方主文档不会展开讲的细节。2 篇专项参考文档进一步把命名/发现规范与三类进阶模式讲透，降低“看懂原则”到“落地成可维护子工作流库”之间的门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | n8n 为知名工作流自动化厂商、官方团队亲自出品，仓库整体 376 stars（合集仓库数字，不代表本技能个体热度，见第 1 章说明）；经查本文件自身的 commit（2 次，均为 n8n 内部工程师提交）与 issue 记录（2 条，均由同一内部工程师报告并关闭），目前尚未查到独立第三方对本文件本身的公开评价或直接代码贡献 |
| 可用性 | 8 | Claude Code / Codex 两大主流平台均一条命令安装；正文含判断树、无状态/有状态契约对照、11 条反模式表，另有 2 篇专项参考文档系统覆盖命名/发现与进阶模式；子目录 2026-07-20 有过针对新版本特性的实质更新，非一次性产物；依赖预先开启 MCP server 的 n8n 实例作为前置条件，非纯开箱即用 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 7.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令权限范围 | 本技能自身不含可执行脚本，仅指导 Agent 调用用户已授权的 n8n MCP 工具，未见越权行为，未扣分 |
| ② 运行时联网外发 | 未发现独立于用户自有 n8n 实例之外的外发行为 |
| ③ API key/凭据存储 | 本技能不直接处理凭据（凭据处理由姊妹技能 n8n-credentials-and-security-official 专项覆盖），内容中未见要求用户提供密钥的指引 |
| ④ 可疑指令/注入迹象 | 本技能文本未见可疑指令。但同一插件包内的姊妹技能 n8n-debugging 曾被独立用户举报存在“持久化 issue 编号到 workflow 文件”问题并被 Hermes Agent 安全扫描器标记为 dangerous，截至目前仍处 open 状态尚未修复——与本技能内容无直接关系，但因随同一插件整体安装，计入扣分 |
| ⑤ 作者/组织信誉 | n8n 为知名工作流自动化厂商，官方组织 n8n-io，插件 manifest（author: n8n，homepage: n8n.io）可核验，未扣分 |
| ⑥ License 明确性 | Apache-2.0，明确，未扣分 |
| ⑦ 最近维护时间 | 仓库最近提交 2026-07-26，本文件所在子目录最近实质更新 2026-07-20，持续维护，非弃置项目，未扣分 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 官方程度 / 热度证据 | 与本技能的差异 |
|---|---|---|---|
| n8n-subworkflows-official（本技能，n8n 官方） | n8n 内子工作流封装、复用与发现专项指南 | 官方仓库，本文件由 n8n 团队持续维护 | 专项深度：判断树 + 契约设计规范 + 并行语义辨析 + 发现协议，覆盖“要不要抽取、抽取后怎么设计”的完整决策面 |
| n8n-workflow-lifecycle-official（同仓库姊妹技能） | n8n workflow 全生命周期方法论（建模/测试/调试/影响评估） | 官方仓库，同等热度证据 | 广度优先：子工作流只是其中“可读性”一节里的简单提及，未展开契约设计、并行模式等专项细节 |
| n8n-agents-official（同仓库姊妹技能） | AI Agent/LangChain 节点专项建造指南 | 官方仓库，本文件由 n8n 团队持续维护 | 场景互补而非重叠：Agent 建造中“把子工作流当 Agent 工具”是本技能内容的下游消费场景，二者互相引用但各自专注不同决策面 |
| czlonkowski/n8n-skills（社区版技能合集） | 覆盖 n8n Agent、代码节点、表达式、自托管等 15 个技能，内含结构和文件命名高度相近的子工作流技能 | 社区维护，仓库 5,891 stars，规模远超官方仓库；对应技能最后一次更新为 2026-06-17，此后无新提交 | 内容体量接近（社区版约 19.5KB vs 官方版约 22.7KB）疑似同源演化，但官方版本更新更频繁（跟进 n8n 2.27.0 新版标签检索机制），社区版尚未同步 |
核心差异化：本技能不是“n8n 支持子工作流”这一事实的简单说明，而是把“什么时候该抽取、抽取后契约怎么设计、副作用怎么不污染纯函数假设、真并行怎么正确搭”这几个容易被忽视的具体决策点拆解成可直接执行的规则与反模式对照，专项深度明显超过覆盖全生命周期的姊妹技能里对子工作流的简单提及。
8. 用户评价
该技能目前在第三方平台尚无独立评价文章。可查的具名证据来自 GitHub 仓库自身：本文件的 2 次提交与 2 条相关 issue 均由 n8n 内部工程师（liamdmcgarrigle、Nikhil Kuriakose）提交与处理，反映的是官方团队自身的持续投入，截至目前未查到与本文件直接相关的外部独立开发者评论或贡献记录。
9. 其他补充
同仓库另有 12 个专项技能（工作流生命周期、AI Agent 建造、凭据安全、循环分页、错误处理、二进制数据处理等）与 1 个路由入口技能 using-n8n-skills-official，随插件一次性安装，共享同一套 hook 自动路由机制。仓库明确欢迎社区为其他编程 Agent（Cursor、OpenCode 等）贡献适配插件。
10. 安装使用方式
Claude Code（官方推荐）：
/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io安装时会提示填写 n8n 实例 URL，随后运行 /reload-plugins 生效。
Codex：
codex plugin marketplace add n8n-io/skills
codex plugin add n8n-skills@n8n-io重启后首次运行会提示信任插件 hooks，需批准以启用自动路由提醒；另需手动添加 MCP 服务器：
codex mcp add n8n-mcp --url https://<你的n8n域名>/mcp-server/http其他平台（OpenClaw / Hermes 等，非官方支持）：
npx skills add n8n-io/skills需自行在 AGENTS.md 中补充片段，引导 Agent 每次涉及子工作流设计的 n8n 任务时主动加载本技能——通用安装方式没有 hook 自动触发，退化为纯文档。
前置条件：需要一个已开启实例级 MCP server 的 n8n 实例（Cloud 或自托管均可，最低 n8n 2.2.0，本技能用到的 tags 检索需 n8n 2.27.0+），在 n8n 的 Settings → Instance-level MCP 中启用。
11. 注意事项
- 需要预先具备已开启 MCP server 的 n8n 实例，单纯装技能无法替代该前置配置；标签检索功能需 n8n 2.27.0 以上版本，低版本实例只能用关键词检索退化使用；
- 同插件包内的姊妹技能
n8n-debugging存在尚未修复的安全披露（被 Hermes Agent 安全扫描器标记为 dangerous），若计划在 Hermes 环境使用同一插件包，建议关注该 issue 的后续修复进展； - Hook 自动路由能力目前限 Claude Code / Codex 插件系统，OpenClaw / Hermes 等平台需手动配置
AGENTS.md片段才能获得同等的“自动提醒”体验； - 本技能自身暂未查到独立第三方公开评价或直接代码贡献，目前的维护活跃度主要体现为官方团队自身的持续投入。