wp-project-triage

Descripción general de wp-project-triage

Qué hace wp-project-triage

La habilidad wp-project-triage es un inspector rápido y determinista para una primera pasada sobre repositorios de WordPress. Identifica el tipo de proyecto más probable, detecta tooling y pruebas, expone pistas de versiones y devuelve un informe estructurado para que puedas elegir el flujo de trabajo correcto sin adivinar. Si necesitas wp-project-triage para Workflow Automation, este es el tipo de habilidad que ayuda a un agente a decidir qué hacer después antes de editar nada.

Quién debería usarlo

Usa la wp-project-triage skill cuando llegues a una base de código de WordPress y necesites saber si se trata de un plugin, un theme, un block theme, un site, WP core o un repositorio relacionado con Gutenberg. Es especialmente útil para agentes y mantenedores que quieren un paso de triage repetible antes de implementar, revisar o probar.

Por qué es diferente

El valor principal de wp-project-triage no está en resumir con prosa, sino en apoyar decisiones. Lee las señales del repositorio, aplica guardarraíles y genera un informe JSON en el que puedes confiar más que en un prompt genérico. Eso lo hace mejor opción que pedirle a un LLM que “averigüe el repo” a partir de unos pocos nombres de archivo.

Cómo usar wp-project-triage

Instálalo y apunta al root del repositorio

Para wp-project-triage install, añade la habilidad a tu workspace de agente con el comando estándar de skills y ejecútala desde la raíz del repositorio para que el detector pueda inspeccionar la estructura real del proyecto. La habilidad espera un entorno basado en filesystem con bash y Node disponibles; algunos flujos también dependen de WP-CLI.

Lee primero estos archivos

Empieza con skills/wp-project-triage/SKILL.md y después revisa references/triage.schema.json para entender la forma del reporte. El repo también incluye scripts/detect_wp_project.mjs, que es el archivo clave si quieres entender cómo funcionan la clasificación y la detección de señales. Estos tres archivos te dicen más que una mirada superficial al árbol de directorios.

Convierte un objetivo vago en un prompt útil

Un buen prompt de wp-project-triage usage dice qué decisión quieres tomar, no solo que quieres un escaneo. Por ejemplo: “Run wp-project-triage on this repo and tell me whether it looks like a plugin or block theme, what tooling is present, and what guardrails I should follow before changing code.” Eso le da a la habilidad suficiente intención para producir un informe de triage accionable.

Usa el informe para elegir el siguiente flujo de trabajo

Después de ejecutar el detector, usa la salida para decidir si debes revisar la configuración de build, la preparación de tests, las restricciones de versión o la estructura del contenido. Si el informe dice unknown, trátalo como una señal para comprobar si estás en el root correcto o si el repo necesita mejores reglas de detección, en lugar de forzar una conjetura. Vuelve a ejecutar el detector después de cambios estructurales como añadir theme.json, block.json o tooling de build.

Preguntas frecuentes sobre wp-project-triage

¿wp-project-triage es solo para repositorios de WordPress?

Sí, ese es su uso previsto. La wp-project-triage guide está diseñada para formas de proyecto de WordPress como plugins, themes, block themes, repos de site, core y Gutenberg. Si no trabajas en ese ecosistema, suele ser mejor una exploración genérica del filesystem o un clasificador de repositorio distinto.

¿Necesito WP-CLI para usarlo?

No siempre. La habilidad puede seguir siendo útil en un entorno solo con filesystem, pero algunos flujos posteriores pueden esperar WP-CLI o tooling cercano a WordPress. El objetivo de wp-project-triage es decirte qué hay presente para que sepas si esos pasos posteriores son realistas.

¿Es mejor que pedirle a una IA que inspeccione el repo directamente?

Normalmente sí para la primera pasada. Un prompt normal puede pasar por alto pistas de versión, ignorar señales o inventar estructura cuando el árbol es ambiguo. wp-project-triage te da una ruta repetible de instalación y ejecución, un contrato de salida definido y una tarea más acotada: clasificar primero y actuar después.

¿Cuándo no debería usarlo?

No lo uses como sustituto de una revisión de código, una auditoría de seguridad o un análisis profundo de arquitectura. Es una capa de triage, no un diagnóstico completo. Si ya conoces el tipo exacto de proyecto y necesitas una tarea de código específica, puede que no necesites este paso.

Cómo mejorar la habilidad wp-project-triage

Dale condiciones de inicio más limpias

La forma más eficaz de mejorar los resultados de wp-project-triage es ejecutarlo desde el verdadero root del repo y evitar checkouts parciales o directorios de trabajo anidados. Si el detector está escaneando la carpeta equivocada, el informe pierde utilidad de inmediato. Esto importa más que un prompt elaborado.

Aporta contexto que cambie la decisión

Si quieres un mejor wp-project-triage usage, menciona el resultado concreto que necesitas: clasificación plugin vs theme, detección de tooling de build o preparación para tests. Eso te ayuda a evaluar si el informe es lo bastante completo para el siguiente paso. Un buen prompt de seguimiento podría pedir “the minimal safe edit path” en lugar de “summarize everything”.

Vigila los modos de fallo habituales

El principal modo de fallo es una clasificación unknown o poco específica causada por señales ausentes, una estructura de repositorio inusual o directorios ignorados. Otro es confiar demasiado en el primer informe cuando el repo tiene archivos generados pero pocas pistas de origen. Si eso ocurre, mejora las entradas del detector o amplía las reglas de ignore en lugar de improvisar.

Itera después de la primera ejecución

Usa el primer informe para identificar huecos y luego vuelve a ejecutar wp-project-triage después de añadir pistas que faltan como theme.json, block.json, configuración de tests o metadatos de versión. La habilidad funciona mejor como un guardarraíl iterativo: detectar, verificar, ajustar y detectar otra vez.