analyse-problem

Resumen de analyse-problem

Para qué sirve analyse-problem

La skill analyse-problem convierte un problema desordenado en un brief A3 estructurado: contexto, estado actual, estado objetivo, análisis de causa raíz, contramedidas, plan de implementación y seguimiento. Es especialmente útil para Strategic Planning, operaciones, producto e ingeniería cuando necesitas una declaración del problema lista para tomar decisiones, en lugar de una lluvia de ideas.

Quién debería instalarla

Instala analyse-problem si con frecuencia necesitas explicar un problema con claridad, alinear a las partes interesadas o pasar de los síntomas a las causas. Encaja con personas que quieren un formato repetible para revisión de incidentes, mejora de procesos, bloqueos de proyectos o sesiones de planificación.

Qué la hace diferente

El valor no es “más redacción de IA”; es la restricción. analyse-problem empuja al modelo a documentar el problema en una sola página, separar los hechos de las suposiciones y cerrar con acciones y verificación. Eso la hace más útil que un prompt genérico para analyse-problem en Strategic Planning, porque obliga a un marco de decisión más ajustado.

Cómo usar la skill analyse-problem

Instálala y actívala

Usa el flujo de instalación de tu gestor de skills y luego invoca la skill analyse-problem con una breve descripción del problema. El patrón de uso del repositorio es /analyse-problem [problem_description], y la skill admite una descripción opcional del problema y salida en markdown por defecto. Si tu entorno asigna las skills de otra manera, pasa la misma intención: una declaración breve y concreta del problema.

Dale a la skill la entrada correcta

Las entradas sólidas nombran el problema, el alcance y la evidencia. Por ejemplo: “La finalización del onboarding de clientes cayó un 18% este mes en cuentas enterprise; analiza las causas y propone contramedidas.” Entradas débiles como “mejorar el onboarding” dejan al modelo adivinando el objetivo, el responsable y la métrica de éxito. Para usar analyse-problem, incluye:

• el síntoma
• el proceso o equipo afectado
• cualquier dato, ejemplo o cronología
• el resultado deseado o la restricción

Revisa primero estas partes del repositorio

Empieza con SKILL.md y luego revisa cualquier instrucción enlazada en README.md, AGENTS.md, metadata.json y carpetas como rules/, resources/, references/ o scripts/ si existen. En este repo, la fuente principal está concentrada en plugins/kaizen/skills/analyse-problem, así que hay poca estructura adicional que perseguir.

Ajusta el prompt para obtener mejores resultados

Un buen prompt para analyse-problem es lo bastante específico como para completar cada sección del A3. Por ejemplo:
“Usa analyse-problem para documentar por qué aumentaron los retrasos de lanzamiento en Q2. Incluye métricas base, causas raíz probables, 3 contramedidas ordenadas por impacto y esfuerzo, y un plan de seguimiento a 30 días.”
Eso produce un resultado más útil que pedir un análisis genérico, porque le da al modelo hechos que organizar y una decisión que respaldar.

Preguntas frecuentes sobre la skill analyse-problem

¿analyse-problem es solo para Strategic Planning?

No. Es útil en cualquier contexto en el que un problema deba definirse, investigarse y convertirse en acciones: incidencias de producto, cuellos de botella operativos, fallos de proceso del equipo o revisiones de planificación estratégica. El formato A3 es amplio, pero la skill aporta más valor cuando el resultado se va a compartir con otras personas.

¿En qué se diferencia de un prompt normal?

Un prompt normal puede pedir un análisis, pero la skill analyse-problem ofrece una estructura reutilizable y disciplina de salida. Eso importa cuando necesitas una cobertura consistente de causa raíz, contramedidas y seguimiento, en lugar de una explicación libre.

¿Puede usarla bien una persona principiante?

Sí, si la entrada es concreta. A las personas principiantes normalmente les cuesta cuando el problema es vago, así que conviene aportar lo que se sabe: síntoma observado, alcance, momento y un objetivo aproximado. La skill puede ayudar a organizar un razonamiento incompleto, pero no puede inventar hechos que faltan de forma segura.

¿Cuándo no debería usarla?

No uses analyse-problem cuando solo necesites un resumen rápido, una actualización de estado o una sesión creativa de ideación. Tampoco encaja bien si el problema todavía no tiene un alcance estable; en ese caso, define primero el problema antes de pedir un análisis estructurado.

Cómo mejorar la skill analyse-problem

Aporte evidencia, no solo conclusiones

La mayor mejora de calidad viene de entradas concretas: métricas, ejemplos, marcas de tiempo de incidentes, citas de usuarios o notas de proceso. Si ya sospechas una causa raíz, etiquétala como hipótesis y no como hecho, para que el análisis pueda ponerla a prueba en vez de repetirla.

Pida una salida útil para la decisión

Para analyse-problem, pide lo que ayude a actuar a un equipo: causas priorizadas, contramedidas vinculadas a cada causa, responsables, dependencias y un plan de verificación. Si buscas valor para Strategic Planning, solicita tradeoffs de impacto y esfuerzo en lugar de una narración larga.

Vigile los fallos más comunes

El fallo habitual es explicar demasiado los síntomas y especificar poco el estado objetivo. Otro es mezclar varios problemas en una sola página. Separa los temas no relacionados y mantén un análisis centrado en una sola decisión, un solo responsable y un solo resultado medible.

Itere después del primer borrador

Use el primer resultado para detectar huecos: datos que faltan, vínculos causales débiles o acciones que no encajan con la causa raíz. Luego refine el prompt con nuevos hechos y restricciones, como presupuesto, plazo, capacidad del equipo o un formato obligatorio para la revisión por liderazgo.