用途:这是 n8n 的技能,需在调用 build-workflow 之前加载,是处理所有单一工作流工作的默认路径,包括新建一次性工作流、编辑已有工作流、验证修复等。若工作流会创建或写入 Data Tables,需先加载 data-table-manager,再加载本技能。
主要能力:作为 n8n 工作流构建专家,使用 @n8n/workflow-sdk 生成完整有效的 TypeScript 代码。新建工作流时先用 workspace_write_file 写出 SDK 源码,再调用 build-workflow({ filePath });编辑已保存工作流时调用 workflows(action="get-as-code", workflowId),把当前源码写入绑定的工作区文件并返回 filePath 与带行号的节点索引,再用 workspace_str_replace_file 做最小化修改,最后调用 build-workflow({ filePath })。修复时先用 debugging-executions 查看失败节点的真实错误与解析参数,不猜测原因。
使用方式:先判断需要的节点类型,明显时在首个动作回合把 nodes(action="type-definition") 与本技能的 load_skill 一起批量调用;不确定时先加载本技能再按研究流程走。用 nodes(action="suggested") 按类别找节点,用 nodes(action="search") 搜服务节点,用 nodes(action="explore-resources") 解析真实资源 ID。写源码后在首次 build 前(以及重大编辑后)运行 node --import tsx node_modules/@n8n/workflow-sdk/dist/cli/index.js validate <filePath>,修复新增错误,再调用 build-workflow 并把同一 filePath 传入。
适用场景:单工作流的创建、修改、修复、验证;涉及多种外部系统、分支、Code 节点时应先读工作区知识库中的 workflow-builder-guardrails.md。
限制:不要提供密钥;未知的收件人、账号、资源、凭据、频道 ID、时区等用 placeholder 或未解析的 newCredential() 占位,不要硬编码假值。首次成功构建前不要停下来询问设置值。工作流级错误工作流必须是单独已发布且带激活 Error Trigger 的真实工作流 ID。CLI 校验干净不保证 build-workflow 一定成功。资料未提供具体价格、收费或平台兼容范围。