Community程式設計與開發github.com

SystemTce/dify-skills

Dify 工作流與插件的完整技能體系 - 模組化、漸進式、實用導向

dify-skills 是什麼?

Dify Master SKILL 是一套模組化、漸進式披露的 Dify 開發技能體系,專為 AI 代理開發者、工程師及架構師設計。本技能涵蓋從視覺化工作流設計、自訂插件開發、性能優化、安全部署、外部系統整合到完整參考資料的六大核心子技能。支援 Platform(如 Claude Code、Cursor、Codex),並以 SKILL.md 文件形式提供結構化知識。透過可複用的程式碼範例、設計模式及最佳實踐,幫助開發者快速掌握 Dify 開源 LLMOps 平台,並能即時應用到專案中。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add SystemTce/dify-skills

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Dify Master SKILL

一個模組化、漸進式披露的 Dify 開發技能體系

快速導航


什麼是 Dify

Dify 是一個開源的 LLMOps 平台,提供可視化的工作流編排和強大的插件系統,幫助開發者快速構建和部署 AI 應用。

核心特性

  • 可視化工作流: 拖拽式編排,無需編碼即可構建複雜 AI 應用
  • 插件系統: 支援工具、模型、資料來源等多種插件類型
  • 生產就緒: 從本地開發到大規模分散式部署的完整支援
  • 開源生態: 114K+ GitHub Stars,活躍的社群和豐富的插件市場

技術架構

  • Beehive 架構: 模組化、可擴展的系統設計
  • 佇列驅動圖引擎: 事件驅動、平行執行、高效能
  • 多運行時支援: Local、Debug、Serverless 三種運行模式
  • MCP 協定集成: 與 Claude 等 AI 助手的標準化集成

SKILL 體系概覽

Dify Master SKILL 採用模組化設計,包含 6 個核心子 SKILL,覆蓋從開發到部署的完整流程。

dify-master (總入口)
├── 01-workflow      # 工作流設計
├── 02-plugin        # 插件開發
├── 03-performance   # 性能優化
├── 04-security      # 安全和部署
├── 05-integration   # 集成和擴展
└── 06-reference     # 參考資料

設計理念

  1. 模組化: 每個子 SKILL 獨立完整,可單獨使用
  2. 漸進式披露: 從概覽到細節,按需深入
  3. 上下文優化: 最小化單次載入的內容量
  4. 實用導向: 提供可直接使用的程式碼和配置

快速開始

場景 1: 建立第一個工作流

# 簡單問答工作流
workflow:
  graph:
    nodes:
    - data:
        type: start
        variables: []
      id: start

    - data:
        type: llm
        model:
          provider: openai
          name: gpt-4
        prompt_template:
        - role: system
          text: "你是一個助手"
        - role: user
          text: "{{#sys.query#}}"
      id: llm

    - data:
        type: answer
        answer: "{{#llm.text#}}"
      id: answer

    edges:
    - source: start
      target: llm
    - source: llm
      target: answer

下一步: 學習 01-workflow SKILL 了解更多節點類型和設計模式

場景 2: 開發第一個插件

# 簡單工具插件
from typing import Any, Generator
from dify_plugin.entities.tool import ToolInvokeMessage
from dify_plugin import Tool

class MyTool(Tool):
    def _invoke(
        self,
        tool_parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        # 獲取參數
        input_text = tool_parameters.get("text", "")

        # 處理邏輯
        result = input_text.upper()

        # 返回結果
        yield self.create_text_message(result)

下一步: 學習 02-plugin SKILL 了解完整的插件開發流程

場景 3: 優化工作流性能

# 使用平行分支提升性能
- data:
    type: parallel
    branches:
    - nodes: [tool1, process1]
    - nodes: [tool2, process2]
    - nodes: [tool3, process3]
  id: parallel_execution

下一步: 學習 03-performance SKILL 了解更多優化技術


子 SKILL 索引

01. 工作流設計 SKILL

適用場景: 設計和開發 Dify 工作流

觸發關鍵詞: 節點, LLM, Agent, 工作流, 變數, 知識檢索, HTTP Request, Code, If-Else, Iteration, 範本, DSL, YAML

核心內容:

  • 10+ 節點類型詳解 (Start, LLM, Agent, Knowledge Retrieval, Code, HTTP Request, Tool, If-Else, Iteration, Answer)
  • 5 種設計模式 (順序管道、條件分支、迭代處理、知識檢索、多源聚合)
  • 開箱即用的工作流範本
  • 變數系統和引用語法
  • 最佳實踐和常見問題

快速訪問: 01-workflow/SKILL.md

推薦給: 工作流設計者、AI 應用開發者、產品經理


02. 插件開發 SKILL

適用場景: 開發自訂工具、模型、資料來源插件

觸發關鍵詞: 插件, plugin, Tool, Provider, 開發, manifest, OAuth, 資料來源, 模型, 擴展

核心內容:

  • 4 種插件類型 (Tool, Model, Datasource, Extension)
  • 完整的開發流程 (初始化、實作、測試、打包、發布)
  • 標準專案結構和配置檔案
  • Provider 和 Tool 開發指南
  • 插件範本和程式碼範例
  • 測試策略和除錯技巧

快速訪問: 02-plugin/SKILL.md

推薦給: 插件開發者、後端工程師、工具集成者


03. 性能優化 SKILL

適用場景: 優化工作流和插件的執行性能

觸發關鍵詞: 性能, performance, 優化, 快取, 平行, 延遲, 吞吐量, 監控, benchmark

核心內容:

  • 工作流優化 (圖結構、平行執行、變數池)
  • LLM 優化 (模型選擇、Prompt 工程、快取、結構化輸出)
  • 插件優化 (運行時選擇、資源限制、非同步處理)
  • 監控和分析工具
  • 性能基準測試

快速訪問: 03-performance/SKILL.md

推薦給: 性能工程師、架構師、維運人員


04. 安全和部署 SKILL

適用場景: 生產環境部署和安全加固

觸發關鍵詞: 安全, security, 部署, deploy, Docker, Kubernetes, SSL, 認證, 授權, 沙箱, SSRF

核心內容:

  • 安全實踐 (SSRF 防護、沙箱隔離、資料加密、認證授權)
  • 部署指南 (Docker Compose, Kubernetes, Serverless, 高可用)
  • 維運實踐 (監控、日誌、備份、故障排查)
  • 環境配置和資源規劃
  • 最佳實踐和案例

快速訪問: 04-security/SKILL.md

推薦給: DevOps 工程師、安全工程師、系統管理員


05. 集成和擴展 SKILL

適用場景: 與外部系統和服務集成

觸發關鍵詞: 集成, integration, API, Webhook, MCP, Server, Client, 資料庫, Redis, 訊息佇列, RabbitMQ, Kafka, S3

核心內容:

  • API 集成 (REST API, Webhook, Streaming)
  • MCP 協定 (MCP Server, MCP Client, 雙向通訊)
  • 外部服務 (資料庫、儲存、訊息佇列)
  • 集成案例和最佳實踐
  • 故障排查和除錯

快速訪問: 05-integration/SKILL.md

推薦給: 集成工程師、全端開發者、架構師


06. 參考資料 SKILL

適用場景: 查找語法、API、CLI 等參考資訊

觸發關鍵詞: 參考, reference, API, SDK, CLI, DSL, YAML, 命令, 文件, 語法

核心內容:

  • DSL 語法參考 (完整的 YAML 結構和欄位說明)
  • API 參考 (RESTful API 介面文件)
  • SDK 參考 (Python SDK 類別和方法)
  • CLI 參考 (dify 命令列工具)
  • 常見問題和解決方案
  • 學習資源和社群連結

快速訪問: 06-reference/SKILL.md

推薦給: 所有 Dify 開發者


常用參考

變數引用語法

# 系統變數
{{#sys.query#}}              # 用戶查詢
{{#sys.files#}}              # 上傳的檔案
{{#sys.conversation_id#}}    # 對話 ID

# 節點輸出
{{#節點ID.輸出欄位#}}        # 引用節點輸出
{{#llm.text#}}               # LLM 文字輸出
{{#knowledge.result#}}       # 知識檢索結果

# 對話變數
{{#conversation.變數名#}}    # 對話級變數

# 迭代變數
{{#item#}}                   # 當前迭代項
{{#index#}}                  # 當前索引

常用節點配置

# LLM 節點
- data:
    type: llm
    model:
      provider: openai
      name: gpt-4
      completion_params:
        temperature: 0.7
        max_tokens: 2000
    prompt_template:
    - role: system
      text: "系統提示"
    - role: user
      text: "{{#sys.query#}}"
    context:
      enabled: true
      variable_selector: ["knowledge", "result"]

# Agent 節點
- data:
    type: agent
    agent_parameters:
      instruction:
        value: "根據用戶需求調用工具"
      model:
        value:
          provider: openai
          model: gpt-4
      query:
        value: "{{#sys.query#}}"
      tools:
        value:
        - enabled: true
          provider_name: time
          tool_name: current_time
          type: builtin
    agent_strategy_name: function_calling

# 知識檢索節點
- data:
    type: knowledge-retrieval
    dataset_ids: ["dataset-id"]
    query_variable_selector: ["start", "sys.query"]
    retrieval_mode: single
    single_retrieval_config:
      model:
        provider: openai
        name: text-embedding-3-small
      top_k: 3
      score_threshold: 0.7

插件配置範本

# manifest.yaml
version: 0.0.1
type: plugin
author: your-name
name: plugin-name
label:
  en_US: Plugin Name
  zh_Hans: 插件名稱
description:
  en_US: Plugin description
  zh_Hans: 插件描述
icon: icon.svg

resource:
  memory: 268435456  # 256MB

plugins:
  tools:
    - provider/provider.yaml

meta:
  version: 0.0.1
  arch: [amd64, arm64]
  runner:
    language: python
    version: "3.12"
    entrypoint: main

tags:
  - utilities

CLI 常用命令

# 插件開發
dify plugin init                    # 初始化插件專案
dify plugin run                     # 本地除錯插件
dify plugin package                 # 打包插件
dify plugin publish                 # 發布插件

# 工作流管理
dify workflow export <id>           # 匯出工作流
dify workflow import <file>         # 匯入工作流
dify workflow validate <file>       # 驗證工作流

# 環境管理
dify env list                       # 列出環境變數
dify env set <key> <value>          # 設定環境變數
dify env get <key>                  # 取得環境變數

學習路徑

新手路徑 (0-1 週)

  1. 閱讀本 SKILL 了解 Dify 全貌
  2. 學習 01-workflow SKILL 掌握工作流基礎
  3. 使用範本建立第一個工作流
  4. 在 Dify 平台上測試和除錯

進階路徑 (1-4 週)

  1. 深入學習 01-workflow SKILL 的設計模式
  2. 學習 02-plugin SKILL 開發自訂插件
  3. 學習 03-performance SKILL 優化性能
  4. 構建實際專案並部署

專家路徑 (1-3 個月)

  1. 掌握所有子 SKILL 的內容
  2. 學習 04-security SKILL 進行生產部署
  3. 學習 05-integration SKILL 集成外部系統
  4. 參與社群貢獻和最佳實踐分享

取得幫助

官方資源

社群資源

SKILL 支援

  • 架構文件: ARCHITECTURE.md
  • 問題回饋: 透過 GitHub Issues 提交
  • 貢獻指南: 參與 SKILL 內容的改進和擴展

版本資訊

  • 目前版本: v1.1.0
  • 最後更新: 2026-03-05
  • Dify 相容版本: 0.15.x - 1.9.x
  • 更新內容: 完善 05-integration 和 06-reference SKILL,添加按需載入機制
  • 下一版本計畫: v1.2.0 (增加更多範本和案例)

許可證

本 SKILL 基於 MIT 許可證開源,歡迎使用、修改和分發。


開始你的 Dify 開發之旅吧!選擇一個子 SKILL 深入學習,或直接使用範本快速開始。

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相關技能