Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Os fluxos de trabalho permitem que os usuários definam uma série de etapas para orientar o Cascade em tarefas repetitivas, como implantar um serviço ou responder a comentários em PRs. Esses fluxos de trabalho são salvos como arquivos markdown, oferecendo aos usuários e às suas equipes uma forma simples e reutilizável de executar processos importantes. Depois de salvos, os fluxos de trabalho podem ser invocados no Cascade por meio de um comando de barra no formato /[name-of-workflow].
Os fluxos de trabalho são somente manuais — o Cascade nunca invocará um fluxo de trabalho automaticamente. Se você quiser que o Cascade execute um procedimento por conta própria, use uma skill.

​
Como funciona

Em geral, Rules fornecem orientação aos modelos de linguagem de grande escala ao adicionar contexto persistente e reutilizável no nível do prompt. fluxos de trabalho ampliam esse conceito ao fornecer uma sequência estruturada de etapas ou prompts no nível da trajetória, guiando o modelo por uma série de tarefas ou ações interconectadas.
Para executar um fluxo de trabalho, basta invocá-lo no Cascade com o comando /[workflow-name].
Você pode chamar outros fluxos de trabalho de dentro de um fluxo de trabalho!

Por exemplo, /workflow-1 pode incluir instruções como “Chame /workflow-2” e “Chame /workflow-3”.
Quando invocado, o Cascade processa em sequência cada etapa definida no fluxo de trabalho, executando ações ou gerando respostas conforme especificado.

​
Como criar um fluxo de trabalho

Para começar a usar os fluxos de trabalho, clique no ícone Customizations no menu lateral deslizante no canto superior direito do Cascade e, em seguida, vá até o painel Workflows. Ali, você pode clicar no botão + Workflow para criar um novo fluxo de trabalho. Os fluxos de trabalho são salvos como arquivos Markdown em diretórios .windsurf/workflows/ e contêm um título, uma descrição e uma série de etapas com instruções específicas para o Cascade seguir.

​
Descoberta de fluxos de trabalho

O Devin Desktop descobre automaticamente fluxos de trabalho em vários locais para permitir uma organização flexível:
  • Workspace atual e subdiretórios: Todos os diretórios .windsurf/workflows/ no seu workspace atual e em seus subdiretórios
  • Estrutura do repositório Git: Em repositórios Git, o Devin Desktop também procura até a raiz do repositório para encontrar fluxos de trabalho em diretórios pai
  • Suporte a múltiplos workspaces: Quando várias pastas estão abertas no mesmo workspace, os fluxos de trabalho são deduplicados e exibidos com o caminho relativo mais curto

​
Locais de armazenamento de fluxos de trabalho

EscopoLocalObservações
Workspace.windsurf/workflows/*.mdNo seu workspace atual, em qualquer subdiretório ou em qualquer diretório pai até a raiz do git. Comitado junto com o repositório.
Global~/.codeium/windsurf/global_workflows/*.mdDisponível em todos os workspaces da sua máquina. Não é comitado.
NativoGerenciado pelo Devin DesktopTemplates fornecidos com o Devin Desktop (por exemplo, /plan).
Sistema (Enterprise)Específico do SO (por exemplo, /etc/windsurf/workflows/)Implantado pela TI, somente leitura para usuários finais.
Ao criar um novo fluxo de trabalho pela UI, ele será salvo no diretório .windsurf/workflows/ do seu workspace atual, não necessariamente na raiz do git. Para criar um fluxo de trabalho global, use o botão + Global no painel Workflows ou crie o arquivo diretamente em ~/.codeium/windsurf/global_workflows/. Os arquivos de fluxo de trabalho têm limite de 12000 caracteres cada.

​
Gerar um fluxo de trabalho com Cascade

Você também pode pedir que o Cascade gere fluxos de trabalho para você! Isso funciona especialmente bem para fluxos de trabalho que envolvem uma série de etapas em uma ferramenta de CLI específica.

​
Exemplos de fluxos de trabalho

Há inúmeros casos de uso para fluxos de trabalho, como:

/address-pr-comments

Este é um fluxo de trabalho que nossa equipe usa internamente para tratar comentários em PRs:
1. Faça checkout da branch da PR: `gh pr checkout [id]`

2. Obtenha os comentários da PR

 bash
 gh api --paginate repos/[owner]/[repo]/pulls/[id]/comments | jq '.[] | {user: .user.login, body, path, line, original_line, created_at, in_reply_to_id, pull_request_review_id, commit_id}'

3. Para CADA comentário, faça o seguinte. Lembre-se de tratar um comentário por vez.
 a. Imprima o seguinte: "(index). De [user] em [file]:[lines] — [body]"
 b. Analise o arquivo e o intervalo de linhas.
 c. Se você não entender o comentário, não faça nenhuma alteração. Apenas me peça esclarecimentos ou peça que eu mesmo implemente a mudança.
 d. Se você achar que consegue fazer a alteração, faça a alteração ANTES de passar para o próximo comentário.

4. Depois que todos os comentários forem processados, resuma o que você fez e quais comentários precisam da atenção do USUÁRIO.

/git-workflows

Faça commit usando formatos predefinidos e crie pull requests com títulos e descrições padronizados usando os comandos de CLI apropriados.

/dependency-management

Automatize a instalação ou a atualização das dependências do projeto com base em um arquivo de configuração (e.g., requirements.txt, package.json).

/code-formatting

Execute automaticamente formatadores de código (como Prettier, Black) e linters (como ESLint, Flake8) ao salvar arquivos ou antes de fazer commit para manter o estilo do código e detectar erros mais cedo.

/run-tests-and-fix

Execute ou adicione testes unitários ou de ponta a ponta e corrija os erros automaticamente para garantir a qualidade do código antes de fazer commit, mesclar ou implantar.

/deployment

Automatize as etapas para implantar sua aplicação em vários ambientes (desenvolvimento, staging, produção), incluindo as verificações necessárias antes da implantação e as validações após a implantação.

/security-scan

Integre e acione varreduras de vulnerabilidades de segurança na sua base de código como parte do pipeline de CI/CD ou sob demanda.

​
fluxos de trabalho em nível de sistema (Enterprise)

As organizações Enterprise podem implantar fluxos de trabalho em nível de sistema que ficam disponíveis globalmente em todos os workspaces e não podem ser modificados por usuários finais sem permissão de administrador. Isso é ideal para impor processos de desenvolvimento em toda a organização, procedimentos de implantação e fluxos de trabalho de conformidade. Os fluxos de trabalho em nível de sistema são carregados de diretórios específicos do sistema operacional: macOS: 
/Library/Application Support/Windsurf/workflows/*.md
Linux/WSL: 
/etc/windsurf/workflows/*.md
Windows: 
C:\ProgramData\Windsurf\workflows\*.md
Coloque seus arquivos de fluxo de trabalho (como arquivos .md) no diretório apropriado para o seu sistema operacional. O sistema carregará automaticamente todos os arquivos .md desses diretórios.

​
Precedência dos fluxos de trabalho

Quando existem fluxos de trabalho com o mesmo nome em vários níveis, os fluxos de trabalho no nível do sistema têm a maior precedência:
  1. Sistema (maior prioridade) - Fluxos de trabalho de toda a organização implantados pela TI
  2. Workspace - Fluxos de trabalho específicos do projeto em .windsurf/workflows/
  3. Global - Fluxos de trabalho definidos pelo usuário em ~/.codeium/windsurf/global_workflows/
  4. Nativo - Fluxos de trabalho padrão fornecidos pelo Devin Desktop
Isso significa que, se uma organização implantar um fluxo de trabalho no nível do sistema com um determinado nome, ele sobrescreverá qualquer fluxo de trabalho de workspace, global ou nativo com o mesmo nome. Na UI do Devin Desktop, os fluxos de trabalho no nível do sistema são exibidos com o rótulo “System” e não podem ser excluídos pelos usuários finais.
Importante: Os fluxos de trabalho no nível do sistema devem ser gerenciados pela sua equipe de TI ou de segurança. Garanta que suas equipes internas cuidem da implantação, das atualizações e da conformidade de acordo com as políticas da sua organização. Para isso, você pode usar ferramentas e fluxos de trabalho padrão, como Mobile Device Management (MDM) ou Configuration Management.