1. 基本信息
项目自述名称：所在仓库自述为「Official n8n Skills」（n8n 官方出品的技能合集插件，插件 ID
n8n-skills）；本技能自身文档标题为「n8n Expressions」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | n8n-expressions-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-expressions-official | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 391 | GitHub API |
| 该子技能单独统计 | GitHub 不提供子目录级 star 数；改查该文件自身的 commit/issue 记录作为佐证（见第 6、8 章） | 说明性备注 |
| Forks | 42 | GitHub API |
| 最新版本 | 插件 v1.1.0 | 仓库 .claude-plugin/plugin.json |
| 安装方式 | Claude Code / Codex 插件市场一条命令；其他平台可用 skills.sh | 官方 README |
2. 功能介绍与亮点
核心能力：教 Claude Code / Codex 等编程 Agent 正确书写与排查 n8n 的表达式语法（{{...}} 块内嵌入的 JavaScript，单条目逐条求值，可访问 $json、$node、Luxon 日期库等上下文）。正文围绕几类高频、容易静默出错的坑展开：
- 按节点名引用，而非依赖
$json：$json在遇到 Aggregate、Code（Run for All）或分支合并等场景会被清空或替换，下游引用会静默拿到错误数据而不报错；改用$('节点名').item.json.field才稳定，重构加中间节点时也不易踩坑。 .all()聚合与逐项执行的边界：.all().map()这类聚合表达式若节点仍是默认逐项执行模式，会为每个输入项重复跑一次完整聚合，浪费算力且结果可能出错；正文给出executeOnce该开不该开的判断树，并区分“聚合”与“按当前项做查找”两种.all()用法。- JSON 字符串化的场景取舍：
.toJsonString()适合塞进 AI 提示词等对 token 敏感的场合，但子工作流返回值、webhook 响应等跨边界数据不应传递字符串化形态，避免下游还要记得手动JSON.parse。 - 文中还列出一张常见表达式错误速查表（如
$env.X在表达式里不生效，配置需用$vars.X或 Data Table，密钥应走凭据系统）。
亮点：全文 21KB，是同仓库 13 个专项技能中最长最系统的一份，把“表达式看起来对但下游悄悄拿错数据”这类没有报错提示、只能靠经验才能发现的陷阱逐一钉死；与姊妹技能（Code 节点取舍见n8n-code-nodes-official、循环与分批见n8n-loops-official）形成明确的交叉引用网络，不是孤立文档。
3. 适用场景
固定分类：集成与工作流自动化
- 用 n8n 搭建自动化流程、需要在节点参数里写
{{}}表达式完成字段转换、条件判断或跨节点取值的开发者； - 表达式报错或结果与预期不符、需要系统性排查
$json/$node引用问题的用户； - 已经用上
executeOnce、.all()等进阶特性，但不确定该不该开的中级 n8n 用户。
受益人群：日常在 n8n 里搭建生产级自动化流程、尤其是流程逐渐复杂到出现多分支/子工作流的初中级开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方
/plugin marketplace add n8n-io/skills+/plugin install n8n-skills@n8n-io一键安装，含 SessionStart/PreToolUse 自动路由钩子。 - Codex：✅ 原生支持——官方文档给出对应的
codex plugin marketplace add/codex plugin add命令（需 Codex ≥ 0.142.0）；仓库内有一条真实用户提交的 PR（#42，非官方成员）专门修复该插件 hooks 在 Windows 上的 Codex 兼容问题。 - OpenClaw：❓ 未验证——README 仅笼统提及“其他平台”可通过 skills.sh 安装，实测 skills.sh 当前列出的受支持平台清单中未点名 OpenClaw。
- Hermes Agent：❓ 未验证——本文件内容经查不涉及任何持久化写入指引；但同一插件包内的姊妹技能
n8n-debugging-official曾被提交仓库 issue（#29）指出含“持久化导向的指引”，因全部技能随插件一次性安装，实际接入效果仍待验证。
5. 推荐理由
n8n 官方团队把“表达式语法看起来简单、实则处处是静默出错陷阱”这件事写成一份系统指南——按节点名而非$json取值的稳定性原则、executeOnce的判断树、字符串化数据的跨边界取舍，都是官方文档没有专门强调、但真实用户会反复踩的坑。21KB 的篇幅在同仓库 13 个专项技能里最详尽，能显著降低“表达式写完看起来没问题，跑起来才发现数据是错的”这类调试成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | n8n 为知名工作流自动化厂商、官方团队亲自出品，仓库整体 391 stars / 42 forks（合集仓库数字，不代表本技能个体热度，见第 1 章说明）；该文件自身仅 1 次改名提交（2026-07-07，n8n 内部工程师），未查到专门针对本文件内容的独立 issue/PR，但同仓库整体近 3 个月有 50+ 次提交、10 个 open issue，含至少 2 位非官方成员的外部用户报告 |
| 可用性 | 9 | Claude Code / Codex 两大主流平台一条命令安装；单文件 21KB，含大量可直接照抄的正确/错误对照代码块与判断树，是同仓库篇幅最完整的一份；仓库近一周（2026-07-26）仍有推送，维护活跃；无付费依赖（本技能本身不需要额外付费服务，仅需已有的 n8n 实例） |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单： ① Shell 命令及权限——本文件是纯 Markdown 指令文档，不执行任何代码；所属插件整体连接一个 MCP server，但地址是安装时用户自填的自己的 n8n 实例 URL，非第三方端点 ② 运行时联网——本文件本身不发起任何网络请求；插件整体的联网范围限定在用户自己的 n8n 实例，用途透明 ③ API key/凭据——正文提示密钥应走 n8n 自身凭据系统，未索取或存储任何密钥 ④ 可疑指令——通读全文未见 prompt injection 或隐蔽指令 ⑤ 作者信誉——n8n 官方组织账号，插件 manifest author 字段为 “n8n” ⑥ License——Apache-2.0，明确 ⑦ 最近维护——仓库 2026-07-26 有推送，处于近 1 个月内
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
czlonkowski/n8n-skills（社区维护，5,948★） |
社区版 n8n 技能集，14 个技能配套作者自己开发的 n8n-mcp fork，含独立路由技能与 hooks 强制层 |
星数远高于官方仓库，但表达式部分是 14 个技能中的其中一项，篇幅与专项深度不及本技能；依赖作者自建的 MCP 实现而非 n8n 官方的实例级 MCP |
n8n-code-nodes-official（同仓库姊妹技能） |
专讲“何时该用 Code 节点而非表达式”的取舍 | 与本技能形成互补而非替代——本技能讲表达式怎么写对，姊妹技能讲什么时候不该用表达式改用代码 |
Code Coup n8n-skills 项目（Medium 文章介绍） |
面向“AI 生成的 n8n 工作流经常跑不通”问题的第三方技能集 | 定位类似但非本合集仓库产物，未见针对表达式语法的专项深度内容 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。所属插件仓库有真实外部用户提交的兼容性反馈：一位非项目成员用户（GitHub 用户 salomaoparkour）提交 PR 修复了插件 hooks 在 Windows 上运行 Codex 时进程残留的问题，另有用户报告了同类 Windows 兼容性故障（issue #40），均已被官方采纳修复。
9. 安装使用方式
- Claude Code（CLI）：会话内运行
/plugin marketplace add n8n-io/skills，再/plugin install n8n-skills@n8n-io，安装时输入自己的 n8n 实例 URL，然后/reload-plugins；随后/mcp中选择n8n-mcp完成浏览器授权。 - Claude Code（桌面版）：同样先添加 marketplace，再在插件面板中安装
n8n-skills，配置实例 URL 后在 Settings → Connectors 中完成授权。 - Codex（需 ≥ 0.142.0）：
codex plugin marketplace add n8n-io/skills→codex plugin add n8n-skills@n8n-io→ 手动codex mcp add n8n-mcp --url https://<你的n8n域名>/mcp-server/http，首次使用时走 OAuth 授权。 - 其他平台：
npx skills add n8n-io/skills（skills.sh），并在AGENTS.md中加入提示片段，引导 Agent 先加载路由技能using-n8n-skills-official。 - 安装后注意事项：需要已有 n8n 实例（Cloud 或自托管均可，最低 2.2.0）并在 Settings 中开启 Instance-level MCP，否则该技能配套的 MCP 工具无法使用；本技能内容本身不依赖 MCP 也可单独阅读参考。
10. 注意事项
- 依赖用户自有的 n8n 实例（最低 2.2.0）开启 instance-level MCP，纯技能文档本身不含可独立运行的组件；
- 同一插件包会一次性安装全部 13 个专项技能 + 1 个路由技能，无法单独只装本技能（除非手动只复制该 SKILL.md 文件）；
- OpenClaw / Hermes Agent 上的实际表现未经验证，建议先在小范围工作流上试用确认路由与钩子行为符合预期。