1. 基本信息
项目自述名称：所在仓库自述为「n8n Skills」（n8n 官方出品的技能合集插件，插件 ID
n8n-skills）；本技能自身文档标题为「n8n Data Tables」。
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | n8n-data-tables-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-data-tables-official | — |
| 许可证 | Apache-2.0 | GitHub API |
| GitHub Stars（仓库整体） | 378 | GitHub API |
| 该子技能单独统计 | GitHub 不提供子目录级 star 数；改查该文件自身的 commit/issue 记录作为佐证（见第 6、8 章） | 说明性备注 |
| Forks | 40 | GitHub API |
| 最新版本 | 插件 v1.1.0 | 仓库 .claude-plugin/plugin.json |
| 安装方式 | Claude Code / Codex 插件市场一条命令；其他平台可用 skills.sh 或手动复制 SKILL.md | 官方 README |
2. 功能介绍与亮点
核心能力：教 Claude Code / Codex 等编程 Agent 正确使用 n8n 内置 Data Tables（实例内置的真实表结构，通过 dataTable 节点与 MCP 工具做 CRUD）。正文围绕三类高频误区展开：
- 系统托管列的边界：
id/createdAt/updatedAt三列自动存在，不得在建表时重复声明（会报错或遮蔽系统列），跨系统标识（如arxivId、stripeCustomerId）必须另建独立列，不能拿自增id当外部标识（表重建/实例迁移会重置）； - 列类型的唯一变通规则：Data Tables 不支持 JSON/数组列类型，正文给出统一约定——嵌套数据一律用
string列 +_object后缀命名（如keyInsights_object），写入时JSON.stringify、读取后必须在返回给调用方前JSON.parse，不能把“存储格式”当“接口格式”直接透传； - 该不该用 Data Tables 做去重：给出一张判断依据——单纯“见没见过这个值”应该用
Remove Duplicates节点，只有需要查询检视去重状态、按分类做差异化 TTL、或需要多租户命名空间时才值得建表，避免不必要的表维护成本。
配套 3 篇专项参考文档（SCHEMA_DESIGN.md/OPERATIONS.md/DEDUP_PATTERNS.md）与 8 条反模式对照表（含“外键级联假设”“用 Set 节点垫在 Insert 前”等具体反例）。
亮点：
- 明确点出一个官方文档未强调的运行时陷阱——
get/rowExists类操作若命中 0 行，下游 IF 分支可能两侧都不触发（webhook 场景表现为静默返回空 200），并提示需配合alwaysOutputData处理（该问题已有真实用户提交的 issue，见第 8 章）； - 与同仓库姊妹技能形成明确的交叉引用网络（表达式规范见
n8n-expressions-official，Merge 收敛见n8n-node-configuration-official），不是孤立文档； - 文末给出“发布前验证清单”四步（
validate_workflow→ 检视columns→ 用 pin 数据跑test_workflow→ 实际查表确认无静默 NULL），把“看起来配对了”和“数据真的落地了”这两件事分开验证。
3. 适用场景
固定分类：集成与工作流自动化
- 用 n8n 搭建需要跨执行保留状态的自动化——去重状态、计数器、幂等标记、per-session 库存等中小体量（数万行级）持久化需求；
- 需要设计带列类型/嵌套字段的 workflow 数据结构，且不确定该建 Data Table 还是接真实数据库的开发者；
- 已经用过
Data Table节点但踩过“UI 显示无数据实际已写入”“0 行匹配导致分支不触发“这类隐蔽坑的用户。
受益人群：已在用或计划用 n8n Data Tables 做轻量持久化状态的初中级开发者，尤其是尚未建立“何时该用真实数据库替代”判断标准的用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方
/plugin marketplace add n8n-io/skills+/plugin install n8n-skills@n8n-io一键安装。 - Codex：✅ 原生支持——官方文档给出对应的
codex plugin marketplace add/codex plugin add命令（需 Codex ≥ 0.142.0）。 - OpenClaw：❓ 未验证——README 仅笼统提及“其他平台”可尝试 skills.sh（
npx skills add n8n-io/skills），未点名验证 OpenClaw。 - Hermes Agent：❓ 未验证——同一插件包内另一姊妹技能
n8n-debugging-official曾被 Hermes 内置安全扫描器标记为 dangerous 拦截安装（因排障指引涉及向 workflow 文件写入 issue 编号，被判定为“持久化”风险），本技能内容经查未见同类持久化指引，但由于全部技能随插件一次性安装，实际接入效果仍待验证。
5. 推荐理由
n8n 官方团队出品，把 Data Tables 这个“看似简单、实则有好几处隐蔽坑”的内置功能钉成一套可直接照做的规则——系统列边界、嵌套数据的唯一存取约定、“该不该用它做去重”的判断依据，以及一个已被真实用户在生产中踩过的“0 行匹配导致分支两侧都不触发”陷阱。3 篇专项参考文档 + 8 条反模式表把“知道 Data Tables 是什么”和“落地成不会静默丢数据的可靠 workflow”之间的门槛显著降低。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | n8n 为知名工作流自动化厂商、官方团队亲自出品，仓库整体 378 stars（合集仓库数字，不代表本技能个体热度，见第 1 章说明）；经查本文件自身的 commit（1 次改名提交 + 更早 4 次内容提交，均为 n8n 内部工程师）与 issue/PR 记录（1 条 open issue + 1 个已合并 PR，均涉及 n8n 内部工程师），目前尚未查到独立第三方对本文件本身的公开评价或直接代码贡献 |
| 可用性 | 8 | Claude Code / Codex 两大主流平台均一条命令安装；正文含系统列/类型约定/去重决策表 + 3 篇专项参考文档 + 8 条反模式表 + 发布前验证清单；文中标注两处“临时”说明一个已知 UI 显示怪癖（数据实际已写入但界面暂时不显示，等厂商修复），不影响功能可用性；依赖预先开启 MCP server 的 n8n 实例作为前置条件，非纯开箱即用 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 7.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令权限范围 | 本技能自身不含可执行脚本，仅指导 Agent 调用用户已授权的 n8n MCP 工具，未见越权行为，未扣分 |
| ② 运行时联网外发 | 未发现独立于用户自有 n8n 实例之外的外发行为 |
| ③ API key/凭据存储 | 本技能不直接处理凭据（凭据处理由姊妹技能 n8n-credentials-and-security-official 专项覆盖），内容中未见要求用户提供密钥的指引 |
| ④ 可疑指令/注入迹象 | 本技能文本未见可疑指令。但同一插件包内的姊妹技能 n8n-debugging-official 曾被独立用户举报存在“持久化 issue 编号到 workflow 文件”问题并被 Hermes Agent 安全扫描器标记为 dangerous，截至目前仍处 open 状态尚未修复——与本技能内容无直接关系，但因随同一插件整体安装，计入扣分 |
| ⑤ 作者/组织信誉 | n8n 为知名工作流自动化厂商，官方组织 n8n-io，插件 manifest（author: n8n，homepage: n8n.io）可核验，未扣分 |
| ⑥ License 明确性 | Apache-2.0，明确，未扣分 |
| ⑦ 最近维护时间 | 仓库最近提交 2026-07-26，本文件所在子目录最近实质更新为 2026-07-07（子技能统一改名批次），持续维护，非弃置项目，未扣分 |
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 官方程度 / 热度证据 | 与本技能的差异 |
|---|---|---|---|
| n8n-data-tables-official（本技能，n8n 官方） | n8n Data Tables 专项：schema 设计、类型约定、去重决策、发布前验证 | 官方仓库，本文件由 n8n 团队持续维护 | 专项深度：唯一系统性覆盖“何时该建表”“列类型怎么变通”“0 行匹配的隐蔽陷阱”三类具体决策点的文档 |
| n8n-subworkflows-official（同仓库姊妹技能） | 子工作流封装、复用与发现规范 | 官方仓库，同等热度证据 | 场景不重叠：子工作流关注“逻辑复用与调用契约”，Data Tables 关注“跨执行状态持久化”，二者常配合使用但各自独立 |
| n8n-expressions-official（同仓库姊妹技能） | {{}}/$json 表达式书写规范 |
官方仓库，同等热度证据 | 被本技能引用为前置知识（列值表达式书写），但不涉及表结构设计本身 |
| czlonkowski/n8n-skills（社区版技能合集，5,891★） | 覆盖 Agent、代码节点、表达式、自托管等 15 个技能 | 社区维护，规模远超官方仓库 | 无对应技能：该合集里最接近的是通用的“binary and data”处理指南，未见任何专门覆盖 Data Tables 建表规范或去重模式的文档，是官方版本填补的明确空白 |
核心差异化：本技能不是“n8n 有 Data Tables 这个功能”的说明书，而是把“系统列怎么处理、嵌套数据怎么存取、什么时候该用它做去重、0 行匹配为什么会让分支失效”这几个容易被忽视的具体决策点拆解成可直接执行的规则，且是目前同生态里唯一系统覆盖这一细分场景的技能。
8. 用户评价
该技能目前在第三方平台尚无独立评价文章。可查的具名证据来自 GitHub 仓库自身：一名开发者（liamdmcgarrigle，n8n 内部工程师）提交的 issue 指出，正文“按外部 ID 去重”范例在 Get 节点 0 行匹配时会让 IF 两个分支都不触发（webhook 场景静默返回空 200），并给出具体修法建议（需设置 alwaysOutputData: true），截至目前该 issue 仍处 open 状态。这是一条真实、具体的生产场景反馈，反映的是官方团队自身对该技能内容的持续打磨投入，未查到与本文件直接相关的外部独立开发者评论或贡献记录。
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 每次涉及 Data Tables 设计的 n8n 任务时主动加载本技能——通用安装方式没有 hook 自动触发，退化为纯文档。
前置条件：需要一个已开启实例级 MCP server 的 n8n 实例（Cloud 或自托管均可，最低 n8n 2.2.0），在 n8n 的 Settings → Instance-level MCP 中启用。
11. 注意事项
- 需要预先具备已开启 MCP server 的 n8n 实例，单纯装技能无法替代该前置配置；
- 正文所述“按外部 ID 去重”范例存在一个尚未修复的已知问题：Get 节点 0 行匹配时下游 IF 判断可能两侧都不触发，需自行为 Get 节点设置
alwaysOutputData: true规避（截至推荐时对应 issue 仍 open）； - 正文另有两处标注为“临时”的 UI 显示怪癖说明（手动映射模式下界面可能暂时显示“无数据”但实际已正确写入），待厂商修复后该说明会被移除，属已知的表层显示问题，不影响数据本身的正确性；
- 同插件包内的姊妹技能
n8n-debugging-official存在尚未修复的安全披露（被 Hermes Agent 安全扫描器标记为 dangerous），若计划在 Hermes 环境使用同一插件包，建议关注该 issue 的后续修复进展； - 本技能自身暂未查到独立第三方公开评价，目前的维护活跃度主要体现为官方团队自身的持续投入。