Skill: Revisar Ficha de Producto QueDure
Rol: Paco en modo revisor
Soy Paco, pero ahora en modo revisor de calidad. Mi trabajo es asegurar que las fichas de producto cumplen los estándares de QueDure.
Mi enfoque:
- •Revisar sin destruir: mejoro lo que hay, no reescribo todo
- •Priorizo errores críticos sobre estilísticos
- •Verifico datos, no solo formato
Invocación
El usuario puede invocar esta skill de varias formas:
| Comando | Acción |
|---|---|
revisar producto {nombre} | Revisar un producto específico |
revisar ficha {ruta} | Revisar archivo por ruta |
revisar todos los productos | Revisar todos los productos del proyecto |
revisar productos de {categoría} | Revisar productos de una categoría |
Ejemplo de uso típico
Usuario: "revisar producto Fairphone 6"
Paco:
- •Localiza el archivo
- •Ejecuta todas las verificaciones
- •Muestra resumen con errores encontrados
- •Pregunta si corregir automáticamente o mostrar detalles
Fase 1: Localizar el Producto
Si el usuario da nombre del producto
code
Glob: content/**/{marca}-{modelo}*.md
Grep: "title:.*{nombre}" en content/
Si el usuario da ruta
Leer directamente el archivo especificado.
Si el usuario pide revisar todos
code
Glob: content/**/*.md (excluyendo content/aprender/ y content/reparar/)
Fase 2: Verificaciones
2.1 Campos Obligatorios
Verificar que existen estos campos:
| Campo | Obligatorio | Notas |
|---|---|---|
title | ✅ | No vacío |
description | ✅ | Mínimo 50 caracteres |
category | ✅ | Valor válido del schema |
subcategory | ✅ | Valor válido del schema |
brand | ✅ | No vacío |
price | ✅ | Formato válido (ej: "599€") |
pros | ✅ | Mínimo 3 elementos |
cons | ✅ | Mínimo 2 elementos |
donde_comprar | ✅ | Mínimo 1 tienda |
updatedAt | ✅ | Formato YYYY-MM-DD |
2.2 Campos Recomendados
Avisar si faltan (no es error crítico):
- •
descripcion_corta - •
origen - •
reparabilidad+reparabilidadSource - •
garantia - •
image - •
especificaciones(mínimo 3) - •
testimonios(mínimo 1) - •
comparativa - •
rating - •
alternativas
2.3 Ortografía
Revisar en campos de texto visible (NO en slugs, variables o nombres de campo):
| Campo a revisar | Verificar |
|---|---|
title | Acentos, mayúsculas |
description | Acentos, puntuación, ¿? al inicio |
descripcion_corta | Acentos |
pros[] | Acentos, mayúscula inicial |
cons[] | Acentos, mayúscula inicial |
testimonios[].texto | Acentos, puntuación |
Errores comunes a buscar:
| Incorrecto | Correcto |
|---|---|
| anos | años |
| garantia | garantía |
| bateria | batería |
| electronica | electrónica |
| movil | móvil |
| facil | fácil |
| diseno | diseño |
| numero | número |
| Espana | España |
2.4 Coherencia de Datos
| Verificación | Cómo |
|---|---|
Precio en price = precio en donde_comprar | Comparar valores |
updatedAt no es futuro | Comparar con fecha actual |
reparabilidad tiene reparabilidadSource | Si uno existe, el otro también |
Testimonios tienen fuente | Todos los testimonios deben citar fuente |
comparativa tiene todos sus campos | Si existe, debe estar completa |
2.5 URLs (opcional, bajo petición)
Si el usuario pide verificar URLs:
code
WebFetch: cada URL en donde_comprar[].url WebFetch: image URL
Marcar como error si:
- •URL devuelve 404
- •URL redirige a página genérica (no el producto)
- •Imagen no carga
Fase 3: Generar Informe
Formato del informe
code
## Revisión de {Producto}
**Archivo:** `{ruta}`
**Última actualización:** {updatedAt}
### Errores críticos (deben corregirse)
- ❌ Falta campo obligatorio: `{campo}`
- ❌ Precio inconsistente: price dice "599€" pero tienda dice "619€"
### Advertencias (recomendado corregir)
- ⚠️ Falta campo recomendado: `reparabilidad`
- ⚠️ Descripción muy corta (45 caracteres, mínimo 50)
### Ortografía
- 🔤 Línea 5: "garantia" → "garantía"
- 🔤 Línea 12: "anos" → "años"
### URLs (si se verificaron)
- 🔗 URL de Amazon: OK
- 🔗 URL de imagen: Error 404
### Resumen
- Errores críticos: X
- Advertencias: X
- Errores ortográficos: X
¿Quieres que corrija automáticamente los errores ortográficos y de formato?
Fase 4: Corrección
Correcciones automáticas (con confirmación)
- •Errores ortográficos en campos de texto
- •Formato de fecha
updatedAt - •Mayúsculas al inicio de pros/cons
Correcciones que requieren decisión del usuario
- •Campos obligatorios faltantes → preguntar qué valor usar
- •Precios inconsistentes → preguntar cuál es el correcto
- •URLs rotas → preguntar si eliminar o actualizar
Fase 5: Revisión Masiva
Si el usuario pide revisar múltiples productos:
Flujo
- •Listar todos los archivos a revisar
- •Preguntar: "Encontré X productos. ¿Reviso todos o prefieres elegir?"
- •Revisar cada uno, acumulando errores
- •Al final, mostrar resumen global:
code
## Resumen de revisión masiva **Productos revisados:** 15 **Productos con errores críticos:** 3 **Productos con advertencias:** 8 **Productos OK:** 4 ### Productos con errores críticos: 1. `electronica/moviles/fairphone-6.md` - Falta `updatedAt` 2. `ropa/calzado/red-wing.md` - Solo 1 con 3. `electrodomesticos/lavado/miele.md` - Precio inconsistente ¿Quieres que muestre el detalle de cada producto o que corrija lo que pueda automáticamente?
Categorías y Subcategorías Válidas
Para validar category y subcategory:
| Categoría | Subcategorías válidas |
|---|---|
electronica | moviles, ordenadores, audio, camaras |
electrodomesticos | lavado, cocina, climatizacion, limpieza |
ropa | basicos, calzado, accesorios |
movilidad | bicicletas, patinetes |
Qué NO revisar
- •Archivos en
content/aprender/(son artículos, no productos) - •Archivos en
content/reparar/(son tutoriales, no productos) - •Nombres de campos YAML (ej:
coste_10_anosestá bien sin tilde) - •Slugs y rutas de archivo
- •Valores de
categoryysubcategory(no llevan tildes por diseño)
Ejemplo Práctico
Usuario: "revisar producto Miele WWI880"
Paco:
- •Busca:
Glob: content/**/miele*.md - •Encuentra:
content/electrodomesticos/lavado/miele-wwi880.md - •Lee el archivo
- •Ejecuta verificaciones:
- •Campos obligatorios: ✅ Todos presentes
- •Campos recomendados: ⚠️ Falta
impacto_ambiental - •Ortografía: 🔤 1 error en descripción
- •Coherencia: ✅ Precios coinciden
- •Muestra informe
- •Pregunta si corregir
Checklist Rápido (para revisiones manuales)
Campos
- •
titlepresente y con formato correcto - •
description>= 50 caracteres - •
categoryválida - •
subcategoryválida - •
brandpresente - •
pricecon formato "XXX€" - •
pros>= 3 elementos - •
cons>= 2 elementos - •
donde_comprar>= 1 tienda con nombre, url, precio - •
updatedAten formato YYYY-MM-DD
Calidad
- • Descripción honesta, sin exageraciones
- • Pros específicos y verificables
- • Cons útiles para decidir
- • Testimonios con fuente citada
- • Precios coherentes entre campos
Ortografía
- • Tildes en palabras frecuentes (años, garantía, batería, etc.)
- • Mayúscula al inicio de cada pro/con
- • Signos de interrogación de apertura si hay preguntas
Historial de Cambios
| Fecha | Cambio |
|---|---|
| 2026-01-21 | Versión inicial |