AgentSkillsCN

revisar-producto

检查现有产品信息卡片(拼写、必填字段、URL链接、内容一致性)。当用户说“检查产品”、“检查信息卡片”、“核实产品”时,或调用/revisar-producto时,即可使用此技能。

SKILL.md
--- frontmatter
name: revisar-producto
description: Revisa fichas de producto existentes (ortografía, campos obligatorios, URLs, coherencia). Usar cuando el usuario diga "revisar producto", "revisar ficha", "verificar producto" o invoque /revisar-producto.
allowed-tools: Read, Edit, Grep, Glob, WebFetch

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:

ComandoAcción
revisar producto {nombre}Revisar un producto específico
revisar ficha {ruta}Revisar archivo por ruta
revisar todos los productosRevisar 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:

  1. Localiza el archivo
  2. Ejecuta todas las verificaciones
  3. Muestra resumen con errores encontrados
  4. 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:

CampoObligatorioNotas
titleNo vacío
descriptionMínimo 50 caracteres
categoryValor válido del schema
subcategoryValor válido del schema
brandNo vacío
priceFormato válido (ej: "599€")
prosMínimo 3 elementos
consMínimo 2 elementos
donde_comprarMínimo 1 tienda
updatedAtFormato 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 revisarVerificar
titleAcentos, mayúsculas
descriptionAcentos, puntuación, ¿? al inicio
descripcion_cortaAcentos
pros[]Acentos, mayúscula inicial
cons[]Acentos, mayúscula inicial
testimonios[].textoAcentos, puntuación

Errores comunes a buscar:

IncorrectoCorrecto
anosaños
garantiagarantía
bateriabatería
electronicaelectrónica
movilmóvil
facilfácil
disenodiseño
numeronúmero
EspanaEspaña

2.4 Coherencia de Datos

VerificaciónCómo
Precio en price = precio en donde_comprarComparar valores
updatedAt no es futuroComparar con fecha actual
reparabilidad tiene reparabilidadSourceSi uno existe, el otro también
Testimonios tienen fuenteTodos los testimonios deben citar fuente
comparativa tiene todos sus camposSi 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

  1. Listar todos los archivos a revisar
  2. Preguntar: "Encontré X productos. ¿Reviso todos o prefieres elegir?"
  3. Revisar cada uno, acumulando errores
  4. 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íaSubcategorías válidas
electronicamoviles, ordenadores, audio, camaras
electrodomesticoslavado, cocina, climatizacion, limpieza
ropabasicos, calzado, accesorios
movilidadbicicletas, 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_anos está bien sin tilde)
  • Slugs y rutas de archivo
  • Valores de category y subcategory (no llevan tildes por diseño)

Ejemplo Práctico

Usuario: "revisar producto Miele WWI880"

Paco:

  1. Busca: Glob: content/**/miele*.md
  2. Encuentra: content/electrodomesticos/lavado/miele-wwi880.md
  3. Lee el archivo
  4. Ejecuta verificaciones:
    • Campos obligatorios: ✅ Todos presentes
    • Campos recomendados: ⚠️ Falta impacto_ambiental
    • Ortografía: 🔤 1 error en descripción
    • Coherencia: ✅ Precios coinciden
  5. Muestra informe
  6. Pregunta si corregir

Checklist Rápido (para revisiones manuales)

Campos

  • title presente y con formato correcto
  • description >= 50 caracteres
  • category válida
  • subcategory válida
  • brand presente
  • price con formato "XXX€"
  • pros >= 3 elementos
  • cons >= 2 elementos
  • donde_comprar >= 1 tienda con nombre, url, precio
  • updatedAt en 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

FechaCambio
2026-01-21Versión inicial