| name | dify-dsl-app-builder |
| description | 根据用户需求设计并生成 Dify 应用 DSL，创建或更新 workflow/advanced-chat 应用。Use when the user asks to build a Dify workflow from requirements, generate DSL, create an app from DSL, update an existing app DSL, or automate Dify app creation/update through Admin API. |
Dify DSL App Builder
适用场景
当用户希望“根据需求自动生成 Dify DSL 并创建或更新应用”时使用，包括：
- 从自然语言需求生成 workflow DSL。
- 修改已有 DSL 并更新应用。
- 创建新的 workflow 应用并导入 DSL。
- 覆盖导入已有 workflow 或 advanced-chat 应用。
- 导入后重新导出并验证远端 DSL。
涉及 Console Admin API 的请求时，必须先读取并遵守 skills/dify-console-admin-api/SKILL.md。
基本原则
- 先给出 DSL 设计方案并征求用户确认，用户同意后再修改文件或调用接口。
- 优先编辑已有 DSL 文件；没有 DSL 文件时再创建新的本地 DSL 文件。
- 不要把
ADMIN_API_KEY 写入仓库文件、PR 描述、长期脚本或最终回复。
- 默认
include_secret=false，除非用户明确要求导出密钥。
- 覆盖更新前先导出旧 DSL 作为备份，避免丢失已有配置。
- Admin API 卡住或失败时，先报告错误和排查建议；只有用户明确授权，才允许直接写数据库。
参数收集
开始执行前确认这些参数：
DIFY_BASE_URL：例如 http://127.0.0.1:5001。ADMIN_API_KEY：服务端配置的 admin key。WORKSPACE_ID：目标 workspace 的 tenants.id。- 操作类型：创建应用、更新应用、只生成 DSL。
按操作类型继续确认：
- 创建应用：
APP_NAME，可选 APP_DESCRIPTION。
- 更新应用：
APP_ID，可选现有 DSL 文件路径。
- 只生成 DSL：目标文件路径或应用名称。
DSL 设计流程
根据用户需求先形成方案：
- 明确应用模式，默认使用
workflow。
- 明确输入参数，包括变量名、类型、是否必填、默认值。
- 明确节点链路，例如
start -> http-request -> code -> end。
- 明确外部依赖，例如 HTTP API、插件、知识库、模型。
- 明确输出字段和输出格式。
- 明确错误处理策略，例如外部 API 失败时返回“未知”或错误信息。
方案确认后再生成 DSL。节点结构应参考当前仓库中已导出的 DSL 或测试 fixture，保持字段名和节点类型与 Dify 当前版本一致。
创建应用流程
- 生成本地 DSL 文件。
- 使用
skills/dify-console-admin-api/SKILL.md 的创建应用接口创建 workflow 应用。
- 使用返回的
APP_ID 覆盖导入 DSL。
- 如果导入返回
202 pending，调用 confirm 接口。
- 重新导出该应用 DSL，验证远端内容包含关键节点、变量和输出。
更新应用流程
- 使用
APP_ID 导出当前 DSL，保存为备份文件。
- 修改或生成新的本地 DSL。
- 使用
apps/imports 传入 app_id 覆盖导入。
- 如果导入返回
202 pending，调用 confirm 接口。
- 重新导出该应用 DSL，验证远端内容包含关键节点、变量和输出。
验证要求
更新完成后至少验证：
- 远端导出的 DSL 能成功返回。
- 远端 DSL 包含预期输入变量。
- 远端 DSL 包含预期节点类型和关键配置。
- 远端 DSL 包含预期输出字段或输出文本。
最终回复只说明结果、文件路径、应用 ID 和验证结论；不要泄露 ADMIN_API_KEY。
Edge 结构说明
每条 edge 必须包含：
- data:
isInIteration: false
isInLoop: false
sourceType: <源节点 type>
targetType: <目标节点 type>
id: <source>-source-<target>-target
source: '<source_node_id>'
sourceHandle: source
target: '<target_node_id>'
targetHandle: target
type: custom
zIndex: 0
迭代容器内部 edge 额外加：isInIteration: true、iteration_id。
节点位置布局建议
节点从左到右按 x=80,384,688,992… 排列（间隔 304），y 统一 282。分支节点上下偏移约 ±130。
每个节点的外层通用字段：id、height（54/90/110/126/178）、position/positionAbsolute（x/y）、selected: false、sourcePosition: right、targetPosition: left、type: custom、width: 242。
节点参考
需要用到某类节点时，读取对应文件获取完整模板：
