Cism-Ch/content-quality-validator

Skill: Validador de Qualidade de Conteúdo

Descrição

Este skill permite detectar automaticamente erros de qualidade em arquivos de descrição de produtos (long-.html e short-.html) e gerar um relatório de correção detalhado. O agente usará este relatório para aplicar as correções por meio das ferramentas de edição.

Tipos de erros detectados

🔴 Erros Críticos (Devem ser corrigidos imediatamente)

1. Presença de N/A nas especificações

   • Detecção: Pesquisar "N/A" nas tabelas de especificações e textos
   • Impacto: Violação dos padrões de qualidade

2. Erros gramaticais

   • "Le cette" → Deve ser "Cette"
   • "Sa cette" → Deve ser "Cette"
   • "Les la" → Deve ser "La"
   • "Ce cet" → Deve ser "Cet"
   • "Sa la" → Deve ser "La"
   • Etc. (todos os erros de duplo determinante ou concordância)

3. Confusão RAM/Armazenamento

   • "256 GB de RAM" → Deve ser "12 GB de RAM e 256 GB de armazenamento"
   • "512 GB de RAM" → Deve ser "16 GB de RAM e 512 GB de armazenamento"
   • Etc. (todos os erros onde a quantidade de RAM é confundida com o armazenamento)

4. Inconsistências técnicas

   • Processador diferente entre texto e tabela
   • Especificações contraditórias
   • Etc.

5. Presença de hipérboles e superlativos excessivos (CRÍTICO — V3.2)

   • Detecção: Uso de termos de marketing enfáticos não justificados (ex: "incrível", "revolucionário", "sedução fatal", "colossal", "sublime").
   • Regra: Proibição absoluta. O tom deve permanecer puramente factual, sóbrio e de alto padrão. Qualquer palavra proibida resultará em FAIL da auditoria.

🟡 Problemas de Fluidez (A melhorar)

1. Repetições excessivas de transições

   • Mais de 2 usos de "Além disso" por seção
   • Mais de 2 usos de "Em seguida" no arquivo
   • Etc.

2. Estruturas repetitivas

   • "[Assunto], o [Produto]..." usado mais de 2 vezes
   • Falta de pronomes para criar coesão
   • Falta de variação nas introduções de seções
   • Falta de conectores lógicos variados (Por outro lado, Aliás, Vale notar, etc.)

3. Ritmo das frases (CRÍTICO — AIOSEO)

   • Mais de 25% das frases com mais de 20 palavras (limite bloqueante AIOSEO)
   • Mais de 3 frases curtas consecutivas (menos de 10 palavras)
   • Falta de variação no comprimento das frases

4. Taxa de transições (CRÍTICO — AIOSEO)

   • Menos de 30% das frases contendo uma palavra de transição
   • As transições podem estar em qualquer lugar da frase, não apenas no início

🟠 Problemas de Tom Natural (A melhorar)

1. Nomes genéricos

   • "O 70", "O Pro", "O Pro+", "O X"
   • Deve ser substituído pelo nome completo ou por pronomes

2. Fórmulas prontas e Enchimento

   • "Com seu design..."
   • "Graças à sua tecnologia..."
   • "Dotado de..."
   • "O auge da tecnologia", "Incrível", "Revolucionário" (Nenhuma hipérbole genérica permitida).
   • "O smartphone oferece..." (se repetido)

3. Verbos pouco variados

   • Repetição excessiva de "dispõe de", "possui", "embarca"

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

1. Meta Título não descritivo

   • Ausência da RAM, Armazenamento ou Tamanho da Tela no Título.

2. Meta Descrição fora do assunto

   • Presença das palavras "SAV" ou "Garantia comercial".
   • Ausência da menção "Entrega Abidjan" (ou variantes locais).

3. LSI Keywords insuficientes

   • Menos de 10 palavras-chave na lista.
   • Presença de palavras-chave informativas ("teste", "opinião", "como funciona") em vez de palavras transacionais ("preço", "comprar").

4. Copiar-Colar das Variantes (CRÍTICO)

   • O bloco seo da seção Short é idêntico ou quase idêntico ao bloco seo da seção Long. A IA trapaceou.

Procedimento de uso

Etapa 1: Análise do arquivo alvo

Ação: Ler o arquivo longo ou curto a ser analisado
Comando: read
Parâmetro: filePath do arquivo a verificar

Etapa 2: Detecção de erros

Para cada tipo de erro, realizar as seguintes buscas:

2.1 Detecção N/A

• Pesquisar: "N/A" em todo o conteúdo
• Anotar: Linha exata, contexto, valor sugerido

2.2 Detecção de erros gramaticais

• Pesquisar: "Le cette", "Sa cette", "Les la", "Ce cet", "Sa la", etc.
• Anotar: Cada ocorrência com linha exata

2.3 Detecção RAM/Armazenamento

• Pesquisar: "GB de RAM" precedido de 256, 512, 1024
• Verificar: Se é realmente RAM ou armazenamento

2.4 Detecção de repetições

• Contar: Ocorrências de conectores lógicos "Além disso", "Em seguida", "Por outro lado", etc.
• Identificar: Estruturas repetitivas "[Assunto], o [Produto]"

2.5 Detecção de nomes genéricos

• Pesquisar: "O 70", "O Pro", "O Pro+", "O X", "O Mate", etc.
• Anotar: Linhas onde o nome completo deve ser usado

Etapa 3: Geração do relatório de Auditoria (PASS / FAIL)

Criar um arquivo markdown com esta estrutura exata, que será enviado ao Orquestrador ou ao Agente de produção:

# 📋 Relatório de Controle de Qualidade - [Nome do Produto]
**Arquivo:** [caminho/para/arquivo.json ou .html]
**Status da Auditoria:** ❌ FAIL (ou ✅ PASS se nenhum erro detectado)
**Agente:** content-quality-validator

---

## 🔴 Erros Críticos (Correção Obrigatória)

### 1. Erros SEO de E-Commerce
| Linha | Erro Detectado | Regra Violada |
|-------|----------------|---------------|
| X | Título sem a RAM | O Meta Título deve incluir todas as especificações técnicas |
| Y | Presença da palavra "SAV" | A Meta Descrição deve falar apenas de entrega Abidjan/Qualidade |
| Z | 6 palavras-chave | Mínimo de 10 palavras-chave exigido |
| W | SEO Idêntico | O SEO do Short é idêntico ao do Long (Copiar-colar IA detectado) |

### 2. Valores N/A
| Linha | Erro | Correção sugerida |
|-------|------|-------------------|
| X | Processador: N/A | [Valor correto] |
| Y | Bateria: N/A | [Valor correto] |
Ou todas as outras ocorrências de N/A

**Correções a aplicar:**

**Linha X - Processador N/A:**

OLD: N/A NEW: [Valor correto]

### 2. Erros Gramaticais
| Linha | Erro | Correção |
|-------|------|----------|
| Y | Le cette | Cette |
| Z | Les la | La |
Ou todos os outros erros gramaticais detectados

**Correções a aplicar:**

**Linha Y - Duplo determinante:**

OLD: Le cette configuration NEW: Cette configuration

**Linha Z - Duplo determinante + concordância:**

OLD: Les la gestion NEW: La gestion

### 3. Erros RAM/Armazenamento
| Linha | Erro | Correção |
|-------|------|----------|
| W | 256 GB de RAM | 12 GB de RAM e 256 GB de armazenamento |

**Correções a aplicar:**

**Linha W - Confusão RAM/Armazenamento:**

OLD: O smartphone oferece 256 GB de RAM NEW: O smartphone oferece 12 GB de RAM e 256 GB de armazenamento

### 4. Hipérboles e Palavras Proibidas
| Linha/Campo | Palavra Detectada | Regra Violada |
|-------------|-------------------|---------------|
| short_description.teaser | revoluciona | Proibição absoluta de recorrer ao vocabulário publicitário excessivo |

**Correções a aplicar:**

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

OLD: O espetacular Blackview DCM6 revoluciona absolutamente o fastidioso trabalho nômade NEW: O Blackview DCM6 simplifica o trabalho nômade

---

## 🟡 Problemas de Fluidez

### Repetições excessivas
- **"Além disso" usado X vezes** (máx. recomendado: 2 por seção)
  - Linha A, B, C, D
  - **Sugestões:** Substituir por "Por outro lado", "Aliás", "Vale notar"

**Correções sugeridas:**

**Linha B:**

OLD: Além disso, a tela... NEW: Por outro lado, a tela...

### Estruturas repetitivas
- **Padrão "[Assunto], o [Produto]" detectado X vezes**
  - Linhas: E, F, G

**Correções sugeridas:**

**Linha E:**

OLD: O desempenho, o Huawei Nova 13 se beneficia... NEW: Em termos de desempenho, ele se beneficia...

---

## 🟠 Problemas de Tom Natural

### Nomes genéricos a substituir
| Linha | Genérico | Correção |
|-------|----------|----------|
| H | O 70 | O Huawei Pura 70 |
| I | O Pro | Este modelo |

**Correções a aplicar:**

**Linha H:**

OLD: O 70 adota... NEW: O Pura 70 adota...

---

## ✅ Checklist de correção

- [ ] Todos os N/A corrigidos
- [ ] Todos os erros gramaticais corrigidos
- [ ] Erros RAM/Armazenamento corrigidos
- [ ] Repetições de transições variadas
- [ ] Nomes genéricos substituídos
- [ ] Estrutura fluida verificada
- [ ] Tom natural melhorado
- [ ] Informações técnicas coerentes
- [ ] Nenhuma hipérbole/palavra proibida presente nos textos

---

## 📊 Estatísticas

- **Erros críticos:** X
- **Problemas de fluidez:** Y
- **Problemas de tom:** Z
- **Total de erros detectados:** X+Y+Z
- **Total de correções:** X+Y+Z

Etapa 4: Aplicação das correções

O agente deve:

1. Ler o relatório de correção gerado
2. Para cada correção listada:
   • Localizar a oldString exata no arquivo fonte
   • Usar edit com oldString/newString
   • Verificar se a correção foi aplicada
3. Continuar até esgotar as correções

Exemplo completo de uso

Cenário: Correção do arquivo longo de um produto

Etapa 1: Análise

Usuário: "Verifique a qualidade do arquivo products/huawei-nova-all/nova-13/long-nova-13.html"

Etapa 2: Detecção

Ação: read filePath="products/huawei-nova-all/nova-13/long-nova-13.html"
Resultado: Detecção de:
- 1 N/A (Processador)
- 0 erros gramaticais
- 4 repetições "Além disso"
- 4 estruturas "[Assunto], o [Produto]"

Etapa 3: Geração do relatório

Ação: write filePath="Docs/correction-report-nova-13.md"
Conteúdo: Relatório estruturado com oldString/newString

Etapa 4: Correção

Para cada entrada do relatório:
  Ação: edit filePath="..." oldString="..." newString="..."

Boas práticas

1. Sempre ler o arquivo completo antes de gerar o relatório
2. Anotar os números de linha exatos para facilitar a correção
3. Fornecer o contexto (linhas antes/depois) para cada oldString
4. Priorizar os erros críticos antes dos problemas de fluidez
5. Verificar a coerência entre texto e tabela de especificações

Limitações conhecidas

• Este skill não detecta erros de layout HTML
• Erros de estilo (inline styles) não são verificados aqui, mas podem ser detectados por outro skill de formatação ou pelos scripts de validação validate_html_template.py ; validate_product_pack.ps1
• A detecção do tom natural é indicativa e requer uma releitura humana
• As sugestões de substituição para as transições são recomendações, não obrigações

Recursos

• Relatório de exemplo : Ver Docs/rapport_audit_huawei_long_files.md para um exemplo de detecção completa
• Skill de formatação : Consultar PRODUCT_FORMATTING_SKILL.md para os padrões de referência