AgentSkillsCN

gestionar-estado-graficador

管理专家绘图师工作流的持久化状态。支持进度追踪、中断恢复以及全流程可追溯性，同时保持 workflow_state.json 的实时更新。

SKILL.md
--- frontmatter
name: gestionar-estado-graficador
description: >
  Gestiona el estado persistente del workflow Graficador Experto.
  Permite tracking de progreso, recuperacion ante interrupciones y trazabilidad.
  Mantiene workflow_state.json actualizado.
license: Proyecto Educativo - IE Pedacito de Cielo
compatibility: Requiere workflow Graficador Experto activo. Linux/macOS.
metadata:
  author: alvaretto
  version: "2.1"
  language: es
allowed-tools:
  - Read
  - Write
  - Bash(ls:*)

Gestion de Estado del Workflow

Decision Tree

code
Operacion solicitada?
    |
    +-> Inicializar: Crear workflow_state.json vacio
    |
    +-> Iniciar lenguaje: Cambiar estado a "en_iteracion"
    |
    +-> Registrar iteracion: Incrementar contador
    |
    +-> Registrar similitud: Actualizar valor y historico
    |
    +-> Validar lenguaje: Cambiar estado a "validado"
    |
    +-> Consultar estado: Mostrar resumen de progreso

Proceso paso a paso

PASO 1: Inicializar estado

Al iniciar un nuevo workflow:

  1. •Crear outputs/workflow_state.json
  2. •Establecer timestamp_inicio
  3. •Establecer fase_actual como "analisis"
  4. •Inicializar lenguajes con estado "pendiente"

PASO 2: Gestionar transiciones

Al cambiar de fase:

  1. •Leer estado actual
  2. •Validar que transicion sea permitida
  3. •Actualizar fase_actual y estado del lenguaje
  4. •Guardar cambios

PASO 3: Registrar progreso

Durante iteraciones:

  1. •Incrementar iteracion_actual
  2. •Registrar similitud en similitud_historico
  3. •Actualizar timestamp_ultima_actualizacion

PASO 4: Consultar estado

Para mostrar progreso:

  1. •Leer workflow_state.json
  2. •Calcular tiempo transcurrido
  3. •Determinar indicadores por lenguaje
  4. •Sugerir proximos pasos

Estados y transiciones

code
analisis -> tikz_iteracion -> tikz_validado
                                    |
                                    v
         python_iteracion <- python_validado
                                    |
                                    v
              r_iteracion <- r_validado -> completado

Indicadores de estado

IndicadorEstadoSignificado
VALIDADOvalidadoAprobado (>=95% o manual)
EN ITERACIONen_iteracionActivo
PENDIENTEpendienteNo iniciado

Reglas de validacion

  • •TikZ: Puede iniciarse despues de analisis
  • •Python: Requiere TikZ validado o al menos iniciado
  • •R: Requiere Python validado o al menos iniciado
  • •Validacion: Solo si similitud >= 95 o aprobacion manual

Recuperacion ante errores

Si el workflow se interrumpe:

  1. •Leer estado persistente
  2. •Identificar ultima fase completada
  3. •Sugerir continuar desde donde quedo
  4. •Validar que archivos necesarios existan

Referencias

Integracion con otros skills

code
analizar-icfes
    |
    +-> gestionar-estado-graficador <- ESTE SKILL
            |
            +-> (inicializa estado)
            |
generar-codigo-* -> gestionar-estado-graficador
            |
            +-> (registra iteraciones, similitudes)
            |
comparar-similitud-visual -> gestionar-estado-graficador
            |
            +-> (registra similitud)
            |
/estado -> gestionar-estado-graficador
            |
            +-> (consulta y muestra progreso)