Cism-Ch/content-quality-validator

Skill: Content-Qualitätsprüfer

Beschreibung

Dieser Skill ermöglicht die automatische Erkennung von Qualitätsfehlern in Produktbeschreibungsdateien (long-.html und short-.html) und die Erstellung eines detaillierten Korrekturberichts. Der Agent verwendet diesen Bericht, um die Korrekturen über die Bearbeitungswerkzeuge anzuwenden.

Erkannte Fehlertypen

🔴 Kritische Fehler (Müssen sofort korrigiert werden)

1. Vorhandensein von N/A in den Spezifikationen

   • Erkennung: Suche nach "N/A" in Spezifikationstabellen und Texten
   • Auswirkung: Verstoß gegen Qualitätsstandards

2. Grammatikalische Fehler

   • "Le cette" → Muss "Cette" sein
   • "Sa cette" → Muss "Cette" sein
   • "Les la" → Muss "La" sein
   • "Ce cet" → Muss "Cet" sein
   • "Sa la" → Muss "La" sein
   • usw. (alle Fehler mit doppeltem Determinanten oder Übereinstimmungsfehlern)

3. Verwechslung RAM/Speicher

   • "256 Go de RAM" → Muss "12 Go de RAM und 256 Go Speicher" sein
   • "512 Go de RAM" → Muss "16 Go de RAM und 512 Go Speicher" sein
   • usw. (alle Fehler, bei denen die RAM-Menge mit dem Speicher verwechselt wird)

4. Technische Inkonsistenzen

   • Unterschiedlicher Prozessor zwischen Text und Tabelle
   • Widersprüchliche Spezifikationen
   • usw.

5. Vorhandensein von Übertreibungen und übermäßigen Superlativen (KRITISCH — V3.2)

   • Erkennung: Verwendung von nicht gerechtfertigten, emphatischen Marketingbegriffen (z.B. "unglaublich", "revolutionär", "fatale Verführung", "kolossal", "sublim").
   • Regel: Absolutes Verbot. Der Ton muss rein sachlich, nüchtern und hochwertig bleiben. Jedes verbotene Wort führt zu einem FEHLER im Audit.

🟡 Probleme mit der Lesbarkeit (Zu verbessern)

1. Übermäßige Wiederholungen von Übergängen

   • Mehr als 2 Verwendungen von "De plus" pro Abschnitt
   • Mehr als 2 Verwendungen von "Ensuite" in der Datei
   • usw.

2. Sich wiederholende Satzstrukturen

   • "[Subjekt], das [Produkt]..." mehr als 2 Mal verwendet
   • Mangel an Pronomen zur Verknüpfung
   • Mangel an Abwechslung in Abschnittseinleitungen
   • Mangel an abwechslungsreichen logischen Verknüpfungswörtern (Par ailleurs, D'ailleurs, À noter, usw.)

3. Satzrhythmus (KRITISCH — AIOSEO)

   • Mehr als 25% der Sätze mit mehr als 20 Wörtern (AIOSEO-Sperrgrenze)
   • Mehr als 3 aufeinanderfolgende kurze Sätze (weniger als 10 Wörter)
   • Mangel an Abwechslung in der Satzlänge

4. Übergangsrate (KRITISCH — AIOSEO)

   • Weniger als 30% der Sätze enthalten ein Übergangswort
   • Die Übergänge können überall im Satz stehen, nicht nur am Anfang

🟠 Probleme mit natürlichem Tonfall (Zu verbessern)

1. Generische Namen

   • "Das 70", "Das Pro", "Das Pro+", "Das X"
   • Müssen durch den vollständigen Namen oder Pronomen ersetzt werden

2. Standardformulierungen und Füllwörter

   • "Mit seinem Design..."
   • "Dank seiner Technologie..."
   • "Ausgestattet mit..."
   • "Der Gipfel der Technologie", "Unglaublich", "Revolutionär" (Keine generischen Übertreibungen erlaubt).
   • "Das Smartphone bietet..." (falls wiederholt)

3. Wenig abwechslungsreiche Verben

   • Übermäßige Wiederholung von "verfügt über", "besitzt", "bietet"

🔵 E-Commerce-SEO-Fehler (Kritisch V2.1)

1. Meta-Titel nicht aussagekräftig

   • Fehlen von RAM, Speicher oder Bildschirmgröße im Titel.

2. Meta-Beschreibung themenfremd

   • Vorhandensein der Wörter "Kundendienst" oder "Gewährleistung".
   • Fehlen des Hinweises "Lieferung Abidjan" (oder lokale Varianten).

3. Unzureichende LSI-Keywords

   • Weniger als 10 Keywords in der Liste.
   • Vorhandensein von informativen Keywords ("Test", "Bewertung", "Funktionsweise") anstelle von transaktionalen Wörtern ("Preis", "Kaufen").

4. Kopieren/Einfügen von Varianten (KRITISCH)

   • Der seo-Block des Short-Abschnitts ist identisch oder nahezu identisch mit dem seo-Block des Long-Abschnitts. Die KI hat geschummelt.

Anwendungsverfahren

Schritt 1: Analyse der Zieldatei

Aktion: Lesen der zu analysierenden long- oder short-Datei
Befehl: read
Parameter: filePath der zu überprüfenden Datei

Schritt 2: Fehlererkennung

Für jeden Fehlertyp die folgenden Recherchen durchführen:

2.1 Erkennung von N/A

• Suche: "N/A" im gesamten Inhalt
• Notieren: Genau Zeile, Kontext, vorgeschlagener Wert

2.2 Erkennung von grammatikalischen Fehlern

• Suche: "Le cette", "Sa cette", "Les la", "Ce cet", "Sa la", usw.
• Notieren: Jedes Vorkommen mit genauer Zeile

2.3 Erkennung von RAM/Speicher-Fehlern

• Suche: "Go de RAM" vorangestellt von 256, 512, 1024
• Überprüfen: Ob es sich tatsächlich um RAM oder Speicher handelt

2.4 Erkennung von Wiederholungen

• Zählen: Vorkommen von logischen Verknüpfungswörtern "De plus", "Ensuite", "Par ailleurs", usw.
• Identifizieren: Sich wiederholende Satzstrukturen "[Subjekt], das [Produkt]"

2.5 Erkennung von generischen Namen

• Suche: "Das 70", "Das Pro", "Das Pro+", "Das X", "Das Mate", usw.
• Notieren: Zeilen, an denen der vollständige Name verwendet werden sollte

Schritt 3: Generierung des Audit-Berichts (PASS / FAIL)

Erstellen einer Markdown-Datei mit dieser genauen Struktur, die an den Orchestrator oder Produktions-Agenten zurückgesendet wird:

# 📋 Qualitätskontrollbericht - [Produktname]
**Datei:** [Pfad/zu/datei.json oder .html]
**Audit-Status:** ❌ FAIL (oder ✅ PASS, wenn keine Fehler erkannt)
**Agent:** content-quality-validator

---

## 🔴 Kritische Fehler (Korrektur erforderlich)

### 1. E-Commerce-SEO-Fehler
| Zeile | Erkannter Fehler | Verletzte Regel |
|-------|------------------|-----------------|
| X | Titel ohne RAM | Der Meta-Titel muss alle technischen Spezifikationen enthalten |
| Y | Vorhandensein des Wortes "Kundendienst" | Die Meta-Beschreibung sollte nur von Lieferung Abidjan/Qualität sprechen |
| Z | 6 Keywords | Mindestens 10 Keywords erforderlich |
| W | Identisches SEO | Das SEO des Short-Abschnitts ist identisch mit dem Long-Abschnitt (KI-Kopieren/Einfügen erkannt) |

### 2. N/A-Werte
| Zeile | Fehler | Vorgeschlagene Korrektur |
|-------|--------|--------------------------|
| X | Prozessor: N/A | [Richtiger Wert] |
| Y | Akku: N/A | [Richtiger Wert] |
oder alle anderen Vorkommen von N/A

**Anzuwendende Korrekturen:**

**Zeile X - Prozessor N/A:**

ALT: N/A NEU: [Richtiger Wert]

### 2. Grammatikalische Fehler
| Zeile | Fehler | Korrektur |
|-------|--------|------------|
| Y | Le cette | Cette |
| Z | Les la | La |
oder alle anderen erkannten grammatikalischen Fehler

**Anzuwendende Korrekturen:**

**Zeile Y - Doppelter Determinant:**

ALT: Le cette configuration NEU: Cette configuration

**Zeile Z - Doppelter Determinant + Übereinstimmung:**

ALT: Les la gestion NEU: La gestion

### 3. RAM/Speicher-Fehler
| Zeile | Fehler | Korrektur |
|-------|--------|------------|
| W | 256 Go de RAM | 12 Go de RAM und 256 Go Speicher |

**Anzuwendende Korrekturen:**

**Zeile W - Verwechslung RAM/Speicher:**

ALT: Das Smartphone bietet 256 Go de RAM NEU: Das Smartphone bietet 12 Go de RAM und 256 Go Speicher

### 4. Übertreibungen und verbotene Wörter
| Zeile/Feld | Erkanntes Wort | Verletzte Regel |
|------------|----------------|-----------------|
| short_description.teaser | revolutioniert | Absolutes Verbot von übermäßigem Werbevokabular |

**Anzuwendende Korrekturen:**

**Feld short_description.teaser - Übertreibung:**

ALT: Das spektakuläre Blackview DCM6 revolutioniert die mühsame mobile Arbeit absolut NEU: Das Blackview DCM6 vereinfacht die mobile Arbeit

---

## 🟡 Probleme mit der Lesbarkeit

### Übermäßige Wiederholungen
- **"De plus" X-mal verwendet** (max. empfohlen: 2 pro Abschnitt)
  - Zeile A, B, C, D
  - **Vorschläge:** Ersetzen durch "Par ailleurs", "D'ailleurs", "À noter"

**Vorgeschlagene Korrekturen:**

**Zeile B:**

ALT: De plus, der Bildschirm... NEU: Par ailleurs, der Bildschirm...

### Sich wiederholende Satzstrukturen
- **Muster "[Subjekt], das [Produkt]" X-mal erkannt**
  - Zeilen: E, F, G

**Vorgeschlagene Korrekturen:**

**Zeile E:**

ALT: Die Leistung, das Huawei Nova 13 profitiert... NEU: Bei der Leistung profitiert es...

---

## 🟠 Probleme mit natürlichem Tonfall

### Generische Namen zu ersetzen
| Zeile | Generisch | Korrektur |
|-------|-----------|------------|
| H | Das 70 | Das Huawei Pura 70 |
| I | Das Pro | Dieses Modell |

**Anzuwendende Korrekturen:**

**Zeile H:**

ALT: Das 70 übernimmt... NEU: Das Pura 70 übernimmt...

---

## ✅ Korrektur-Checkliste

- [ ] Alle N/A korrigiert
- [ ] Alle grammatikalischen Fehler korrigiert
- [ ] RAM/Speicher-Fehler korrigiert
- [ ] Wiederholungen von Übergängen variiert
- [ ] Generische Namen ersetzt
- [ ] Flüssige Struktur überprüft
- [ ] Natürlicher Tonfall verbessert
- [ ] Technische Informationen konsistent
- [ ] Keine Übertreibung/Verbotenes Wort in den Texten vorhanden

---

## 📊 Statistiken

- **Kritische Fehler:** X
- **Lesbarkeitsprobleme:** Y
- **Tonfallprobleme:** Z
- **Gesamtzahl erkannter Fehler:** X+Y+Z
- **Gesamtzahl Korrekturen:** X+Y+Z

Schritt 4: Anwendung der Korrekturen

Der Agent muss:

1. Den generierten Korrekturbericht lesen
2. Für jede gelistete Korrektur:
   • Die genaue oldString in der Quelldatei lokalisieren
   • edit mit oldString/newString verwenden
   • Überprüfen, ob die Korrektur angewendet wurde
3. Fortfahren, bis alle Korrekturen abgearbeitet sind

Vollständiges Anwendungsbeispiel

Szenario: Korrektur der long-Datei eines Produkts

Schritt 1: Analyse

Benutzer: „Überprüfe die Qualität der Datei products/huawei-nova-all/nova-13/long-nova-13.html"

Schritt 2: Erkennung

Aktion: read filePath="products/huawei-nova-all/nova-13/long-nova-13.html"
Ergebnis: Erkennung von:
- 1 N/A (Prozessor)
- 0 grammatikalische Fehler
- 4 Wiederholungen "De plus"
- 4 Satzstrukturen "[Subjekt], das [Produkt]"

Schritt 3: Berichtserstellung

Aktion: write filePath="Docs/korrekturbericht-nova-13.md"
Inhalt: Strukturierter Bericht mit oldString/newString

Schritt 4: Korrektur

Für jeden Eintrag im Bericht:
  Aktion: edit filePath="..." oldString="..." newString="..."

Bewährte Verfahren

1. Die Datei immer vollständig lesen, bevor der Bericht erstellt wird
2. Die genauen Zeilennummern notieren, um die Korrektur zu erleichtern
3. Den Kontext angeben (Zeilen vor/nach) für jede oldString
4. Kritische Fehler priorisieren vor Problemen mit der Lesbarkeit
5. Die Konsistenz überprüfen zwischen Text und Spezifikationstabelle

Bekannte Einschränkungen

• Dieser Skill erkennt keine HTML-Layout-Fehler
• Stilfehler (Inline-Stile) werden hier nicht überprüft, können aber von einem anderen Formatierungsskill oder über die Validierungsskripte validate_html_template.py ; validate_product_pack.ps1 erkannt werden
• Die Erkennung des natürlichen Tonfalls ist indikativ und erfordert eine menschliche Überprüfung
• Die Vorschläge zum Ersetzen von Übergängen sind Empfehlungen, keine Verpflichtungen

Ressourcen

• Beispielbericht: Siehe Docs/rapport_audit_huawei_long_files.md für ein Beispiel einer vollständigen Erkennung
• Formatierungsskill: Siehe PRODUCT_FORMATTING_SKILL.md für die Referenzstandards