前言¶
在 Dify 里搭 Workflow 或 Chatflow，常见路径是在控制台里拖节点、连边、配变量和工具。流程变长之后，改一版图结构或对照官方 DSL 做导入导出，往往要反复点开节点核对字段。若你更希望用对话描述需求、直接落到可导入的 YAML，就需要 Agent 侧有一套针对 Dify DSL 的编写与校验约定。下面介绍 SkillHub 上的 Dify-workflow-dsl-skill（自动创建 Dify 工作流） 是做什么的、怎么装、怎么用。
这是什么¶
Dify Workflow DSL Skill 是一套面向 AI Agent 的技能包（通用 SKILL.md 格式），帮助编写、修改、审查和调试 Dify 工作流 DSL YAML，产出物可直接导入 Dify。
- 坐标：
@user_47abb51b/dify-workflow-dsl-skill - 版本：1.0.0（来源：community）
- 分类：ai-agent
- 发布者：
user_47abb51b（SkillHub 页面标注作者为 Windom Yu） - 标签：
requires_api_key=false（按 SkillHub 元数据，不依赖额外 API Key）
官方简介强调的目标很直接：用自然语言描述需求，由 AI 生成可导入 Dify 的工作流文件。
核心功能¶
以下能力与 SkillHub 简介及技能英文说明一致，用于 Dify 应用与工作流 DSL 相关任务：
- 创建与修改 Dify Workflow / Chatflow 的 DSL YAML（含 workflow YAML、advanced-chat YAML、应用级 Dify app DSL）。
- 审查与调试 已有 DSL，减少导入失败或运行期配置错误。
- 图结构与数据：节点与边（graph nodes/edges）、变量（variables）、工具节点（tool nodes）。
- 依赖与集成：插件依赖（plugin dependencies）、数据库读写类工具（database read/write tools）。
- 导入导出：处理与 Dify 导入/导出格式、兼容性相关的问题。
技能本身不替代 Dify 控制台；它约束 Agent 如何产出、改写 YAML，使结果更符合 Dify 可导入的 DSL 形态。
安装与启用¶
SkillHub 页面给出的安装方式是：让 AI 按官方安装文档处理，并安装指定坐标。
方式一：对话安装（SkillHub 页面提示词）
把下面意思发给已支持 Skill 的 Agent（需能访问 SkillHub 安装说明）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_47abb51b/dify-workflow-dsl-skill`。
方式二：SkillHub CLI
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装技能时，必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 可能不会被识别。文档记载的常用路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
在 Cursor 中可执行：
skillhub install @user_47abb51b/dify-workflow-dsl-skill --dir ~/.cursor/skills/
安装后按你所用客户端的要求重启或刷新 Agent，使技能被加载。
典型用法¶
技能启用后，用自然语言交代 Dify 侧目标即可，由 Agent 在技能约束下生成或修改 YAML。可复现的交互模式如下（表述可按项目替换，不必编造具体业务案例）：
- 新建工作流：说明应用类型（Workflow 或 Chatflow）、输入输出、关键节点（如 LLM、工具、条件分支），要求输出完整 DSL YAML 并注明 Dify 导入方式。
- 改现有 DSL：粘贴或引用当前 YAML，说明要改的节点、变量或边，要求改完后仍符合导入格式。
- 排错：描述 Dify 导入报错或节点配置疑问，要求对照 DSL 结构做审查并给出修改建议。
- 工具与插件：说明要接入的工具节点、插件依赖或数据库读写工具，要求在 DSL 中正确声明依赖与参数。
经过上面的步骤，你应得到可在 Dify 中尝试导入的 YAML 文件；最终是否导入成功仍取决于 Dify 版本与实例配置，技能侧负责 DSL 形态与常见兼容性问题的处理。
适用场景与注意¶
适合谁
- 已在用 Dify Workflow / Chatflow，希望少在 UI 里手工拼复杂图，多用对话迭代 DSL 的开发者。
- 需要批量审查、重构工作流 YAML，或对照导入导出规范排查问题的维护者。
限制与注意
- 技能指导 Agent 写 YAML，不保证覆盖你私有插件或未在描述中说明的自定义节点；复杂集成仍需在 Dify 内验证。
- SkillHub 元数据显示该技能 requires_api_key=false；Dify 运行时所需的模型 Key、工具凭证等仍由你在 Dify 或环境中自行配置。
- 社区来源（community），版本为 1.0.0；升级与变更以 SkillHub 上该坐标为准。
SkillHub 页面统计（抓取时）：评分 100000，下载 943 次；安装计数以平台展示为准。
结尾¶
Dify-workflow-dsl-skill 把「写、改、审、调 Dify 工作流 DSL YAML」收敛成 Agent 可执行的一套规则，适合用自然语言驱动可导入的工作流文件。需要安装或查看说明时，可打开 SkillHub 技能页或 API 入口：
- 技能页：https://www.skillhub.cn/skills/user_47abb51b/dify-workflow-dsl-skill
- 官方地址：https://api.skillhub.cn/user_47abb51b/dify-workflow-dsl-skill
