AgentSkillsCN

modo-produccion

对一款应用或着陆页进行全方位审查,识别常见问题,提出优化建议,并借助固定清单逐一落实修正措施,使应用或着陆页在正式上线或对外展示之前做好充分准备。

SKILL.md
--- frontmatter
name: modo-produccion
description: Revisa una app/landing, detecta problemas típicos, propone mejoras y aplica correcciones con un checklist fijo para dejarlo listo para enseñar o publicar.

Modo Producción (QA + Fix)

Skill especializado en revisión de calidad y corrección rápida de apps/landings antes de presentar, grabar o publicar. Aplica un checklist fijo y ejecuta correcciones mínimas de alto impacto.

Cuándo usar este skill

  • Cuando ya tenés algo generado (landing/app) y querés dejarlo "presentable"
  • Cuando algo funciona "a medias" (móvil raro, imágenes rotas, botones sin acción, espaciados feos)
  • Antes de enseñarlo a un cliente, grabarlo o publicarlo
  • Cuando el usuario diga "revisá esto antes de publicar" o "dejalo listo para producción"
  • Después de terminar desarrollo y antes de deploy

Inputs necesarios

Regla: Si falta alguno de estos inputs, PREGUNTAR antes de revisar.

InputDescripciónObligatorio
Archivo principalRuta del archivo (ej: index.html, src/App.tsx)✅ Sí
Objetivo de revisión"Lista para enseñar" o "Lista para publicar"✅ Sí
RestriccionesNo cambiar branding / copy / estructura / etc.✅ Sí

Diferencia entre objetivos

ObjetivoNivel de exigenciaFoco
Lista para enseñarFuncional + presentableQue no haya errores visibles en demo
Lista para publicarProducción completaSEO, accesibilidad, performance, mobile

Checklist de Calidad (orden fijo)

A) Funciona y se ve ✅

#VerificaciónCrítico
A1Abre la preview / localhost sin errores en consola🔴 Sí
A2Imágenes cargan y no hay rutas rotas🔴 Sí
A3Tipografías y estilos se aplican correctamente🔴 Sí
A4Links y botones funcionan (no hay 404)🔴 Sí
A5No hay errores de JavaScript en consola🔴 Sí

B) Responsive (móvil primero) 📱

#VerificaciónCrítico
B1Se ve bien en móvil (no se corta contenido)🔴 Sí
B2No hay scroll horizontal🔴 Sí
B3Botones y textos tienen tamaños legibles (min 16px)🟡 Media
B4Secciones con espaciado coherente🟡 Media
B5Imágenes escalan correctamente🟡 Media

C) Copy y UX básica ✍️

#VerificaciónCrítico
C1Titular claro y coherente con la propuesta🟡 Media
C2CTAs consistentes (mismo verbo, misma intención)🟡 Media
C3No hay texto "placeholder" tipo lorem ipsum🔴 Sí
C4Información de contacto correcta🔴 Sí
C5Sin typos evidentes🟡 Media

D) Accesibilidad mínima ♿

#VerificaciónCrítico
D1Contraste razonable en textos (4.5:1 mínimo)🟡 Media
D2Imágenes con atributo alt🟡 Media
D3Estructura de headings (h1, h2, h3) lógica🟡 Media
D4Formularios con labels asociados🟡 Media

E) SEO básico (solo para "publicar") 🔍

#VerificaciónCrítico
E1Title tag presente y descriptivo🔴 Sí
E2Meta description presente🟡 Media
E3Un solo h1 por página🟡 Media
E4URLs amigables (sin caracteres raros)🟡 Media

Workflow

Paso 1: Diagnóstico rápido

  1. Abrir el proyecto/archivo
  2. Ejecutar checklist completo
  3. Generar lista de 5–10 problemas priorizados por criticidad (🔴 primero)

Paso 2: Plan de arreglos

  1. Listar máximo 8 cambios con formato:
    • Qué: descripción del cambio
    • Por qué: problema que resuelve
    • Dónde: archivo y línea aproximada

Paso 3: Aplicar cambios

  1. Modificar archivos necesarios
  2. Aplicar correcciones de menor a mayor impacto
  3. Mantener cambios mínimos (no refactorizar todo)

Paso 4: Validación

  1. Volver a abrir preview
  2. Verificar checklist de nuevo
  3. Confirmar que no se rompió nada

Paso 5: Resumen final

  1. Listar cambios hechos
  2. Indicar qué queda opcional para mejorar después

Instrucciones

Reglas obligatorias

ReglaRazón
No cambiar estilo de marca si existe skill de marca activoConsistencia
No rehacer todo: corregir lo mínimoVelocidad + bajo riesgo
Si hay conflicto "bonito" vs "claro" → priorizar claridadUX > estética
Máximo 8 cambios por pasadaEvitar romper cosas
Siempre validar después de cambiosDetectar regresiones

Prioridad de correcciones

code
1. 🔴 Errores críticos (app no funciona, errores JS, 404)
2. 🔴 Problemas de mobile (scroll horizontal, contenido cortado)
3. 🟡 UX/Copy (placeholders, typos, CTAs inconsistentes)
4. 🟡 Accesibilidad (contraste, alts, headings)
5. 🟢 Mejoras opcionales (optimizaciones, pulido visual)

Manejo de errores

  • Si hay demasiados problemas (>15) → priorizar solo 🔴 críticos primero
  • Si un cambio rompe otra cosa → revertir y buscar alternativa
  • Si las restricciones impiden arreglar algo crítico → notificar al usuario

Output (formato exacto)

markdown
## 🔍 Diagnóstico

### Problemas encontrados (priorizados)

| #   | Problema      | Categoría | Criticidad | Archivo         |
| --- | ------------- | --------- | ---------- | --------------- |
| 1   | [Descripción] | A/B/C/D/E | 🔴/🟡/🟢   | [archivo:línea] |
| 2   | [Descripción] | A/B/C/D/E | 🔴/🟡/🟢   | [archivo:línea] |
| ... | ...           | ...       | ...        | ...             |

**Total**: X problemas (Y críticos, Z medios)

---

## 🔧 Plan de Arreglos

| #   | Qué cambio | Por qué                 | Dónde           |
| --- | ---------- | ----------------------- | --------------- |
| 1   | [Cambio]   | [Problema que resuelve] | [archivo:línea] |
| 2   | [Cambio]   | [Problema que resuelve] | [archivo:línea] |
| ... | ...        | ...                     | ...             |

---

## ✅ Cambios Aplicados

1. ✅ [Cambio 1] - [archivo]
2. ✅ [Cambio 2] - [archivo]
3. ✅ [Cambio 3] - [archivo]
   ...

---

## 📊 Resultado

### Estado: ✅ OK para [enseñar/publicar] | ⚠️ Requiere más trabajo

### Checklist post-fix

| Categoría           | Estado   |
| ------------------- | -------- |
| A) Funciona y se ve | ✅/⚠️/❌ |
| B) Responsive       | ✅/⚠️/❌ |
| C) Copy y UX        | ✅/⚠️/❌ |
| D) Accesibilidad    | ✅/⚠️/❌ |
| E) SEO (si aplica)  | ✅/⚠️/❌ |

### Mejoras opcionales (para después)

- [ ] [Mejora 1]
- [ ] [Mejora 2]
- [ ] [Mejora 3]

---

## 📝 Notas

[Observaciones adicionales, advertencias o recomendaciones]