n8n Master

核心用法

n8n Master 是一个面向 n8n 自动化平台的专业技能，专注于回答 n8n 概念问题并生成可直接使用的自动化产物。其核心交付物包括：

1. 工作流设计与配置：基于官方文档的节点参数配置、表达式编写、调试方案
2. Code 节点开发：输出符合 n8n 规范的 JavaScript，支持 "Run Once for All Items" 模式，返回标准 { json: ... } 数组结构
3. HTTP Request 节点：完整的 API 集成配置，含认证、头部、参数、响应路径解析及常见故障排查
4. 可导入 Workflow JSON：生成带占位凭证的完整工作流，active: false，需用户导入后绑定真实凭证
5. 生产加固方案：针对可靠性需求提供去重键、幂等写入、运行日志、重试退避、人工审核队列等机制

显著优点

• 知识架构严谨：采用分层索引路由（Concepts → Nodes → APIs → Recipes → QAs → Sources），确保答案可追溯至官方文档
• 安全设计内建：强制凭证占位符、禁止硬编码密钥、写入操作默认 dry-run，符合企业安全合规要求
• 工程化交付：不仅回答问题，更输出 copy-paste 可用的配置与代码，显著降低实施成本
• 生产就绪：专门针对"无静默失败"、长期运维场景提供运行手册（runbook）与审计日志方案

潜在局限

• 依赖本地知识库：若用户问题超出已索引的 references/wiki/ 范围，需依赖 rg 搜索或用户补充文档，回答深度受限
• 工具箱限制：网络测试、飞书多维表格操作等工具仅在用户明确要求时触发，非自动启用
• 无实时调试能力：无法直接连接用户 n8n 实例进行实时诊断，仅能提供配置建议
• 文档编译门槛：新增文档需通过 AI 编译器流程整合，非即时生效

适合人群

| 角色 | 使用场景 |

|------|---------|

| 自动化工程师 | 快速搭建复杂 API 集成、数据 ETL 工作流 |

| DevOps/SRE | 生产环境加固、故障排查、可观测性方案设计 |

| 技术团队 Lead | 标准化团队 n8n 开发规范、代码审查辅助 |

| 低代码开发者 | 理解 n8n 节点行为、表达式语法、调试技巧 |

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 凭证泄露 | 用户可能误将真实密钥粘贴至对话 | 技能强制要求凭证占位符，主动声明"绝不接受真实密钥" |

| 破坏性写入 | 生产数据误删/误改 | 所有写入操作默认 dry-run，需显式确认才执行 |

| 配置漂移 | 官方 API/节点参数更新未同步 | 依赖 `ALL-Sources.md` 索引，提示用户补充最新文档 |

| 过度自动化 | 高风险操作（资金、客户数据）缺乏人工审核 | 生产加固模式强制引入"人工审核队列"机制 |

使用建议

建议用户在使用时明确告知：目标平台版本（n8n cloud/self-hosted）、是否需要生产级加固、以及涉及的外部 API 类型（REST/GraphQL/专有协议），以获得最精准的输出。

核心用法

n8n Master 是一款专注于 n8n 自动化平台的技能，旨在帮助用户从零构建到生产部署完整的工作流系统。其核心功能覆盖六大场景：概念答疑与调试排错、HTTP Request 节点配置、Code 节点 JavaScript 开发、可导入的工作流 JSON 生成、生产环境加固，以及文档编译与工具箱辅助。

使用时，技能会优先检索本地知识库中的索引文件（如 ALL-Concepts.md、ALL-Nodes.md、ALL-APIs.md 等），确保答案基于权威来源而非臆测。对于 HTTP Request 节点，输出包含完整的请求方法、URL、认证方式、Headers、Query 参数、请求体结构及响应路径；Code 节点则明确标注执行模式（如 "Run Once for All Items"）和输入数据结构，返回符合 n8n 规范的 { json: ... } 数组格式。

生产加固是该技能的一大特色。当用户提出可靠性、可审计性、重试机制、幂等写入或人工审核等需求时，技能会自动注入 dedup 去重键、运行 ID 与状态日志、指数退避重试、失败通知、人工审核队列及运维手册等组件，避免"静默失败"风险。

工具箱功能（需显式调用）包括 API 测试脚本、飞书多维表格字段读写、以及 Firecrawl 文档摄取，适用于深度集成场景。文档编译功能则支持将新增原始文档自动转化为结构化的 wiki 卡片，保持知识库持续更新。

显著优点

知识体系完整且权威：技能内置 n8n 官方概念、节点行为、表达式语法、调试技巧等结构化知识，引用路径透明可查，避免"幻觉式"回答。

输出即用的工程化交付：不同于泛泛而谈的建议，该技能直接产出可导入 n8n 的 JSON 配置、可运行的 JavaScript 代码片段、以及标准化的 HTTP Request 模板，大幅降低从学习到落地的摩擦。

生产级安全设计：强制使用环境变量管理凭证（如 FEISHU_APP_ID、FIRECRAWL_API_KEY），禁止硬编码敏感信息；工作流 JSON 默认 active: false，需用户手动激活并绑定凭证，防止误操作触发。

幂等与可观测性内置：生产加固模式自动注入运行追踪、幂等键、失败重试及人工审核节点，帮助用户构建可审计、可回滚、不丢数据的可靠系统。

潜在缺点与局限性

依赖本地知识库时效性：该版本为 wiki-only 发行，不捆绑原始语料库。若 n8n 官方文档更新，需用户手动触发 AI 编译流程更新本地索引，否则可能提供过时信息。

工具箱功能需显式授权：API 测试、飞书字段创建、文档摄取等高级功能不会自动调用，需用户明确请求。对于期望"一键全自动化"的用户，交互门槛略高。

T3 来源需持续观察：技能由个人开发者维护（ClawHub 平台），虽代码安全审计通过，但长期维护承诺、功能迭代节奏及社区支持规模弱于企业级或开源基金会项目。

网络环境限制：依赖 Feishu OpenAPI 和 Firecrawl API 的功能在受限网络环境（如企业内网、代理白名单场景）中可能失效，需提前配置网络策略。

适合的目标群体

• n8n 初学者：需要结构化指引理解节点行为、表达式语法及调试技巧，避免在文档海洋中迷失。
• 自动化工程师：需快速生成可导入的生产级工作流，关注幂等性、重试策略、失败通知等可靠性细节。
• 系统集成开发者：频繁对接飞书、Firecrawl 等外部 API，需要标准化的 HTTP Request 配置模板和字段映射方案。
• 运维与平台团队：负责 n8n 实例的长期运维，需要可观测、可审计、可安全重跑的工作流设计范式。

常规使用风险

凭证泄露风险：尽管技能强制使用环境变量，但用户若在对话中粘贴真实密钥、或在导入工作流后未正确绑定凭证，仍可能导致敏感信息暴露。建议始终使用占位符（如 {{$credential.feishu}}）而非明文。

工作流导入风险：生成的 JSON 文件在导入 n8n 前应人工审查节点连接、触发器配置及执行逻辑，避免导入包含意外循环、高频触发或危险操作（如批量删除）的流程。

外部 API 依赖：Feishu 和 Firecrawl API 的可用性、速率限制及计费策略不受本技能控制。建议在关键路径中加入熔断与降级逻辑，避免第三方服务故障级联影响。

版本兼容性：n8n 快速迭代，节点参数和行为可能随版本变化。建议在升级 n8n 前测试关键工作流，或锁定技能知识库版本以匹配运行时环境。