SystemTce/dify-skills

Um conjunto completo de habilidades para desenvolvimento de workflows e plugins Dify - modular, progressivo e orientado à prática.

O que é dify-skills?

Este skill, Dify Master SKILL, é um guia modular e progressivo para dominar a plataforma Dify, um LLMOps open-source que oferece orquestração visual de workflows e um sistema de plugins poderoso para criar e implantar aplicações de IA rapidamente. Ele é organizado em seis sub-skills independentes que cobrem todo o ciclo de vida do desenvolvimento: design de workflows, desenvolvimento de plugins, otimização de desempenho, segurança e implantação, integração com sistemas externos e referências técnicas. O skill foi projetado para ser prático e eficiente, minimizando a carga de informações com uma abordagem de revelação progressiva, fornecendo templates, códigos e configurações prontas para uso. É compatível com agentes de IA como Claude Code, Cursor e Codex, e serve como ponto de partida ideal tanto para iniciantes quanto para desenvolvedores experientes que desejam construir aplicações IA robustas e escaláveis com Dify.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add SystemTce/dify-skills

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Dify Master SKILL

Um sistema de habilidades de desenvolvimento Dify modular e de revelação progressiva

Navegação Rápida


O que é Dify

Dify é uma plataforma LLMOps de código aberto que oferece orquestração visual de workflows e um sistema de plugins robusto, ajudando desenvolvedores a criar e implantar aplicações de IA de forma rápida.

Características Principais

  • Workflow Visual: Orquestração por arrastar e soltar, permitindo construir aplicações de IA complexas sem codificação.
  • Sistema de Plugins: Suporta vários tipos de plugins, como ferramentas, modelos e fontes de dados.
  • Pronto para Produção: Suporte completo, do desenvolvimento local à implantação distribuída em larga escala.
  • Ecossistema Open Source: Mais de 114.000 estrelas no GitHub, comunidade ativa e um rico mercado de plugins.

Arquitetura Técnica

  • Arquitetura Beehive: Design de sistema modular e extensível.
  • Mecanismo de Grafo Orientado a Filas: Orientado a eventos, execução paralela e alta performance.
  • Suporte a Múltiplos Runtimes: Três modos de execução: Local, Debug e Serverless.
  • Integração com Protocolo MCP: Integração padronizada com assistentes de IA como Claude.

Visão Geral do Sistema de Habilidades

O Dify Master SKILL adota um design modular, contendo 6 sub-habilidades centrais que cobrem todo o processo, do desenvolvimento à implantação.

dify-master (ponto de entrada principal)
├── 01-workflow      # Design de workflow
├── 02-plugin        # Desenvolvimento de plugins
├── 03-performance   # Otimização de desempenho
├── 04-security      # Segurança e implantação
├── 05-integration   # Integração e extensão
└── 06-reference     # Materiais de referência

Filosofia de Design

  1. Modular: Cada sub-habilidade é independente e completa, podendo ser usada isoladamente.
  2. Revelação Progressiva: Da visão geral aos detalhes, aprofunde-se conforme necessário.
  3. Otimização de Contexto: Minimiza a quantidade de conteúdo carregado por vez.
  4. Orientado à Prática: Fornece código e configurações prontos para uso.

Início Rápido

Cenário 1: Criar seu primeiro workflow

# Workflow simples de perguntas e respostas
workflow:
  graph:
    nodes:
    - data:
        type: start
        variables: []
      id: start

    - data:
        type: llm
        model:
          provider: openai
          name: gpt-4
        prompt_template:
        - role: system
          text: "Você é um assistente."
        - role: user
          text: "{{#sys.query#}}"
      id: llm

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

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

Próximo passo: Aprenda mais tipos de nós e padrões de design com a sub-habilidade 01-workflow

Cenário 2: Desenvolver seu primeiro plugin

# Plugin de ferramenta simples
typing import Any, Generator
dify_plugin.entities.tool import ToolInvokeMessage
dify_plugin import Tool

class MyTool(Tool):
    def _invoke(
        self,
        tool_parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        # Obter parâmetros
        input_text = tool_parameters.get("text", "")

        # Lógica de processamento
        result = input_text.upper()

        # Retornar resultado
        yield self.create_text_message(result)

Próximo passo: Aprenda o processo completo de desenvolvimento de plugins com a sub-habilidade 02-plugin

Cenário 3: Otimizar o desempenho do workflow

# Usar branches paralelas para melhorar o desempenho
- data:
    type: parallel
    branches:
    - nodes: [tool1, process1]
    - nodes: [tool2, process2]
    - nodes: [tool3, process3]
  id: parallel_execution

Próximo passo: Aprenda mais técnicas de otimização com a sub-habilidade 03-performance


Índice de Sub-habilidades

01. Sub-habilidade de Design de Workflow

Cenários de uso: Projetar e desenvolver workflows no Dify

Palavras-chave de ativação: nó, LLM, Agente, workflow, variável, recuperação de conhecimento, Requisição HTTP, Código, If-Else, Iteração, template, DSL, YAML

Conteúdo principal:

  • Explicação detalhada de mais de 10 tipos de nós (Start, LLM, Agent, Knowledge Retrieval, Code, HTTP Request, Tool, If-Else, Iteration, Answer)
  • 5 padrões de design (Pipeline sequencial, Ramificação condicional, Processamento iterativo, Recuperação de conhecimento, Agregação de múltiplas fontes)
  • Templates de workflow prontos para uso
  • Sistema de variáveis e sintaxe de referência
  • Melhores práticas e perguntas frequentes

Acesso rápido: 01-workflow/SKILL.md

Recomendado para: Designers de workflow, desenvolvedores de aplicações de IA, gerentes de produto


02. Sub-habilidade de Desenvolvimento de Plugins

Cenários de uso: Desenvolver plugins personalizados para ferramentas, modelos e fontes de dados

Palavras-chave de ativação: plugin, Tool, Provider, desenvolvimento, manifest, OAuth, fonte de dados, modelo, extensão

Conteúdo principal:

  • 4 tipos de plugins (Tool, Model, Datasource, Extension)
  • Fluxo completo de desenvolvimento (inicialização, implementação, teste, empacotamento, publicação)
  • Estrutura de projeto padrão e arquivos de configuração
  • Guia de desenvolvimento de Provider e Tool
  • Templates de plugins e exemplos de código
  • Estratégias de teste e dicas de depuração

Acesso rápido: 02-plugin/SKILL.md

Recomendado para: Desenvolvedores de plugins, engenheiros backend, integradores de ferramentas


03. Sub-habilidade de Otimização de Desempenho

Cenários de uso: Otimizar o desempenho de execução de workflows e plugins

Palavras-chave de ativação: desempenho, performance, otimização, cache, paralelo, latência, throughput, monitoramento, benchmark

Conteúdo principal:

  • Otimização de workflows (estrutura do grafo, execução paralela, pool de variáveis)
  • Otimização de LLMs (seleção de modelos, engenharia de prompt, cache, saída estruturada)
  • Otimização de plugins (seleção de runtime, limites de recursos, processamento assíncrono)
  • Ferramentas de monitoramento e análise
  • Testes de benchmark de desempenho

Acesso rápido: 03-performance/SKILL.md

Recomendado para: Engenheiros de desempenho, arquitetos, pessoal de operações


04. Sub-habilidade de Segurança e Implantação

Cenários de uso: Implantação em produção e reforço de segurança

Palavras-chave de ativação: segurança, security, implantação, deploy, Docker, Kubernetes, SSL, autenticação, autorização, sandbox, SSRF

Conteúdo principal:

  • Práticas de segurança (proteção SSRF, isolamento em sandbox, criptografia de dados, autenticação/autorização)
  • Guias de implantação (Docker Compose, Kubernetes, Serverless, Alta disponibilidade)
  • Práticas de operação (monitoramento, logs, backup, solução de problemas)
  • Configuração de ambiente e planejamento de recursos
  • Melhores práticas e casos de uso

Acesso rápido: 04-security/SKILL.md

Recomendado para: Engenheiros DevOps, engenheiros de segurança, administradores de sistemas


05. Sub-habilidade de Integração e Extensão

Cenários de uso: Integração com sistemas e serviços externos

Palavras-chave de ativação: integração, integration, API, Webhook, MCP, Servidor, Cliente, banco de dados, Redis, fila de mensagens, RabbitMQ, Kafka, S3

Conteúdo principal:

  • Integração de API (REST API, Webhook, Streaming)
  • Protocolo MCP (Servidor MCP, Cliente MCP, comunicação bidirecional)
  • Serviços externos (bancos de dados, armazenamento, filas de mensagens)
  • Casos de integração e melhores práticas
  • Solução de problemas e depuração

Acesso rápido: 05-integration/SKILL.md

Recomendado para: Engenheiros de integração, desenvolvedores full-stack, arquitetos


06. Sub-habilidade de Referências

Cenários de uso: Consultar informações de referência como sintaxe, API, CLI, etc.

Palavras-chave de ativação: referência, reference, API, SDK, CLI, DSL, YAML, comando, documentação, sintaxe

Conteúdo principal:

  • Referência de sintaxe DSL (estrutura YAML completa e descrição de campos)
  • Referência de API (documentação da interface RESTful)
  • Referência de SDK (classes e métodos do Python SDK)
  • Referência de CLI (ferramentas de linha de comando do dify)
  • Perguntas frequentes e soluções
  • Recursos de aprendizado e links da comunidade

Acesso rápido: 06-reference/SKILL.md

Recomendado para: Todos os desenvolvedores Dify


Referências Comuns

Sintaxe de Referência de Variáveis

# Variáveis do sistema
{{#sys.query#}}              # Consulta do usuário
{{#sys.files#}}              # Arquivos enviados
{{#sys.conversation_id#}}    # ID da conversa

# Saída de nós
{{#ID_do_nó.campo_de_saída#}}   # Referenciar saída de nó
{{#llm.text#}}               # Saída de texto do LLM
{{#knowledge.result#}}       # Resultado da recuperação de conhecimento

# Variáveis da conversa
{{#conversation.nome_da_variável#}}  # Variável de nível de conversa

# Variáveis de iteração
{{#item#}}                   # Item atual da iteração
{{#index#}}                  # Índice atual

Configuração Comum de Nós

# Nó LLM
- data:
    type: llm
    model:
      provider: openai
      name: gpt-4
      completion_params:
        temperature: 0.7
        max_tokens: 2000
    prompt_template:
    - role: system
      text: "Prompt do sistema"
    - role: user
      text: "{{#sys.query#}}"
    context:
      enabled: true
      variable_selector: ["knowledge", "result"]

# Nó Agente
- data:
    type: agent
    agent_parameters:
      instruction:
        value: "Chame ferramentas conforme a necessidade do usuário"
      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

# Nó de Recuperação de Conhecimento
- data:
    type: knowledge-retrieval
    dataset_ids: ["id-do-dataset"]
    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

Template de Configuração de Plugin

# manifest.yaml
version: 0.0.1
type: plugin
author: your-name
name: plugin-name
label:
  en_US: Plugin Name
  pt_BR: Nome do Plugin
description:
  en_US: Plugin description
  pt_BR: Descrição do Plugin
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

Comandos CLI Comuns

# Desenvolvimento de plugins
dify plugin init                    # Inicializar projeto de plugin
dify plugin run                     # Depurar plugin localmente
dify plugin package                 # Empacotar plugin
dify plugin publish                 # Publicar plugin

# Gerenciamento de workflows
dify workflow export <id>           # Exportar workflow
dify workflow import <arquivo>      # Importar workflow
dify workflow validate <arquivo>    # Validar workflow

# Gerenciamento de ambiente
dify env list                       # Listar variáveis de ambiente
dify env set <chave> <valor>        # Definir variável de ambiente
dify env get <chave>                # Obter variável de ambiente

Caminho de Aprendizado

Caminho para Iniciantes (0-1 semana)

  1. Leia este SKILL para ter uma visão geral do Dify.
  2. Aprenda a sub-habilidade 01-workflow para dominar os fundamentos de workflow.
  3. Use um template para criar seu primeiro workflow.
  4. Teste e depure na plataforma Dify.

Caminho Intermediário (1-4 semanas)

  1. Aprofunde-se nos padrões de design da sub-habilidade 01-workflow.
  2. Aprenda a sub-habilidade 02-plugin para desenvolver plugins personalizados.
  3. Aprenda a sub-habilidade 03-performance para otimizar o desempenho.
  4. Construa um projeto real e implante-o.

Caminho para Especialistas (1-3 meses)

  1. Domine o conteúdo de todas as sub-habilidades.
  2. Aprenda a sub-habilidade 04-security para implantações em produção.
  3. Aprenda a sub-habilidade 05-integration para integrar sistemas externos.
  4. Participe de contribuições da comunidade e compartilhe melhores práticas.

Obter Ajuda

Recursos Oficiais

Recursos da Comunidade

Suporte do SKILL

  • Documentação de arquitetura: ARCHITECTURE.md
  • Relatar problemas: Submeta via GitHub Issues
  • Guia de contribuição: Participe da melhoria e expansão do conteúdo do SKILL

Informações da Versão

  • Versão atual: v1.1.0
  • Última atualização: 2026-03-05
  • Versões compatíveis do Dify: 0.15.x - 1.9.x
  • Novidades: Sub-habilidades 05-integration e 06-reference aprimoradas, adicionado mecanismo de carregamento sob demanda.
  • Próxima versão planejada: v1.2.0 (mais templates e casos de uso)

Licença

Este SKILL é de código aberto sob a licença MIT. Sinta-se à vontade para usar, modificar e distribuir.


Comece sua jornada de desenvolvimento com Dify! Escolha uma sub-habilidade para aprender em profundidade ou use um template para começar rapidamente.

Individual skills in this repo

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

Habilidades Relacionadas