Community코딩 & 개발github.com

SystemTce/dify-skills

Dify 워크플로우 및 플러그인 개발을 위한 완전한 스킬 체계 - 모듈식, 점진적, 실용 중심

dify-skills란 무엇인가요?

Dify Master SKILL은 오픈소스 LLMOps 플랫폼인 Dify의 개발자와 AI 에이전트 사용자를 위해 설계된 포괄적인 스킬 체계입니다. 이 스킬은 워크플로우 디자인, 플러그인 개발, 성능 최적화, 보안 및 배포, 통합 및 확장, 참조 자료의 6개 하위 스킬로 모듈화되어 있어 사용자는 자신의 필요에 따라 선택적으로 학습할 수 있습니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 활용할 수 있으며, 점진적 공개 방식을 통해 초보자부터 전문가까지 단계별로 학습할 수 있도록 구성되었습니다. 각 하위 스킬은 구체적인 코드 예제, YAML 설정, CLI 명령어 및 실제 사용 사례를 포함하여 실용적인 학습을 지원하며, Dify의 Beehive 아키텍처, 큐 기반 그래프 엔진, MCP 프로토콜 통합 등 고급 기능까지 다룹니다.

지원 대상✓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 세 가지 실행 모드
  • 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, 에이전트, 워크플로우, 변수, 지식 검색, HTTP 요청, 코드, 조건 분기, 반복, 템플릿, 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, 서버, 클라이언트, 데이터베이스, 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"]

# 에이전트 노드
- 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.

관련 스킬