技能介绍

要解决什么问题

在自托管或任意 n8n 实例上，Code 节点（Python / JavaScript）和工作流 JSON 往往混在一起：注释不全、上下游不清晰、导出片段与代码不一致，备份文件也难以还原成可维护的工程结构。本技能面向日常编写与备份反推两类场景，要求交付物可落盘、可审查、可再导入 n8n。

技能如何工作

日常编写（默认）：按 references/n8n-daily-authoring.md 在工作流文件夹内为每个 Code 节点单独保存 .py / .js，必要时为节点保存 .json；用 01_1.2_节点名 等编号体现顺序与分支层级，并维护节点关系与分支说明.md（节点清单表、每条分支一段完整逻辑、阈值与单位写全）。
双轨交付（强制）：凡涉及可执行逻辑，须同时给出代码轨（完整 Python 或 JavaScript，语言与 parameters.language 一致）与 JSON 轨（对应 nodes + edges 片段或完整可导入对象；pythonCode / jsCode 与代码轨一致，注意转义）。用户只要其一须在回复中明示省略项。
备份反推：仅在同时提供备份 JSON 路径与输出目录路径时执行 workflow-backup-reverse-engineering.md：产出 工作流分支逻辑与优化建议.md、code/（从 JSON 原样抽出）、code_optimized/（同名一一对应、等价精简）；缺路径则提醒补齐并暂停，不得擅自落盘。
执行顺序：判定场景 → 约定目录与编号 → 确认语言与 Run once 模式 → 先拓扑/edges 再 JSON 再代码 → 注释遵循 commenting-standard.md（尽量逐行中文注释）→ 按 review-checklist.md 审查；JSON 可读性靠 meta、edges[].note 或文外参数说明，标准 JSON 内不写 //。

适用边界与注意点

不假设具体集成；环境与凭证用占位符（如 {{PLACEHOLDER}}），禁止在文档中粘贴未脱敏的 Webhook URL、Token。
日常落盘目录约定与反推产出结构不要混用；用户明确只要聊天内代码、不要写入磁盘时，可不落盘。
本地未运行 n8n 时，测试策略见 local-testing.md；合并完整导出时需保证节点 name 唯一、connections 与名称一致，并提醒 Import 后烟测。