1. 基本信息
项目自述名称：所在仓库自述为「n8n Skills」（n8n 官方出品的技能合集插件，插件 ID
n8n-skills）；本技能自身文档标题为「n8n Agents」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | n8n-agents-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-agents-official | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 374 | 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 里正确构建 AI 功能——Agent 节点、Text Classifier、Information Extractor、情感分析、摘要链、单次 LLM 调用、embedding/向量库、AI 媒体生成等一整套 LangChain 原生节点。开篇即给出一张决策树：需要工具调用/多轮/记忆选 Agent，纯单次文本输出选 Basic LLM Chain，按自然语言分支路由选 Text Classifier，避免“什么都用 Agent 硬套”。正文逐条覆盖 Agent 的四个子节点槽位（模型/记忆/工具/输出解析器）、聊天触发器的会话 ID 处理、结构化输出的 autoFix 重试模式，并附 9 条反模式对照表（如“工具名取 doStuff 导致模型选不中”“把媒体生成塞进 Agent 导致二进制丢失”“聊天 Bot 未过滤自身消息导致死循环”）。附带 8 篇专项参考文档（工具设计、系统提示词、结构化输出、记忆、RAG、人工复核、子工作流当工具、多平台聊天 Agent 模式）与 3 份可直接复用的工作流 JSON 范例。
亮点：
- “人工复核”一节把“要不要给工具加审批”明确定义为产品/策略决策，要求 Agent 主动向用户提出问题而非替用户拿主意，且强调审批消息必须展示工具将收到的实际参数而非模型转述文本，防止用户“批准了一段复述、而非真实调用”；
- 反模式表把二进制数据穿越 Agent 边界这一容易踩坑但官方文档少提的问题讲透：模型可以“看见”上传的图片，但工具收不到二进制、Agent 输出格式化器也吐不出二进制，唯一正确做法是媒体生成走供应商原生单次调用节点；
- n8n 官方团队亲自打造并维护（README 明示“Built by the n8n team”），而非社区逆向工程，随插件版本持续迭代。
3. 适用场景
固定分类：集成与工作流自动化
- 用 Claude Code / Codex 通过 n8n MCP 搭建带 AI 能力的自动化 workflow（客服机器人、内容分类、信息抽取、RAG 检索等）的开发者；
- 需要给 Agent 挂载工具（Slack/Gmail 集成、子工作流、自定义 HTTP API）且担心工具选择错误或参数幻觉的场景；
- 涉及发送、支付、退款等有实际影响的工具动作、需要设计人工审批环节的团队。
受益人群：已经或计划用 n8n 搭建 AI Agent 类自动化流程、对 LangChain 节点选型与工具设计缺乏经验的初中级开发者。
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 官方团队出品，针对“AI Agent 建 workflow”这一当下最热门也最容易踩坑的场景，把节点选型决策树、四个子节点槽位的正确用法、二进制数据边界、结构化输出重试模式钉成可直接照做的规则，而不是泛泛的“参考官方文档”。人工复核一节对“审批消息必须展示真实参数而非模型转述”的强调，体现出对生产事故（批准了错误发生）的真实预判，而非纸面规范。附带的 3 份工作流 JSON 范例可直接照抄改造，降低从“看懂”到“用上”的门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | n8n 为知名工作流自动化厂商、官方团队亲自出品，仓库整体 374 stars（合集仓库数字，不代表本技能个体热度，见第 1 章说明）；经查本文件自身的 commit 与 issue 记录，目前主要由 n8n 内部工程师主导维护与自查（如 Issue #11 由团队成员自报 Information Extractor 未采用 outputParser 子节点的文档缺口并跟进），暂未查到独立第三方对本文件本身的公开评价或直接代码贡献 |
| 可用性 | 9 | Claude Code / Codex 两大主流平台均一条命令安装；正文附决策树、四类工具选型对照、9 条反模式表，另有 8 篇专项参考文档与 3 份可直接复用的工作流 JSON 范例，“看懂即可用”完整度高；仓库持续维护（最近提交 2026-07-26）；依赖预先开启 MCP server 的 n8n 实例作为前置条件，非纯开箱即用 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.67 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① 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-04-20 创建，最近提交 2026-07-26，持续更新，非弃置项目，未扣分 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 官方程度 / 热度证据 | 与本技能的差异 |
|---|---|---|---|
| n8n-agents-official（本技能，n8n 官方） | n8n 内 AI Agent/LangChain 节点专项建造指南 | 官方仓库，本文件由 n8n 团队持续维护并自查 | 专项深度：节点选型决策树 + 工具设计 + 人工复核 + 二进制边界，覆盖 AI Agent 建造的完整决策面 |
| n8n-credentials-and-security-official（同仓库姊妹技能） | 凭据/密钥认证专项安全指南 | 官方仓库，本文件曾有独立开发者提交并合并的 PR | 场景互补而非重叠：专注认证与密钥，不涉及 Agent 节点选型或工具设计 |
| czlonkowski/n8n-skills（社区版技能合集） | 覆盖 n8n Agent、代码节点、表达式、自托管等 15 个技能 | 社区维护，仓库 5,881 stars，规模远超官方仓库 | 广度优先：AI Agent 相关内容作为其中一个技能存在，未展开到子节点槽位、反模式表与人工复核这一细颗粒度 |
| n8n-workflow-lifecycle-official（同仓库姊妹技能） | n8n workflow 全生命周期方法论 | 官方仓库，同等热度证据 | 广度优先：AI Agent 只是六阶段流程中的一环，未展开工具设计、结构化输出重试等专项细节 |
核心差异化：本技能不是“n8n 里如何使用 AI 节点”的泛泛说明，而是把 Agent 建造中最容易出错的节点选型、工具描述设计、二进制边界、审批消息真实性等具体决策点拆解成可直接执行的规则与反模式对照，专项深度明显超过覆盖全生命周期或社区版技能包里泛泛提及 AI 能力的同类条目。
8. 用户评价
该技能目前在第三方平台尚无独立评价文章。可查的具名证据来自 GitHub 仓库自身：Issue #11（记录 Information Extractor 节点未采用 outputParser 子节点的文档缺口）由 n8n 团队工程师本人报出并跟进，反映的是官方持续自查而非独立第三方评价。截至目前未查到与本文件直接相关的外部独立开发者评论或贡献记录。
9. 其他补充
同仓库另有 12 个专项技能（工作流生命周期、凭据安全、循环分页、错误处理、二进制数据处理等）与 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 每次涉及 AI Agent 建造的 n8n 任务时主动加载本技能——通用安装方式没有 hook 自动触发，退化为纯文档。
前置条件：需要一个已开启实例级 MCP server 的 n8n 实例（Cloud 或自托管均可，最低 n8n 2.2.0），在 n8n 的 Settings → Instance-level MCP 中启用。
11. 注意事项
- 需要预先具备已开启 MCP server 的 n8n 实例，单纯装技能无法替代该前置配置；
- 同插件包内的姊妹技能
n8n-debugging存在尚未修复的安全披露（被 Hermes Agent 安全扫描器标记为 dangerous），若计划在 Hermes 环境使用同一插件包，建议关注该 issue 的后续修复进展； - Hook 自动路由能力目前限 Claude Code / Codex 插件系统，OpenClaw / Hermes 等平台需手动配置
AGENTS.md片段才能获得同等的“自动提醒”体验； - 插件版本仍处 v1.1.0，仓库创建于 2026-04-20，历史积累约 3 个月，长期可持续性有待观察；本技能自身暂未查到独立第三方公开评价或直接代码贡献，目前的维护活跃度主要体现为官方团队自身的持续投入。