NodeCoda Dify 工作流
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_61bd065a/nodecoda-workflow。
技能介绍
手工搭 Dify 工作流时,错在导入前一秒
节点 ID 与连线不一致、分支 handle 对不上、插件依赖在画布上看起来齐全但导入即报缺包——这类问题往往不是「逻辑写错」,而是 YAML 图结构 与 Dify 目标版本不匹配。让大模型直接吐一段 Workflow YAML 也常有同样结局:语法像对的,一导入就翻车,改一处又要重排半张画布。
技能在做什么
本技能把流程从「生成草稿」改成 面向 Dify 的构建与校验:你用自然语言说明输入、输出、依赖与边界,Agent 按 NodeCoda 语言编写可追溯的 .ncoda 源码,再显式以 dify-1.16-graphon-0.6 等目标配置提交 Workflow Build。服务端对节点、边、依赖做逐项核对,过不了校验不交付成品。
典型链路包括:
- 需求收敛:单次 workflow 还是多轮 advanced-chat、异常分支、明确不做的边界;
- 编写 Source:最小实现、保留诊断可修复的写法,可查语言包与目标能力矩阵;
- 构建与有界修复:通过 MCP 的
build_dify_workflow/ 轮询 / 取消,或 CLIbuild回退; - 落盘产物:同目录下的
.dify.yaml、.build.json,由你在 Dify 中导入并配置模型、工具与权限。
边界与注意点
校验保证的是 结构正确、能导入,不代替你在 Dify 里做运行时联调。项目化模式(nodecoda.yaml、状态机、design.md)适合要版本化、反复编译的工作流;轻量片段验证需自行声明临时用途。免费体验走 guest 构建通路,日配额用尽会软停,正式 key 走专属构建服务。
使用场景
- 产品同学口头描述审批/问答流程,需要可导入 Dify 的图结构而非手写 YAML
- 团队要把 chat、并行分支、外部 HTTP 工具串成 workflow,且导入前要通过目标版本校验
- 已有 NodeCoda 项目目录,迭代 `.ncoda` 后需重新编译出覆盖式 `.dify.yaml`
- MCP 未就绪时,仍需在无 key 条件下用 CLI 完成一次 guest 构建拿产物
适合人员
- 负责在 Dify 落地业务编排、又不愿反复排查导入报错的应用工程师
- 用 Cursor/Codex 等 Agent 编程环境,希望用自然语言驱动工作流源码与构建的搭建者
- 需要把 `.ncoda` 纳入 git、按设计文档迭代并交付可导入产物的内部平台同学
- 偶尔验证单段 NodeCoda 语法或目标兼容性、但要区分临时验证与正式项目生命周期的人