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 # 参考資料
設計思想
- モジュール化: 各サブ SKILL は独立して完結し、単独で使用可能
- 段階的開示: 概要から詳細へ、必要な時に深く掘り下げる
- コンテキスト最適化: 1回のロードで読み込む内容を最小限に
- 実用重視: そのまま使えるコードと設定を提供
クイックスタート
シナリオ 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週間)
- この SKILL を読んで Dify の全体像を把握
- 01-workflow SKILL でワークフローの基礎を学ぶ
- テンプレートを使って最初のワークフローを作成
- Dify プラットフォームでテストとデバッグ
中級者パス (1-4週間)
- 01-workflow SKILL のデザインパターンを深く学ぶ
- 02-plugin SKILL でカスタムプラグインを開発
- 03-performance SKILL でパフォーマンスを最適化
- 実際のプロジェクトを構築してデプロイ
エキスパートパス (1-3ヶ月)
- すべてのサブ SKILL の内容を習得
- 04-security SKILL でプロダクションデプロイを学ぶ
- 05-integration SKILL で外部システムと統合
- コミュニティへの貢献とベストプラクティスの共有に参加
ヘルプの入手
公式リソース
- 公式ドキュメント: https://docs.dify.ai/
- GitHub: https://github.com/langgenius/dify
- プラグインマーケット: https://marketplace.dify.ai/
- 公式ブログ: https://dify.ai/blog/
コミュニティリソース
- Discord: https://discord.gg/FngNHpbcY7
- Reddit: https://reddit.com/r/difyai
- 中文コミュニティ: https://github.com/langgenius/dify/discussions
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 を選んで深く学ぶか、テンプレートを直接使ってすぐに始めてください。