analyse

Panorama general de analyse

Qué hace analyse

La skill analyse es un selector automático para análisis al estilo Kaizen. Te ayuda a elegir la lente adecuada para un objetivo: Gemba Walk para la realidad del código, Value Stream Mapping para flujos de trabajo, o Muda para desperdicio e ineficiencia. Si quieres la skill analyse porque necesitas una forma más rápida de inspeccionar un sistema sin adivinar primero el método, encaja muy bien.

Cuándo encaja mejor esta skill

Usa analyse cuando tengas un área de un codebase, un proceso o una descripción de ineficiencia y quieras una investigación estructurada en lugar de un prompt vago de “revísalo”. Es especialmente útil para Skill Authoring, auditorías de repositorios, revisión de arquitectura y análisis de cuellos de botella en flujos de trabajo.

Por qué instalarla

El valor principal de analyse es la selección del método. En vez de imponer un único estilo de análisis a todos los problemas, mapea tu objetivo al enfoque más adecuado, lo que reduce los falsos arranques y mejora la calidad de la primera pasada.

Cómo usar la skill analyse

Instalación y punto de entrada

Instala la skill con npx skills add NeoLabHQ/context-engineering-kit --skill analyse. El punto de entrada principal es /analyse [target_description], donde el objetivo puede ser una funcionalidad, un flujo de trabajo, un subsistema o un área problemática.

Cómo formular la entrada para analyse

Dale a la skill un objetivo concreto más el tipo de duda que tienes. Mejor: /analyse deployment workflow for slow approvals and failed rollbacks. Peor: /analyse my project. La skill funciona mejor cuando puede inferir si necesitas exploración de código, mapeo de procesos o análisis de desperdicio.

Lee primero estos archivos

Empieza por SKILL.md y luego revisa cualquier guía a nivel de repositorio que pueda influir en el comportamiento dentro de este ecosistema, especialmente README.md, AGENTS.md y metadata.json si existen. En este repositorio, la principal fuente práctica es SKILL.md; no hay scripts auxiliares ni carpetas de soporte que profundicen el flujo de trabajo.

Consejos prácticos de uso

Si ya conoces el método, puedes anular la auto-selección con valores de METHOD como gemba, vsm o muda. Úsalo cuando el objetivo sea ambiguo pero tu meta esté clara. Para obtener mejores resultados, describe el objeto, el resultado que quieres y la restricción que más te importa.

Preguntas frecuentes sobre la skill analyse

¿analyse es solo para código?

No. analyse cubre implementación de código, flujos de trabajo y análisis de desperdicio. El factor decisivo es el tipo de objetivo y lo que quieres aprender, no si la entrada es un repositorio o un proceso.

¿Cuándo no debería usar analyse?

No lo uses cuando ya tengas una tarea estrecha y obvia que no necesite elegir método, o cuando el prompt sea tan vago que la skill no pueda distinguir entre realidad del código y problemas de proceso. En esos casos, añade contexto primero o elige una skill más específica.

¿En qué se diferencia analyse de un prompt normal?

Un prompt normal suele dar por supuesto un solo estilo de análisis. La skill analyse primero elige el mejor método Kaizen, lo que resulta útil cuando quieres un comienzo estructurado y menos suposiciones que te lleven a callejones sin salida.

¿analyse es adecuada para principiantes?

Sí, si la persona puede describir el objetivo en lenguaje claro. Los principiantes sacan más provecho cuando aportan un área específica y una pregunta concreta, como dónde se ralentiza un flujo de trabajo o dónde el comportamiento del código difiere de la documentación.

Cómo mejorar la skill analyse

Define mejor el objetivo

La mayor mejora de calidad viene de nombrar exactamente qué estás analizando y qué modo de fallo te preocupa. Por ejemplo, “analyze the auth flow for mismatch between docs and implementation” ofrece una guía mejor que “analyze auth”.

Especifica el resultado que quieres

Dile a analyse si necesitas un recorrido por el código, un mapa de proceso o identificar desperdicios. Aunque la skill haga selección automática, un resultado claro le ayuda a elegir y explicar el método con menos ambigüedad.

Usa restricciones y ejemplos

Incluye una o dos señales reales: un paso lento, una función confusa, un traspaso repetido o una ineficiencia conocida. Esos detalles ayudan a la skill analyse a centrarse en evidencia en lugar de en una exploración demasiado amplia.

Itera después de la primera pasada

Si el primer análisis es demasiado amplio, acota el objetivo y vuelve a ejecutarlo con una pista de método más específica. Para la skill analyse, los prompts iterativos suelen rendir mejor que una sola petición sobredimensionada, porque conservan la selección del método mientras ajustan el alcance.