Flujos de trabajo de Cascade

Los flujos de trabajo permiten a los usuarios definir una serie de pasos para guiar a Cascade en un conjunto repetitivo de tareas, como desplegar un servicio o responder a comentarios en una PR. Estos flujos de trabajo se guardan como archivos markdown, lo que ofrece a los usuarios y sus equipos una forma sencilla y repetible de ejecutar procesos clave. Una vez guardados, los flujos de trabajo pueden invocarse en Cascade mediante un comando de barra diagonal con el formato /[name-of-workflow].

Los flujos de trabajo son exclusivamente manuales: Cascade nunca invocará un flujo de trabajo automáticamente. Si quieres que Cascade siga un procedimiento por sí sola, usa una Skill en su lugar.

Los flujos de trabajo son específicos de Cascade: el agente local de Devin no los admite. Migra tus flujos de trabajo a skills con el comando Devin: Open Cascade Migration Wizard.

Cómo funciona

Por lo general, Rules proporciona orientación a los modelos de lenguaje de gran tamaño al ofrecer contexto persistente y reutilizable a nivel del prompt. Los flujos de trabajo amplían este concepto al proporcionar una secuencia estructurada de pasos o prompts a nivel de la trayectoria, guiando al modelo a través de una serie de tareas o acciones interconectadas.

Para ejecutar un flujo de trabajo, los usuarios solo tienen que invocarlo en Cascade con el comando /[workflow-name].

¡Puedes llamar a otros flujos de trabajo desde dentro de un flujo de trabajo!

Por ejemplo, /workflow-1 puede incluir instrucciones como “Llama a /workflow-2” y “Llama a /workflow-3”.

Al invocarlo, Cascade procesa secuencialmente cada paso definido en el flujo de trabajo y realiza acciones o genera respuestas según se especifique.

Cómo crear un flujo de trabajo

Para empezar a usar flujos de trabajo, haz clic en el icono Customizations del menú lateral desplegable de la esquina superior derecha en Cascade y luego ve al panel Workflows. Allí, puedes hacer clic en el botón + Global o + Workspace para crear un nuevo flujo de trabajo a nivel global o de workspace, respectivamente. Los flujos de trabajo se guardan como archivos markdown dentro de los directorios .devin/workflows/ (o el legacy .windsurf/workflows/) y contienen un título, una descripción y una serie de pasos con instrucciones específicas que Cascade debe seguir.

Detección de flujos de trabajo

Devin Desktop detecta automáticamente flujos de trabajo en varias ubicaciones para ofrecer una organización flexible:

workspace actual y subdirectorios: Todos los directorios .devin/workflows/ (y los legacy .windsurf/workflows/) dentro de tu workspace actual y de sus subdirectorios
Estructura del repositorio Git: En los repositorios Git, Devin Desktop también busca hasta el directorio raíz de Git para encontrar flujos de trabajo en directorios superiores
Compatibilidad con múltiples workspaces: Cuando hay varias carpetas abiertas en el mismo workspace, se eliminan los flujos de trabajo duplicados y se muestran con la ruta relativa más corta

Ubicaciones de almacenamiento de los flujos de trabajo

Ámbito	Ubicación	Notas
workspace	`.devin/workflows/.md` (preferido) o `.windsurf/workflows/.md` (fallback)	En tu workspace actual, cualquier subdirectorio o cualquier directorio superior hasta la raíz de Git. Se confirma con tu repositorio.
Global	`~/.codeium/windsurf/global_workflows/*.md`	Disponible en todos los workspaces de tu máquina. No se confirma.
Integrado	Gestionado por Devin Desktop	Plantillas incluidas con Devin Desktop (p. ej., `/plan`).
Sistema (Enterprise)	Específico del SO (p. ej., `/etc/devin/workflows/`, legacy `/etc/windsurf/workflows/`)	Implementado por TI, de solo lectura para los usuarios finales.

Cuando creas un nuevo flujo de trabajo mediante la interfaz de usuario, se guardará en el directorio .devin/workflows/ de tu workspace actual, no necesariamente en la raíz de Git. Si rechazaste la migración para un workspace que aún tiene un directorio .windsurf/, se guarda en .windsurf/workflows/ en su lugar. Para crear un flujo de trabajo global, usa el botón + Global en el panel flujos de trabajo o crea el archivo directamente en ~/.codeium/windsurf/global_workflows/. Los archivos de flujo de trabajo están limitados a 12000 caracteres cada uno.

Genera un flujo de trabajo con Cascade

¡También puedes pedirle a Cascade que genere flujos de trabajo por ti! Esto funciona especialmente bien para flujos de trabajo que implican una serie de pasos en una herramienta de CLI concreta.

Ejemplos de flujos de trabajo

Hay muchísimos casos de uso para los flujos de trabajo, como:

/address-pr-comments

Este es un flujo de trabajo que nuestro equipo usa internamente para responder a comentarios de una PR:

1. Haz checkout de la rama de la PR: `gh pr checkout [id]`

2. Obtén los comentarios de la 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 comentario, haz lo siguiente. Recuerda abordar un comentario a la vez.
 a. Imprime lo siguiente: "(index). De [user] en [file]:[lines] — [body]"
 b. Analiza el archivo y el rango de líneas.
 c. Si no entiendes el comentario, no hagas ningún cambio. Solo pídeme una aclaración o que lo implemente yo mismo.
 d. Si crees que puedes hacer el cambio, hazlo ANTES de pasar al siguiente comentario.

4. Después de procesar todos los comentarios, resume lo que hiciste e indica qué comentarios requieren la atención del USUARIO.

/git-workflows

Crea commits con formatos predefinidos y pull requests con títulos y descripciones estandarizados usando los comandos de CLI adecuados.

/dependency-management

Automatiza la instalación o actualización de las dependencias del proyecto según un archivo de configuración (p. ej., requirements.txt, package.json).

/code-formatting

Ejecuta automáticamente formateadores de código (como Prettier, Black) y linters (como ESLint, Flake8) al guardar archivos o antes de confirmar para mantener el estilo del código y detectar errores cuanto antes.

/run-tests-and-fix

Ejecuta o agrega pruebas unitarias o de extremo a extremo y corrige los errores automáticamente para garantizar la calidad del código antes de confirmar, fusionar o desplegar.

/deployment

Automatiza los pasos para desplegar tu aplicación en varios entornos (desarrollo, staging, producción), incluidas las comprobaciones necesarias antes del despliegue y las verificaciones posteriores.

/security-scan

Integra y activa análisis de vulnerabilidades de seguridad en tu base de código como parte del pipeline de CI/CD o bajo demanda.

Flujos de trabajo del sistema (Enterprise)

Las organizaciones Enterprise pueden implementar flujos de trabajo del sistema que están disponibles de forma global en todos los workspaces y que los usuarios finales no pueden modificar sin permisos de administrador. Esto resulta ideal para hacer cumplir procesos de desarrollo en toda la organización, procedimientos de despliegue y flujos de trabajo de cumplimiento normativo. Los flujos de trabajo del sistema se cargan desde directorios específicos del sistema operativo. Devin Desktop carga el directorio de flujos de trabajo Devin si existe y solo recurre al directorio de flujos de trabajo legacy Windsurf cuando no existe. Los dos no se combinan, así que mueve cualquier flujo de trabajo legacy al directorio Devin cuando lo crees: macOS:

/Library/Application Support/Devin/workflows/*.md
/Library/Application Support/Windsurf/workflows/*.md   # fallback legacy

Linux/WSL:

/etc/devin/workflows/*.md
/etc/windsurf/workflows/*.md   # fallback legacy

Windows:

C:\ProgramData\Devin\workflows\*.md
C:\ProgramData\Windsurf\workflows\*.md   # fallback legacy

Coloca tus archivos de flujo de trabajo (como archivos .md) en el directorio correspondiente a tu sistema operativo. El sistema cargará automáticamente todos los archivos .md de estos directorios.

Precedencia de los flujos de trabajo

Cuando existen flujos de trabajo con el mismo nombre en varios niveles, los flujos de trabajo del sistema tienen la máxima precedencia:

Sistema (máxima prioridad) - flujos de trabajo de toda la organización desplegados por TI
workspace - flujos de trabajo específicos del proyecto en .devin/workflows/ (o el legacy .windsurf/workflows/)
Global - flujos de trabajo definidos por el usuario en ~/.codeium/windsurf/global_workflows/
Integrados - flujos de trabajo predeterminados proporcionados por Devin Desktop

Esto significa que, si una organización despliega un flujo de trabajo del sistema con un nombre determinado, anulará cualquier flujo de trabajo de workspace, Global o Integrado que tenga ese mismo nombre. En la UI de Devin Desktop, los flujos de trabajo del sistema se muestran con la etiqueta “System” y los usuarios finales no pueden eliminarlos.

Importante: Los flujos de trabajo del sistema deben ser gestionados por tu equipo de TI o de seguridad. Asegúrate de que tus equipos internos se encarguen del despliegue, las actualizaciones y el cumplimiento de acuerdo con las políticas de tu organización. Para ello, puedes usar herramientas y flujos de trabajo estándar, como Mobile Device Management (MDM) o Configuration Management.

Devin Desktop

Centro de control de agentes

Versiones

Complementos de Windsurf

Cuentas

Seguridad

Flujos de trabajo de Cascade

Cómo funciona

Cómo crear un flujo de trabajo

Detección de flujos de trabajo

Ubicaciones de almacenamiento de los flujos de trabajo

Genera un flujo de trabajo con Cascade

Ejemplos de flujos de trabajo

/address-pr-comments

/git-workflows

/dependency-management

/code-formatting

/run-tests-and-fix

/deployment

/security-scan

Flujos de trabajo del sistema (Enterprise)

Precedencia de los flujos de trabajo

​Cómo funciona

​Cómo crear un flujo de trabajo

​Detección de flujos de trabajo

​Ubicaciones de almacenamiento de los flujos de trabajo

​Genera un flujo de trabajo con Cascade

​Ejemplos de flujos de trabajo

/address-pr-comments

/git-workflows

/dependency-management

/code-formatting

/run-tests-and-fix

/deployment

/security-scan

​Flujos de trabajo del sistema (Enterprise)

​Precedencia de los flujos de trabajo

Cómo funciona

Cómo crear un flujo de trabajo

Detección de flujos de trabajo

Ubicaciones de almacenamiento de los flujos de trabajo

Genera un flujo de trabajo con Cascade

Ejemplos de flujos de trabajo

Flujos de trabajo del sistema (Enterprise)

Precedencia de los flujos de trabajo