Saltar al contenido principal
Los Workflows permiten a los usuarios definir una serie de pasos para guiar a Cascade a través de un conjunto repetitivo de tareas, como desplegar un servicio o responder a comentarios en PR. Estos Workflows se guardan como archivos markdown, lo que ofrece a los usuarios y a sus equipos una manera sencilla y repetible de ejecutar procesos clave. Una vez guardados, los Workflows pueden invocarse en Cascade mediante un comando de barra con el formato /[name-of-workflow].
Workflows son solo manuales — Cascade nunca invocará un Workflow automáticamente. Si quieres que Cascade siga un procedimiento por sí solo, usa una Skill en su lugar.

Cómo funciona

Las reglas generalmente ofrecen a los modelos de IA orientación proporcionando contexto persistente y reutilizable a nivel de prompt. Los flujos de trabajo amplían este concepto al definir una secuencia estructurada de pasos o prompts a nivel de trayectoria, guiando al modelo a través de una serie de tareas o acciones interconectadas.
Para ejecutar un Workflow, los usuarios simplemente lo invocan en Cascade usando el comando /[workflow-name].
¡Puedes invocar otros Workflows desde dentro de un Workflow!

Por ejemplo, /workflow-1 puede incluir instrucciones como “Invoca /workflow-2” y “Invoca /workflow-3”.
Al invocarlo, Cascade procesa secuencialmente cada paso definido en el Workflow, realizando acciones o generando respuestas según lo especificado.

Cómo crear un Workflow

Para comenzar con Workflows, haz clic en el icono Customizations en el menú deslizante superior derecho de Cascade y luego ve al panel Workflows. Aquí puedes hacer clic en el botón + Workflow para crear un nuevo Workflow. Los Workflows se guardan como archivos Markdown dentro de los directorios .windsurf/workflows/ y contienen un título, una descripción y una serie de pasos con instrucciones específicas para que Cascade las siga.

Descubrimiento de flujos de trabajo

Windsurf descubre automáticamente flujos de trabajo desde múltiples ubicaciones para ofrecer una organización flexible:
  • workspace actual y subdirectorios: Todos los directorios .windsurf/workflows/ dentro de tu workspace actual y sus subdirectorios
  • Estructura del repositorio Git: Para repositorios Git, Windsurf también busca hasta la raíz del repositorio para encontrar flujos de trabajo en directorios superiores
  • Compatibilidad con múltiples workspaces: Cuando hay varias carpetas abiertas en el mismo workspace, los flujos de trabajo se desduplican y se muestran con la ruta relativa más corta

Ubicaciones de almacenamiento de Workflows

Cuando crees un nuevo Workflow desde la interfaz de usuario, se guardará en el directorio .windsurf/workflows/ de tu workspace actual, no necesariamente en la raíz de git. Para crear un Workflow global, usa el botón + Global en el panel Workflows o crea el archivo directamente en ~/.codeium/windsurf/global_workflows/. Los archivos de Workflow están limitados a 12000 caracteres cada uno.

Generar 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 requieren una serie de pasos en una herramienta CLI específica.

Flujos de trabajo de ejemplo

Hay una infinidad de casos de uso para los flujos de trabajo, como:

/address-pr-comments

Este es un flujo de trabajo que nuestro equipo usa internamente para abordar comentarios en PR:

/git-workflows

Haz commits usando formatos predefinidos y crea pull requests con títulos y descripciones estandarizados utilizando los comandos de la CLI apropiados.

/dependency-management

Automatiza la instalación o actualización de dependencias del proyecto basándote en 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 hacer commit para mantener el estilo de código y detectar errores a tiempo.

/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 hacer commit, fusionar o desplegar.

/deployment

Automatiza los pasos para desplegar tu aplicación en varios entornos (desarrollo, staging, producción), incluidas las verificaciones necesarias previas al despliegue y las 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 a nivel de sistema (Enterprise)

Las organizaciones Enterprise pueden implementar flujos de trabajo a nivel de sistema que están disponibles de forma global en todos los workspaces y no pueden ser modificados por los usuarios finales sin permisos de administrador. Esto es ideal para hacer cumplir procesos de desarrollo a nivel de organización, procedimientos de despliegue y flujos de trabajo de cumplimiento normativo. Los flujos de trabajo a nivel de sistema se cargan desde directorios específicos del sistema operativo: macOS:
Linux/WSL:
Windows:
Coloca tus archivos de flujo de trabajo (como archivos .md) en el directorio adecuado para tu sistema operativo. El sistema cargará automáticamente todos los archivos .md desde estos directorios.

Precedencia de Workflows

Cuando existen Workflows con el mismo nombre en varios niveles, los Workflows a nivel de sistema tienen la prioridad más alta:
  1. System (prioridad más alta) - Workflows para toda la organización implementados por TI
  2. Workspace - Workflows específicos del proyecto en .windsurf/workflows/
  3. Global - Workflows definidos por el usuario en ~/.codeium/windsurf/global_workflows/
  4. Built-in - Workflows predeterminados proporcionados por Windsurf
Esto significa que, si una organización implementa un Workflow a nivel de sistema con un nombre específico, este reemplazará cualquier Workflow de Workspace, Global o Built-in con el mismo nombre. En la interfaz de usuario de Windsurf, los Workflows a nivel de sistema se muestran con la etiqueta “System” y no pueden ser eliminados por los usuarios finales.
Importante: Los Workflows a nivel de sistema deben ser gestionados por tu equipo de TI o de seguridad. Asegúrate de que tus equipos internos se encarguen de la implementación, las actualizaciones y el cumplimiento según las políticas de tu organización. Puedes usar herramientas y Workflows estándar como Mobile Device Management (MDM) o Configuration Management para hacerlo.