Saltar al contenido principal
Los flujos de trabajo permiten a los usuarios definir una serie de pasos para guiar a Cascade en tareas repetitivas, como desplegar un servicio o responder a comentarios en PR. Estos flujos de trabajo se guardan como archivos markdown, lo que ofrece a los usuarios y a 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]

​
Cómo funciona

Por lo general, Rules orienta a los modelos de lenguaje mediante contexto persistente y reutilizable a nivel de prompt. Los flujos de trabajo amplían este concepto al proporcionar 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 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, realizando acciones o generando respuestas según se indique.

​
Cómo crear un flujo de trabajo

Para empezar con flujos de trabajo, haz clic en el icono Customizations del menú deslizante de la parte superior derecha de Cascade y, a continuación, ve al panel Workflows. Aquí puedes hacer clic en el botón + Workflow para crear un flujo de trabajo nuevo. Los flujos de trabajo se guardan como archivos markdown en directorios .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

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

​
Ubicaciones de almacenamiento de flujos de trabajo

Los flujos de trabajo pueden almacenarse en cualquiera de estas ubicaciones:
  • .windsurf/workflows/ en el directorio actual de tu espacio de trabajo
  • .windsurf/workflows/ en cualquier subdirectorio de tu espacio de trabajo
  • .windsurf/workflows/ en directorios superiores hasta la raíz de Git (para repositorios Git)
Cuando crees un nuevo flujo de trabajo, se guardará en el directorio .windsurf/workflows/ de tu espacio de trabajo actual, no necesariamente en la raíz de Git. Los archivos de flujo de trabajo están limitados a 12 000 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 con flujos de trabajo que implican una serie de pasos en una herramienta de línea de comandos (CLI) concreta.

​
Flujos de trabajo de ejemplo

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 en PR:
1. Cámbiate a 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 atender 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. Cuando hayas procesado todos los comentarios, resume lo que hiciste e indica qué comentarios requieren la atención del USUARIO.

/git-workflows

Confirma usando formatos predefinidos y crea pull requests con títulos y descripciones estandarizados mediante 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 integrales 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 previas al despliegue y las verificaciones posteriores necesarias.

/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 del sistema (Enterprise)

Las organizaciones Enterprise pueden implementar flujos de trabajo a nivel del sistema que están disponibles globalmente en todos los espacios de trabajo y que los usuarios finales no pueden modificar sin permisos de administrador. Esto es ideal para hacer cumplir procesos de desarrollo de toda la organización, procedimientos de despliegue y flujos de trabajo de cumplimiento normativo. Los flujos de trabajo a nivel del sistema se cargan desde directorios específicos del sistema operativo: macOS: 
/Library/Application Support/Windsurf/workflows/*.md
Linux/WSL: 
/etc/windsurf/workflows/*.md
Windows: 
C:\ProgramData\Windsurf\workflows\*.md
Coloca los archivos de flujo de trabajo (en formato .md) en el directorio correspondiente a tu sistema operativo. El sistema cargará automáticamente todos los archivos .md de esos directorios.

​
Precedencia de los flujos de trabajo

Cuando existen flujos de trabajo con el mismo nombre en distintos niveles, los flujos de trabajo a nivel de sistema tienen la máxima precedencia:
  1. Sistema (máxima prioridad) - Flujos de trabajo de toda la organización desplegados por TI
  2. Espacio de trabajo - Flujos de trabajo específicos del proyecto en .windsurf/workflows/
  3. Global - Flujos de trabajo definidos por el usuario
  4. Integrados - Flujos de trabajo predeterminados proporcionados por Windsurf
Esto significa que, si una organización despliega un flujo de trabajo a nivel de sistema con un nombre específico, anulará cualquier flujo de trabajo de espacio de trabajo, Global o Integrado con el mismo nombre. En la UI de Cascade, los flujos de trabajo a nivel de sistema se muestran con la etiqueta “System” y los usuarios finales no pueden eliminarlos.
Importante: Los flujos de trabajo a nivel de 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.