Communitygithub.com

Flujo de Trabajo Web Multiagente

Habilidad ligera para Codex que define un flujo de trabajo secuencial multiagente para tareas de generación web, con roles especializados y criterios de aceptación explícitos.

¿Qué es Flujo de Trabajo Web Multiagente?

Esta habilidad para Codex y otros asistentes de IA (como Claude Code o Cursor) implementa un flujo de trabajo multiagente secuencial para tareas de desarrollo web. Está diseñada para ser liviana en herramientas, sin requerir scripts especiales, y se basa en un método operativo basado en identidad de agentes, contratos de etapa y revisión estructurada. El flujo predeterminado es: Planificador -> Arquitecto -> Desarrollador -> Revisor -> AutoCorrector (opcional) -> Revisor (opcional) -> Final. Cada etapa tiene una responsabilidad estrecha y produce artefactos en formato JSON que definen expectativas claras. La habilidad es útil para garantizar calidad, trazabilidad y consistencia en proyectos web, especialmente cuando se trabaja con asistentes de IA que necesitan directrices precisas para evitar ambigüedades. Soporta tareas que van desde la planificación hasta la implementación y revisión, con un enfoque en la corrección automatizada de errores y la validación contra criterios de aceptación definidos por el Arquitecto.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add AncientM00N/Skills_for_NLP_huliang6

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Flujo de Trabajo Web Multiagente?

Propósito

Usa esta habilidad para ejecutar un flujo de trabajo multiagente secuencial para tareas de generación web. Trata cada etapa como un rol distinto con una responsabilidad estrecha, un artefacto de traspaso claro y criterios de aceptación explícitos.

Esta habilidad es intencionalmente ligera en herramientas. No requiere scripts especiales; proporciona un método operativo para la identidad del agente, contratos de etapa, revisión y reparación.

Flujo de Trabajo

Usa esta secuencia predeterminada para tareas web sustanciales:

Planificador -> Arquitecto -> Desarrollador -> Revisor -> AutoCorrector (opcional) -> Revisor (opcional) -> Final

Omite etapas solo cuando la tarea es lo suficientemente pequeña como para que el usuario desee claramente una respuesta directa.

Planificador

Clasifica la solicitud antes de actuar:

  • chat: Explicar, discutir, comparar o responder sin editar.
  • inspect: Leer o analizar archivos existentes, vistas previas o el estado del proyecto.
  • code: Crear, editar, corregir o construir una página web o proyecto frontend.

Prefiere chat para conversaciones ambiguas. Entra en code solo cuando el usuario solicita implementación, cambios visibles en la UI, correcciones de errores o generación.

Arquitecto

Usa la etapa de Arquitecto antes de la implementación cuando la tarea tiene más de un elemento de UI, interacción, sección de página o restricción de calidad.

Produce un plan compacto:

{
  "type": "architect_plan",
  "goal": "Lo que la página o cambio debe lograr",
  "page_structure": ["Secciones o componentes visibles principales"],
  "visual_direction": "Dirección de estilo vinculada al dominio",
  "interaction_notes": ["Interacciones de usuario esperadas"],
  "files": [
    {"path": "index.html", "purpose": "Página de entrada", "required": true}
  ],
  "acceptance_criteria": ["Verificaciones observables para el éxito"],
  "risks": ["Riesgos probables de implementación o UX"]
}

No escribas archivos en esta etapa. No escondas requisitos vagos; define una suposición conservadora o haz una pregunta enfocada.

Desarrollador

Implementa el plan del Arquitecto. Mantén los cambios limitados a la página o componente solicitado.

Sigue este orden:

  1. Lee los archivos existentes relevantes antes de editar.
  2. Crea o edita archivos usando el cambio práctico más pequeño.
  3. Construye o previsualiza cuando el entorno lo soporte.
  4. Resume qué cambió y qué se verificó.

Finaliza la etapa con:

{
  "type": "implementation_summary",
  "changed_files": ["ruta/relativa"],
  "created_files": [],
  "deleted_files": [],
  "checks": [
    {"name": "build_or_preview", "passed": true, "note": "Resultado"}
  ],
  "summary": "Resultado conciso de la implementación"
}

Revisor

Revisa como un rol separado. No reescribas la implementación durante la revisión.

Verifica:

  • Cobertura de la solicitud del usuario.
  • Criterios de aceptación del Arquitecto.
  • Claridad de la UI, diseño responsivo y completitud de la interacción.
  • Estados rotos obvios, activos faltantes, errores de ejecución o fallos de compilación.
  • Si la implementación se excede o cambia archivos no relacionados.

Genera un informe estructurado:

{
  "type": "review_report",
  "passed": true,
  "severity": "pass",
  "summary": "Resultado de la revisión",
  "issues": [
    {
      "id": "R1",
      "severity": "minor|major|blocker",
      "area": "ux|functionality|build|scope|content",
      "file": "ruta/relativa",
      "message": "Problema específico",
      "suggested_fix": "Reparación accionable"
    }
  ],
  "acceptance_checklist": [
    {"item": "Criterio", "passed": true, "note": "Evidencia"}
  ]
}

Usa blocker para fallo de compilación, interacción principal inutilizable, salida primaria faltante o comportamiento inseguro. Usa major para funcionalidad requerida faltante. Usa minor para problemas de pulido.

AutoCorrector

Usa AutoCorrector solo cuando el Revisor reporte problemas.

Reglas:

  • Corrige solo los problemas listados en la revisión.
  • Prefiere parches locales sobre reescrituras amplias.
  • Preserva el diseño original a menos que el problema requiera un ajuste de diseño.
  • Vuelve a verificar después de corregir cuando sea posible.
  • Regresa al Revisor después de la corrección.

Finaliza con:

{
  "type": "fix_summary",
  "fixed_issue_ids": ["R1"],
  "changed_files": ["ruta/relativa"],
  "checks": [
    {"name": "build_or_preview", "passed": true, "note": "Resultado"}
  ],
  "summary": "Qué se corrigió"
}

Respuesta Final

Entrega al usuario solo el resultado de mayor señal:

  • Qué se construyó o cambió.
  • Qué pasó la revisión.
  • Riesgos restantes o verificaciones omitidas.
  • Dónde ver o inspeccionar el resultado, si está disponible.

No expongas la cadena de pensamiento interna. Menciona los resultados de las etapas o hallazgos de la revisión solo cuando ayuden materialmente al usuario a confiar en el resultado.

Skills relacionados