1. 基本信息
项目自述名称：所在仓库自述为「n8n Skills」（n8n 官方出品的 14 技能合集插件，插件 ID
n8n-skills）；本技能自身文档标题为「n8n Workflow Lifecycle」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | n8n-workflow-lifecycle-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-workflow-lifecycle-official | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 323 | GitHub API（认证 token 档） |
| 该子技能单独统计 | 无法单独统计——GitHub 不提供子目录级 star 数；改用该子技能相关的 Issue/PR 活跃度作为热度证据（见第 6、8 章） | 说明性备注 |
| Forks | 30 | GitHub API |
| 最新版本 | 插件 v1.0.0 | 仓库 .claude-plugin/plugin.json |
| 安装方式 | Claude Code / Codex 插件市场一条命令；其他平台可用 skills.sh 或手动复制 SKILL.md | 官方 README |
2. 功能介绍与亮点
核心能力：教 Claude Code / Codex 等编程 Agent 按「计划→构建→校验→测试→发布→交接」六阶段流程正确搭建 n8n workflow（配合 n8n 官方 MCP server）。内置常见反模式清单——例如明确指出“validation 通过≠可以发布”，还需 get_workflow_details 二次核验 connections 字段，因为校验只查 schema，查不出连接被静默漏挂的问题；同时纠正“fan-out 会并发执行”等常见误解（n8n 实际按画布 Y 坐标从上到下顺序执行分支）。附带按 MUST FIX / SHOULD FIX / NICE TO HAVE 严重度分级的 Review Checklist，可用于审查任何人、任何时期搭建的既有 workflow。
亮点：
- n8n 官方团队亲自打造并维护（README 明示 “Built by the n8n team”），而非社区逆向工程；
- 属于同仓库 14 个官方技能中路由的“元技能”入口所指向的核心流程技能，其余 12 个技能覆盖循环分页、凭据安全、错误处理、子工作流复用等专项场景，形成完整方法论矩阵；
- 配套 SessionStart / PreToolUse hook，在高风险 MCP 调用（
publish_workflow、execute_workflow等）前自动提醒查阅对应技能，降低“Agent 忘记查资料”的常见失败模式； - 明确要求密钥类信息一律走 n8n 凭据系统、不得写入文本字段。
3. 适用场景
固定分类：集成与工作流自动化
- 用 Claude Code / Codex 通过 n8n MCP 连接 Gmail、Slack、数据库等第三方服务搭建自动化 workflow 的开发者；
- 需要 Agent 正确处理 n8n 特有陷阱（Merge 节点默认 2 输入、Loop Over Items 与默认逐条迭代的取舍等）的团队；
- 需要统一多人 / 多 Agent 产出的 workflow 质量、并对既有 workflow 做安全 / 规范审查的场景。
受益人群：已经或计划把 n8n 作为业务自动化中枢、希望用 Agent 辅助搭建而非从零试错的初中级团队。
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命令，首次运行会提示信任插件 hooks。 - OpenClaw：❓ 未验证——README 仅笼统提及“其他平台”可尝试 skills.sh（
npx skills add n8n-io/skills），并注明“各平台兼容性不同，以 skills.sh 页面为准”，未点名验证 OpenClaw，未为此单独发起搜索。 - Hermes Agent：⚠️ 需适配——有真实证据显示已有用户在 Hermes 环境中使用同仓库技能（GitHub Issue #29，2026-07-04），但该案例中同仓库另一子技能
n8n-debugging被 Hermes 内置安全扫描器标记为 dangerous 并拦截；本技能（workflow-lifecycle）未见同类拦截记录，但未逐一验证。且 hook 自动路由能力目前限 Claude Code / Codex 插件系统，Hermes 若走通用 skill 安装则需手动在AGENTS.md中补充路由片段。
5. 推荐理由
n8n 官方团队亲自出品并维护，配合官方 MCP server 权威度高；六阶段流程与反模式清单体现的是真实生产经验，而非泛泛而谈的最佳实践罗列；hook 驱动的自动路由机制把“该查哪份文档”这件事从 Agent 的自觉性转移到系统设计上。对已经或计划用 n8n 做自动化中枢的团队，能明显降低“AI 生成的 workflow 看起来正确、上线后才暴露连接漏挂 / 权限出错”的常见风险。
6. 评分
| 维度 | 分数 |
|---|---|
| 受欢迎程度 | 7 |
| 可用性 | 9 |
| 安全性 | 8 |
| 综合 | 8.0 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令权限范围 | SessionStart / PreToolUse hook 均为本地 bash 脚本，仅读取本地 SKILL.md 文件并注入 additionalContext，未见风险执行，未扣分 |
| ② 运行时联网外发 | 未发现本技能有外发行为；源码中标注的“插件版本 / n8n 版本 drift 检测”功能在 v0.2 才会引入网络请求，当前 v1.0.0 尚未实现，未扣分 |
| ③ API key/凭据存储 | 技能本身不索取、不持有任何凭据；明确要求“密钥必须走 n8n 凭据系统，不得写入文本字段”，良好实践 |
| ④ 可疑指令/注入迹象 | 本技能文本未见可疑指令；但同仓库姊妹技能 n8n-debugging 于 2026-07-04 被独立用户在 Issue #29 举报“引导把 issue 编号持久化写入 workflow 文件”，Hermes Agent 安全扫描器已标记为 dangerous，截至本次运行（2026-07-14）该 issue 仍处 open 状态、尚未修复——与本技能无直接关系，但如实披露并计入扣分 |
| ⑤ 作者/组织信誉 | n8n 为知名工作流自动化厂商，官方组织 n8n-io，插件 manifest（author: n8n，homepage: n8n.io）可核验，未扣分 |
| ⑥ License 明确性 | Apache-2.0，明确，未扣分 |
| ⑦ 最近维护时间 | 仓库 2026-04-20 创建，最近提交 2026-07-07（报告撰写前约 1 周），持续更新，非弃置项目，未扣分 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 官方程度 / 热度证据 | 与本技能的差异 |
|---|---|---|---|
| n8n-workflow-lifecycle-official（本技能，n8n 官方） | n8n workflow 全生命周期方法论 + 严重度分级 review checklist | 官方仓库 323 stars、issue/PR 活跃可查 | 深度优先：把“connect 到的服务用对”做成完整方法论，而非单纯“连更多服务” |
| gws-workflow-meeting-prep（googleworkspace/cli 子技能） | Google Workspace 单点自动化（会前准备：日程+参会人+关联文档） | 官方（Google），整仓库 29,672 stars（按特殊规则一不可直接归属子技能） | 文档为 CLI 自动生成的 flag 说明，篇幅短、深度不及本技能的六阶段方法论；且 gws-shared 前置文档中含“引导 Agent 提醒用户 star 仓库”的轻度自我推广指令 |
| WadeWarren/gws-claude-plugin | 社区插件，把 gws CLI 92 个技能封装进 Claude Code 插件系统 | 社区，34 stars | 差异化叙事清晰（对比 Claude 原生连接器），但创建后近 4 个月无任何新提交 |
| Aident-AI/aident-skill | 通用 App 连接器，宣称接入 1000+ 服务 / 27000+ 动作 | 社区，1 star | 定位为“广度优先的万能连接”，成熟度与文档深度证据不足 |
| ComposioHQ Connect（composio-plugin-cc） | 通用 App 连接器，OAuth 托管接入 1000+ 服务 | 背后为知名开发者工具公司 Composio，该插件仓库 6 stars | 同为广度优先型工具，未见针对单一场景的深度规范化文档 |
核心差异化：本技能不是“连接更多服务”型广度工具，而是“把 connect 到的服务（n8n）用对”的深度方法论，配合 hook 自动路由，官方团队维护、生产经验驱动。
8. 用户评价
本次仅收集到 1 条经实际抓取核实的社区互动，且为技术性问题反馈而非正面评价：kristianism（GitHub 用户）——来源：https://github.com/n8n-io/skills/issues/29（2026-07-04）。反映同仓库另一子技能 n8n-debugging 存在“持久化 issue 编号到 workflow 文件”的安全疑虑，并附上 Hermes Agent 安全扫描器的拦截详情；仓库维护者 liamdmcgarrigle 已跟进询问细节，截至本次运行仍在讨论中。该 issue 与本技能（workflow-lifecycle）无直接关系，仅作为同仓库社区活跃度与厂商响应速度的佐证，已在第 6 章安全清单中披露。本次未收集到针对本技能的独立正面评价来源，如实说明，不为凑数追加抓取。
9. 其他补充
插件采用 SessionStart / PreToolUse / PostToolUse 三类 hook，自动路由到其余 12 个专项技能（循环分页、凭据安全、错误处理、Agent 节点配置、二进制数据等），形成整体方法论矩阵；第 14 个技能 using-n8n-skills-official 是路由入口，由 SessionStart hook 在每次会话启动时自动加载。仓库明确欢迎社区为其他编程 Agent（Cursor、OpenCode 等）贡献适配插件。
10. 安装使用方式
Claude Code（官方推荐）：
/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io重启 Claude Code 后自动加载（SessionStart hook）。
Codex：
codex plugin marketplace add n8n-io/skills
codex plugin add n8n-skills@n8n-io重启后首次运行会提示信任插件 hooks，需批准以启用 SessionStart / PreToolUse 提醒。
其他平台（OpenClaw / Hermes 等，非官方支持）：
npx skills add n8n-io/skills需自行在 AGENTS.md 中补充片段，引导 Agent 每次 n8n 任务开始时先加载 using-n8n-skills-official 元技能——因为通用安装方式没有 hook 自动触发，退化为纯文档。
前置条件：需要一个已开启实例级 MCP server 的 n8n 实例（Cloud 或自托管均可，见 n8n 官方 MCP 文档）。
11. 注意事项
- 需要预先具备已开启 MCP server 的 n8n 实例，单纯装技能无法替代该前置配置；
- 同仓库姊妹技能
n8n-debugging存在尚未修复的安全披露（Issue #29，持久化 issue 编号到 workflow 文件），已被 Hermes Agent 安全扫描器标记，若同时启用该姊妹技能建议关注后续修复进展； - Hook 自动路由能力目前限 Claude Code / Codex 插件系统，OpenClaw / Hermes 等平台需手动配置
AGENTS.md片段才能获得同等的“自动提醒”体验，否则退化为纯文档，依赖 Agent 自觉查阅； - n8n 平台本身在 2026 年初曾被独立安全媒体披露存在认证后沙箱逃逸的高危漏洞（属于 n8n 核心产品的历史安全事件，与本技能无直接关系），建议自托管用户保持 n8n 实例更新到最新版本；
- 插件仍是 v1.0.0 首个正式版本，仓库创建于 2026-04-20，历史积累约 3 个月，长期可持续性有待观察。