AgentSkillsCN

diagnosticar-errores

执行验证周期的第3阶段——诊断错误、按类别归类,并启动子阶段3A(示例修正)与子阶段3B(第1阶段复核)。当第1阶段或第2阶段检测到错误,或编译失败时,此技能将自动运行,持续循环直至彻底解决所有问题。

SKILL.md
--- frontmatter
name: diagnosticar-errores
description: >
  Ejecuta FASE 3 del Ciclo de Validacion - Diagnostica errores, clasifica por categoria,
  activa SUBFASE 3A (correccion ejemplos), SUBFASE 3B (revalidacion FASE 1).
  Usa automaticamente cuando FASE 1 o FASE 2 detectan errores, o cuando compilacion falla.
  Loop hasta resolver TODOS los errores.
license: Proyecto Educativo - IE Pedacito de Cielo
compatibility: Requiere R (>= 4.0), paquete exams. Linux/macOS.
metadata:
  author: alvaretto
  version: "2.1"
  language: es
allowed-tools:
  - Read
  - Write
  - Edit
  - Grep
  - Glob
  - Bash(Rscript:*)
  - Bash(grep:*)

Diagnosticador de Errores R/exams - FASE 3

Decision Tree

code
Error reportado
    |
    +-> Contiene "File.*png.*not found"?
    |    +-> SI: ERR_G1 (Graficas no visualizadas)
    |
    +-> Contiene "LaTeX Error" o "! Undefined"?
    |    +-> SI: ERR_T1 (LaTeX no compila)
    |
    +-> Contiene "object.*not found"?
    |    +-> SI: ERR_C3 (Variable R no definida)
    |
    +-> Contiene "non-numeric argument"?
    |    +-> SI: ERR_C3 (Operacion con string)
    |
    +-> Contiene "cloze.*not supported"?
    |    +-> SI: ERR_S5 (CLOZE incompatible NOPS - esperado)
    |
    +-> NO coincide: Analizar archivo .Rmd
         +-> Falta exname? -> ERR_T3
         +-> Answerlist < 4? -> ERR_S1
         +-> Gaps no secuenciales? -> ERR_S4

Contexto: Ciclo de Validacion

code
FASE 1: validar-renderizado
    |
FASE 2: validar-coherencia
    |
FASE 3: diagnosticar-errores <- ESTE SKILL
    |
    +-> Sin errores -> promover-ejercicio
    |
    +-> Con errores:
            +-> SUBFASE 3A: Correccion basada en ejemplos
            +-> SUBFASE 3B: Revalidacion (volver FASE 1)
            +-> SUBFASE 3C: Documentar solucion (si exito)

Proceso paso a paso

PASO 1: Recibir errores

Input de FASE 1 y/o FASE 2:

  • Lista de errores por formato (HTML, PDF, DOCX, NOPS)
  • Incoherencias detectadas
  • Mensajes de error completos

PASO 2: Clasificar errores

Run scripts/diagnosticar-error.R --help first, then:

bash
Rscript .claude/skills/diagnosticar-errores/scripts/diagnosticar-error.R archivo.Rmd "mensaje_error"

Ver categorias de errores para lista completa.

PASO 3: Priorizar

Orden de prioridad:

  1. CRITICA (bloquea todo)
  2. ALTA (bloquea formatos principales)
  3. MEDIA (afecta calidad)
  4. BAJA (opcional/esperado)

PASO 4: SUBFASE 3A - Correccion basada en ejemplos

OBLIGATORIO consultar ejemplos funcionales ANTES de corregir:

bash
ls /A-Produccion/Ejemplos-Funcionales-Rmd/*.Rmd
grep -l "[patron_similar]" /A-Produccion/Ejemplos-Funcionales-Rmd/*.Rmd

Copiar patron exacto del ejemplo funcional. NO improvisar.

Ver patrones comunes para soluciones verificadas.

PASO 5: SUBFASE 3B - Revalidacion OBLIGATORIA

SIEMPRE volver a FASE 1 despues de aplicar correcciones:

bash
Rscript .claude/skills/generar-schoice/scripts/validar-renderizado.R ejercicio.Rmd

Si errores persisten -> volver a SUBFASE 3A con solucion alternativa.

PASO 6: SUBFASE 3C - Documentar (solo si exito)

Solo despues de revalidacion 100% exitosa. Agregar a .claude/docs/patrones-errores-conocidos.md

Condiciones criticas

Pre-diagnostico

  • Recibir lista completa de errores de FASE 1/FASE 2
  • Tener archivo .Rmd accesible
  • Acceso a /A-Produccion/Ejemplos-Funcionales-Rmd/

Durante diagnostico

  • Clasificar TODOS los errores
  • Priorizar por nivel critico
  • SIEMPRE consultar ejemplos funcionales ANTES de corregir
  • Aplicar soluciones basadas en ejemplos, NO improvisar

Post-correccion

  • SIEMPRE ejecutar SUBFASE 3B (revalidacion)
  • NUNCA marcar "completado" si quedan errores
  • Si errores persisten -> volver a SUBFASE 3A
  • Solo si exito 100% -> SUBFASE 3C (documentar)

Regla Absoluta: LOOP hasta exito total.

Referencias

  • Categorias de errores - ERR_G, ERR_T, ERR_S, ERR_C
  • Patrones comunes - Soluciones verificadas
  • Ciclo Validacion: .claude/rules/ciclo-validacion.md
  • Patrones Errores: .claude/docs/patrones-errores-conocidos.md
  • Ejemplos Funcionales: /A-Produccion/Ejemplos-Funcionales-Rmd/

Integracion con otros skills

code
validar-renderizado (FASE 1)
    |
validar-coherencia (FASE 2)
    |
diagnosticar-errores (FASE 3) <- ESTE SKILL
    |
    +-> corregir-graficos (si ERR_G*)
    +-> manual-edit (otros errores)
    +-> promover-ejercicio (si exito)