wordpress-router

Descripción general del skill wordpress-router

wordpress-router es un skill de triaje para WordPress que ayuda a un agente a clasificar rápido un repo y elegir el flujo de trabajo downstream adecuado antes de hacer cambios. Es especialmente útil cuando la solicitud del usuario es amplia o cuando la base de código podría ser un plugin, un tema clásico, un block theme, un paquete de Gutenberg, un checkout de WordPress core o un repo de sitio completo.

Para qué sirve este skill

El skill wordpress-router sirve para enrutar, no para editar. Su función es reducir las suposiciones iniciales identificando el tipo de repo, las herramientas disponibles, las pruebas probables y el skill de dominio más relevante para usar después.

Quién debería instalarlo

Instala wordpress-router si trabajas con frecuencia en bases de código de WordPress y necesitas que un agente decida si debe tratar un repo como trabajo de bloques, theme.json, REST, WP-CLI, seguridad, testing o empaquetado de releases. Resulta especialmente útil para orquestar agentes en repositorios mixtos de WordPress.

Por qué importa

Sin un router, los agentes suelen entrar con el modelo mental equivocado: lógica de tema clásico para un block theme, supuestos de plugin para un repo de sitio o ediciones genéricas en lugar del flujo de trabajo correcto de WordPress. Este skill añade un paso práctico de clasificación que mejora la calidad del prompt downstream y reduce la probabilidad de cambios innecesarios.

Cómo usar el skill wordpress-router

Instala y ubica la ruta de decisión

Usa la ruta de instalación documentada para el skill wordpress-router y, después, empieza por SKILL.md. El repositorio también apunta a references/decision-tree.md, que es la lectura de seguimiento más útil para tomar decisiones de enrutado.

Dale al skill las entradas correctas

El skill wordpress-router funciona mejor cuando proporcionas:

• la raíz del repo o el directorio de trabajo actual,
• la intención real del usuario,
• restricciones de versión, como objetivos de WordPress o requisitos de WP.com,
• cualquier límite estricto sobre tooling, proceso de release o testing.

Una petición débil como “arregla este repo de WordPress” es más difícil de enrutar bien. Una petición más sólida se vería así: “Este es un repo de wp-content; determina si debemos tratarlo como un block theme o como un flujo de trabajo de plugin, y luego planifica la ruta más segura para cambiar una plantilla con las pruebas existentes”.

Flujo de trabajo sugerido para el primer uso

1. Ejecuta el paso de triaje del proyecto descrito en SKILL.md.
2. Lee la salida del triaje para determinar el tipo de proyecto, las herramientas y la cobertura de pruebas.
3. Abre references/decision-tree.md para mapear la intención al siguiente flujo de trabajo.
4. Aplica las convenciones del repositorio antes de editar, especialmente los comandos existentes de build y test.

Qué revisar primero en el repo

Para la guía de wordpress-router, prioriza:

• SKILL.md para el procedimiento de enrutado y las guardas,
• references/decision-tree.md para el enrutado basado en la intención,
• cualquier documentación específica del repo solo después de saber qué tipo de proyecto es.

Ese orden importa porque el skill está diseñado para acotar el camino antes de que inspecciones todo lo demás.

Preguntas frecuentes sobre el skill wordpress-router

¿wordpress-router reemplaza a los skills de dominio?

No. Es un skill de decisión en la capa frontal para Agent Orchestration. Ayuda a elegir el flujo de trabajo correcto de WordPress, pero no reemplaza un skill de bloques, temas, plugins o testing una vez que el repo ya está clasificado.

¿Cuándo no debería usar wordpress-router?

Sáltalo cuando la tarea ya sea estrecha y obvia, como editar un único archivo conocido dentro de un flujo de trabajo claramente identificado. Aporta menos valor cuando no hay ambigüedad de enrutado.

¿Vale la pena instalar wordpress-router para principiantes?

Sí, si es probable que los principiantes trabajen en varios tipos de repos de WordPress. Ofrece un punto de partida más seguro que un prompt genérico, pero sigue esperando que el usuario exprese con claridad la intención y las restricciones.

¿En qué mejora esto a un prompt simple?

Un prompt simple puede pedir un cambio; wordpress-router primero pregunta qué tipo de sistema WordPress es y qué flujo de trabajo debe gobernar el cambio. Ese paso extra de clasificación es la principal ventaja del skill wordpress-router.

Cómo mejorar el skill wordpress-router

Aporta una intención más clara, no solo una tarea

Las mejores entradas nombran el resultado deseado y el contexto del repo. Por ejemplo, en lugar de “hazlo más rápido”, usa “este es un repo de plugin de WordPress; determina si el trabajo de rendimiento debe seguir los flujos de plugin, REST o bloques, y luego sugiere el punto de partida más seguro”.

Añade restricciones que afecten al enrutado

El skill rinde mejor cuando incluyes objetivos de versión de WordPress, requisitos de release y límites de tooling. Estos detalles le ayudan a decidir si el repo debe tratarse como trabajo de core, de sitio, de tema, de plugin o orientado a Gutenberg.

Vigila los modos de fallo habituales

El problema más común es un contexto poco especificado. Si el agente no puede saber si está ante un block theme, un tema clásico, un plugin o un repo de sitio, el siguiente flujo de trabajo puede ser incorrecto. Otro modo de fallo es saltarse el árbol de decisión y pasar directamente a editar.

Itera después de la primera clasificación

Después del primer paso, pide al agente que repita:

• el tipo de repo,
• el skill downstream más probable,
• los archivos que usó para decidir,
• la principal incertidumbre que sigue abierta.

Eso hace que wordpress-router sea más útil para Agent Orchestration porque puedes corregir la ruta antes de que empiecen los cambios de código.