Validador de Calidad de Contenido

Skill: Validador de Calidad de Contenido

Descripción

Este skill permite detectar automáticamente los errores de calidad en los archivos de descripción de productos (long-*.html y short-*.html) y generar un informe de corrección detallado. El agente utilizará este informe para aplicar las correcciones mediante las herramientas de edición.

Tipos de errores detectados

🔴 Errores Críticos (Deben corregirse inmediatamente)

1. Presencia de N/A en las especificaciones

   • Detección: Buscar "N/A" en las tablas de especificaciones y textos
   • Impacto: Violación de los estándares de calidad

2. Errores gramaticales

   • "Le cette" → Debe ser "Cette"
   • "Sa cette" → Debe ser "Cette"
   • "Les la" → Debe ser "La"
   • "Ce cet" → Debe ser "Cet"
   • "Sa la" → Debe ser "La"
   • Etc. (todos los errores de doble determinante o concordancia)

3. Confusión RAM/Almacenamiento

   • "256 Go de RAM" → Debe ser "12 Go de RAM y 256 Go de almacenamiento"
   • "512 Go de RAM" → Debe ser "16 Go de RAM y 512 Go de almacenamiento"
   • etc. (todos los errores donde la cantidad de RAM se confunde con el almacenamiento)

4. Incoherencias técnicas

   • Procesador diferente entre texto y tabla
   • Especificaciones contradictorias
   • etc.

5. Presencia de hipérboles y superlativos excesivos (CRÍTICO — V3.2)

   • Detección: Uso de términos de marketing enfáticos no justificados (ej: "increíble", "revolucionario", "seducción fatal", "colosal", "sublime").
   • Regla: Prohibición absoluta. El tono debe mantenerse puramente factual, sobrio y de alta gama. Cualquier palabra prohibida provocará un FAIL de la auditoría.

🟡 Problemas de Fluidez (A mejorar)

1. Repeticiones excesivas de transiciones

   • Más de 2 usos de "Además" por sección
   • Más de 2 usos de "Luego" en el archivo
   • etc.

2. Estructuras repetitivas

   • "[Sujeto], el [Producto]..." usado más de 2 veces
   • Falta de pronombres para crear enlace
   • Falta de variación en las introducciones de secciones
   • Falta de conectores lógicos variados (Por otro lado, Además, Cabe destacar, etc.)

3. Ritmo de las frases (CRÍTICO — AIOSEO)

   • Más del 25% de las frases con más de 20 palabras (umbral bloqueante AIOSEO)
   • Más de 3 frases cortas consecutivas (menos de 10 palabras)
   • Falta de variación en la longitud de las frases

4. Tasa de transiciones (CRÍTICO — AIOSEO)

   • Menos del 30% de las frases contienen una palabra de transición
   • Las transiciones pueden estar en cualquier lugar de la frase, no solo al principio

🟠 Problemas de Tono Natural (A mejorar)

1. Nombres genéricos

   • "El 70", "El Pro", "El Pro+", "El X"
   • Debe reemplazarse por el nombre completo o pronombres

2. Fórmulas hechas y Relleno

   • "Con su diseño..."
   • "Gracias a su tecnología..."
   • "Dotado de..."
   • "La cúspide de la tecnología", "Increíble", "Revolucionario" (No se permite ninguna hipérbole genérica).
   • "El smartphone ofrece..." (si se repite)

3. Verbos poco variados

   • Repetición excesiva de "dispone de", "posee", "incorpora"

🔵 Errores SEO E-Commerce (Crítico V2.1)

1. Meta Title no descriptivo

   • Ausencia de la RAM, el Almacenamiento o el Tamaño de Pantalla en el Título.

2. Meta Description fuera de tema

   • Presencia de las palabras "SAV" o "Garantía comercial".
   • Ausencia de la mención "Entrega Abidján" (o variantes locales).

3. LSI Keywords insuficientes

   • Menos de 10 palabras clave en la lista.
   • Presencia de palabras clave informativas ("prueba", "reseña", "cómo funciona") en lugar de palabras transaccionales ("precio", "comprar").

4. Copiar-Pegar de Variantes (CRÍTICO)

   • El bloque seo de la sección Short es idéntico o casi idéntico al bloque seo de la sección Long. La IA ha hecho trampa.

Procedimiento de uso

Paso 1: Análisis del archivo objetivo

Acción: Leer el archivo largo o corto a analizar
Comando: read
Parámetro: filePath del archivo a verificar

Paso 2: Detección de errores

Para cada tipo de error, realizar las siguientes búsquedas:

2.1 Detección N/A

• Buscar: "N/A" en todo el contenido
• Anotar: Línea exacta, contexto, valor sugerido

2.2 Detección errores gramaticales

• Buscar: "Le cette", "Sa cette", "Les la", "Ce cet", "Sa la", etc.
• Anotar: Cada ocurrencia con línea exacta

2.3 Detección RAM/Almacenamiento

• Buscar: "Go de RAM" precedido de 256, 512, 1024
• Verificar: Si es realmente RAM o almacenamiento

2.4 Detección repeticiones

• Contar: Ocurrencias de conectores lógicos "Además", "Luego", "Por otro lado", etc.
• Identificar: Estructuras repetitivas "[Sujeto], el [Producto]"

2.5 Detección nombres genéricos

• Buscar: "El 70", "El Pro", "El Pro+", "El X", "El Mate", etc.
• Anotar: Líneas donde debería usarse el nombre completo

Paso 3: Generación del informe de Auditoría (PASS / FAIL)

Crear un archivo markdown con esta estructura exacta, que será devuelto al Orquestador o al Agente de producción:

# 📋 Informe de Control de Calidad - [Nombre del Producto]
**Archivo:** [ruta/hacia/archivo.json o .html]
**Estado de la Auditoría:** ❌ FAIL (o ✅ PASS si no se detectó ningún error)
**Agente:** content-quality-validator

---

## 🔴 Errores Críticos (Corrección Obligatoria)

### 1. Errores SEO E-Commerce
| Línea | Error Detectado | Regla Violada |
|-------|-----------------|--------------|
| X | Título sin la RAM | El Meta Title debe incluir todas las especificaciones técnicas |
| Y | Presencia de la palabra "SAV" | La Meta Description solo debe hablar de entrega Abidján/Calidad |
| Z | 6 palabras clave | Mínimo 10 palabras clave requeridas |
| W | SEO Idéntico | El SEO del Short es idéntico al del Long (Copiar-pegar IA detectado) |

### 2. Valores N/A
| Línea | Error | Corrección sugerida |
|-------|--------|---------------------|
| X | Procesador: N/A | [Valor correcto] |
| Y | Batería: N/A | [Valor correcto] |
o todas las demás ocurrencias de N/A

**Correcciones a aplicar:**

**Línea X - Procesador N/A:**

OLD: N/A NEW: [Valor correcto]

### 2. Errores Gramaticales
| Línea | Error | Corrección |
|-------|--------|------------|
| Y | Le cette | Cette |
| Z | Les la | La |
o todos los demás errores gramaticales detectados

**Correcciones a aplicar:**

**Línea Y - Doble determinante:**

OLD: Le cette configuración NEW: Cette configuración

**Línea Z - Doble determinante + concordancia:**

OLD: Les la gestión NEW: La gestión

### 3. Errores RAM/Almacenamiento
| Línea | Error | Corrección |
|-------|--------|------------|
| W | 256 Go de RAM | 12 Go de RAM y 256 Go de almacenamiento |

**Correcciones a aplicar:**

**Línea W - Confusión RAM/Almacenamiento:**

OLD: El smartphone ofrece 256 Go de RAM NEW: El smartphone ofrece 12 Go de RAM y 256 Go de almacenamiento

### 4. Hipérboles y Palabras Prohibidas
| Línea/Campo | Palabra Detectada | Regla Violada |
|-------------|--------------|--------------|
| short_description.teaser | revoluciona | Prohibición absoluta de recurrir al vocabulario publicitario excesivo |

**Correcciones a aplicar:**

**Campo short_description.teaser - Hipérbole:**

OLD: El espectacular Blackview DCM6 revoluciona absolutamente el tedioso trabajo nómada NEW: El Blackview DCM6 simplifica el trabajo nómada

---

## 🟡 Problemas de Fluidez

### Repeticiones excesivas
- **"Además" usado X veces** (máx recomendado: 2 por sección)
  - Línea A, B, C, D
  - **Sugerencias:** Reemplazar por "Por otro lado", "Cabe destacar", "Asimismo"

**Correcciones sugeridas:**

**Línea B:**

OLD: Además, la pantalla... NEW: Por otro lado, la pantalla...

### Estructuras repetitivas
- **Patrón "[Sujeto], el [Producto]" detectado X veces**
  - Líneas: E, F, G

**Correcciones sugeridas:**

**Línea E:**

OLD: El rendimiento, el Huawei Nova 13 se beneficia... NEW: En cuanto al rendimiento, se beneficia...

---

## 🟠 Problemas de Tono Natural

### Nombres genéricos a reemplazar
| Línea | Genérico | Corrección |
|-------|-----------|------------|
| H | El 70 | El Huawei Pura 70 |
| I | El Pro | Este modelo |

**Correcciones a aplicar:**

**Línea H:**

OLD: El 70 adopta... NEW: El Pura 70 adopta...

---

## ✅ Lista de verificación de corrección

- [ ] Todos los N/A corregidos
- [ ] Todos los errores gramaticales corregidos
- [ ] Errores RAM/Almacenamiento corregidos
- [ ] Repeticiones de transiciones variadas
- [ ] Nombres genéricos reemplazados
- [ ] Estructura fluida verificada
- [ ] Tono natural mejorado
- [ ] Información técnica coherente
- [ ] Ninguna hipérbole/palabra prohibida presente en los textos

---

## 📊 Estadísticas

- **Errores críticos:** X
- **Problemas de fluidez:** Y
- **Problemas de tono:** Z
- **Total errores detectados:** X+Y+Z
- **Total correcciones:** X+Y+Z

Paso 4: Aplicación de las correcciones

El agente debe:

1. Leer el informe de corrección generado
2. Para cada corrección listada:
   • Localizar el oldString exacto en el archivo fuente
   • Usar edit con oldString/newString
   • Verificar que la corrección se aplicó
3. Continuar hasta agotar las correcciones

Ejemplo completo de uso

Escenario: Corrección del archivo largo de un producto

Paso 1: Análisis

Usuario: "Verifica la calidad del archivo products/huawei-nova-all/nova-13/long-nova-13.html"

Paso 2: Detección

Acción: read filePath="products/huawei-nova-all/nova-13/long-nova-13.html"
Resultado: Detección de:
- 1 N/A (Procesador)
- 0 errores gramaticales
- 4 repeticiones de "Además"
- 4 estructuras "[Sujeto], el [Producto]"

Paso 3: Generación del informe

Acción: write filePath="Docs/informe-correccion-nova-13.md"
Contenido: Informe estructurado con oldString/newString

Paso 4: Corrección

Para cada entrada del informe:
  Acción: edit filePath="..." oldString="..." newString="..."

Buenas prácticas

1. Siempre leer el archivo completo antes de generar el informe
2. Anotar los números de línea exactos para facilitar la corrección
3. Proporcionar el contexto (líneas antes/después) para cada oldString
4. Priorizar los errores críticos antes que los problemas de fluidez
5. Verificar la coherencia entre texto y tabla de especificaciones

Limitaciones conocidas

• Este skill no detecta errores de maquetación HTML
• Los errores de estilo (inline styles) no se verifican aquí, pero pueden ser detectados por otro skill de formateo o mediante los scripts de validación validate_html_template.py; validate_product_pack.ps1
• La detección del tono natural es indicativa y requiere una revisión humana
• Las sugerencias de reemplazo para las transiciones son recomendaciones, no obligaciones

Recursos

• Informe de ejemplo: Ver Docs/informe_auditoria_huawei_long_files.md para un ejemplo de detección completa
• Skill de formateo: Referirse a PRODUCT_FORMATTING_SKILL.md para los estándares de referencia