Communityコーディング&開発github.com

SystemTce/dify-skills

Dify ワークフローとプラグイン開発のための完全スキル体系 - モジュール化、段階的学習、実用重視

dify-skills とは?

このスキルは、Dify プラットフォームでのワークフロー設計、プラグイン開発、パフォーマンス最適化、セキュリティとデプロイ、外部システム統合、そして各種リファレンスの6つのサブスキルを包括的に提供します。Claude Code や Cursor などの AI エージェント上で動作し、開発者が Dify の可視化ワークフローやプラグインシステムを迅速に習得できるよう、モジュール化された段階的学習パスを実現します。各サブスキルは独立して使用可能で、実際のコード例や設定テンプレート、ベストプラクティスが豊富に含まれており、初心者から専門家まで幅広い開発者に対応します。また、DSL構文、API、CLIコマンドなどのリファレンスも提供し、開発プロセス全体を効率化します。

対応✓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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Dify Master SKILL

モジュール化された、段階的に開示される Dify 開発スキル体系

クイックナビゲーション


Dify とは

Dify はオープンソースの LLMOps プラットフォームであり、ビジュアルなワークフロー編集と強力なプラグインシステムを提供し、開発者が AI アプリケーションを迅速に構築・デプロイできるようにします。

コア機能

  • ビジュアルワークフロー: ドラッグ&ドロップで操作、コーディング不要で複雑な AI アプリケーションを構築
  • プラグインシステム: ツール、モデル、データソースなど多様なプラグインタイプをサポート
  • プロダクションレディ: ローカル開発から大規模分散デプロイまでの完全サポート
  • オープンソースエコシステム: 114K+ GitHub Stars、活発なコミュニティと豊富なプラグインマーケット

技術アーキテクチャ

  • Beehive アーキテクチャ: モジュール化、拡張可能なシステム設計
  • キュー駆動グラフエンジン: イベント駆動、並列実行、高性能
  • マルチランタイム対応: Local、Debug、Serverless の3つの実行モード
  • 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. コンテキスト最適化: 1回のロードで読み込む内容を最小限に
  4. 実用重視: そのまま使えるコードと設定を提供

クイックスタート

シナリオ 1: 初めてのワークフロー作成

# シンプルなQ&Aワークフロー
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 最適化 (モデル選択、プロンプトエンジニアリング、キャッシュ、構造化出力)
  • プラグイン最適化 (ランタイム選択、リソース制限、非同期処理)
  • モニタリングと分析ツール
  • パフォーマンスベンチマーク

クイックアクセス: 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.

関連スキル