Communityコーディング&開発github.com

Cism-Ch/content-quality-validator

商品説明ファイル(long-*.html、short-*.html)の品質エラーを自動検出し、詳細な修正レポートを生成するスキル。AIエージェントはこのレポートを基に、編集ツールを使用して修正を適用します。

content-quality-validator とは?

このスキルは、商品説明ファイル(long-*.html、short-*.html)に含まれる品質エラーを自動的に検出し、詳細な修正レポートを生成します。検出対象は、AIOSEO準拠違反(文長、トランジション率)、文法的誤り、「N/A」の有無、RAM/ストレージの混同、技術的な矛盾、誇張表現、SEO e-コマースエラー(メタタイトル、メタ説明、LSIキーワード、バリアントのコピペ)など、多岐にわたります。また、リズム、繋がり、自然な語調に関する問題(繰り返し、総称名、決まり文句)も指摘します。このスキルは、CI/CDパイプラインやQAゲート(例:/audit-product-pack)に組み込んで、品質基準を満たさない商品説明を自動的にブロック・修正するのに役立ちます。エージェントは、ファイルの読み取り、エラー検出、構造化レポートの生成、そしてレポートに基づいた編集ツールによる修正適用までを自動実行します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cism-Ch/AI-Content-Management-and-PIM-workflow/tree/main/.agents/skills/content-quality-validator

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

スキル: コンテンツ品質バリデーター

説明

このスキルは、商品説明ファイル(long-.html、short-.html)の品質エラーを自動的に検出し、詳細な修正レポートを生成します。エージェントはこのレポートを使用して、編集ツールで修正を適用します。

検出されるエラーの種類

🟴 致命的エラー(即時修正必須)

  1. 仕様に「N/A」が含まれている

    • 検出方法: スペック表とテキスト内の「N/A」を検索
    • 影響: 品質基準違反
  2. 文法エラー

    • 「Le cette」→「Cette」とする必要があります
    • 「Sa cette」→「Cette」とする必要があります
    • 「Les la」→「La」とする必要があります
    • 「Ce cet」→「Cet」とする必要があります
    • 「Sa la」→「La」とする必要があります
    • など(二重限定詞や一致に関するすべてのエラー)
  3. RAM/ストレージの混同

    • 「256 Go de RAM」→「12 Go de RAM et 256 Go de stockage」とする必要があります
    • 「512 Go de RAM」→「16 Go de RAM et 512 Go de stockage」とする必要があります
    • など(RAM容量とストレージを混同しているすべてのエラー)
  4. 技術的な矛盾

    • テキストと表でプロセッサが異なる
    • 矛盾する仕様
    • など
  5. 誇張表現と過度な最上級の使用(致命的 — V3.2)

    • 検出方法: 不必要なマーケティング用語(例:「incroyable」「révolutionnaire」「séduction fatale」「colossal」「sublime」)の使用
    • ルール: 絶対禁止。トーンは純粋に事実ベースで、控えめかつ高級感を保つ必要があります。禁止単語が見つかると、監査はFAILになります。

🟡 流暢性の問題(改善推奨)

  1. トランジションの過剰な繰り返し

    • セクションごとに「De plus」を2回以上使用
    • ファイル内で「Ensuite」を2回以上使用
    • など
  2. 繰り返し構造

    • 「[Sujet], le [Produit]...」が2回以上使用されている
    • つながりを作る代名詞の不足
    • セクション導入部のバリエーション不足
    • 論理接続詞(Par ailleurs, D'ailleurs, À noterなど)のバリエーション不足
  3. 文のリズム(致命的 — AIOSEO)

    • 20語を超える文が全体の25%以上(AIOSEOの閾値を超過)
    • 10語未満の短い文が3つ以上連続
    • 文の長さのバリエーション不足
  4. トランジション率(致命的 — AIOSEO)

    • トランジション語を含む文が30%未満
    • トランジションは文の先頭だけでなく、どこにあっても構いません

🟠 自然な語調の問題(改善推奨)

  1. 総称名

    • 「Le 70」「Le Pro」「Le Pro+」「Le X」
    • 完全な製品名または代名詞に置き換える必要があります
  2. 決まり文句と冗長表現

    • 「Avec sa conception...」
    • 「Grâce à sa technologie...」
    • 「Doté de...」
    • 「Le summum de la technologie」「Incroyable」「Révolutionnaire」(一般的な誇張表現は一切禁止)
    • 「Le smartphone propose...」(繰り返される場合)
  3. 動詞のバリエーション不足

    • 「dispose de」「possède」「embarque」の過度な繰り返し

🔵 SEO e-コマースエラー(致命的 V2.1)

  1. メタタイトルが説明的でない

    • タイトルにRAM、ストレージ、画面サイズが含まれていない
  2. メタ説明が主題から外れている

    • 「SAV」または「Garantie commerciale」の単語が含まれている
    • 「Livraison Abidjan」(または地域のバリエーション)の記載がない
  3. LSIキーワードが不十分

    • リスト内のキーワードが10個未満
    • 情報提供型キーワード(「test」「avis」「comment ça marche」)が、トランザクション型キーワード(「prix」「acheter」)の代わりに含まれている
  4. バリアントのコピー&ペースト(致命的)

    • Shortセクションの seo ブロックがLongセクションの seo ブロックと同一またはほぼ同一。AIが不正を行った。

使用手順

ステップ1: 対象ファイルの分析

アクション: 分析するlongまたはshortファイルを読み取る
コマンド: read
パラメータ: チェックするファイルのfilePath

ステップ2: エラーの検出

エラーの種類ごとに、以下の検索を実行します。

2.1 N/Aの検出

  • 検索: コンテンツ全体の「N/A」
  • 記録: 正確な行、コンテキスト、提案値

2.2 文法エラーの検出

  • 検索: 「Le cette」「Sa cette」「Les la」「Ce cet」「Sa la」など
  • 記録: 正確な行を含む各出現箇所

2.3 RAM/ストレージの検出

  • 検索: 256、512、1024の前にある「Go de RAM」
  • 確認: それがRAMなのかストレージなのか

2.4 繰り返しの検出

  • カウント: 論理接続詞「De plus」「Ensuite」「Par ailleurs」などの出現回数
  • 特定: 繰り返し構造「[Sujet], le [Produit]」

2.5 総称名の検出

  • 検索: 「Le 70」「Le Pro」「Le Pro+」「Le X」「Le Mate」など
  • 記録: 完全な製品名を使用すべき行

ステップ3: 監査レポートの生成(PASS / FAIL)

以下の正確な構造を持つマークダウンファイルを作成し、オーケストレーターまたは制作エージェントに返します。

# 📋 品質管理レポート - [製品名]
**ファイル:** [パス/ファイル.json または .html]
**監査ステータス:** ❌ FAIL(または ✅ PASS、エラーが検出されなかった場合)
**エージェント:** content-quality-validator

---

## 🟴 致命的エラー(修正必須)

### 1. SEO e-コマースエラー
| 行 | 検出されたエラー | 違反されたルール |
|-------|-----------------|--------------|
| X | RAMのないタイトル | メタタイトルにはすべての技術仕様を含める必要があります |
| Y | 「SAV」という単語の存在 | メタ説明は配送(アビジャン)/品質についてのみ言及する必要があります |
| Z | キーワードが6個 | 最低10個のキーワードが必要です |
| W | SEOが同一 | ShortのSEOがLongと同一です(AIのコピペが検出されました) |

### 2. N/A値
| 行 | エラー | 提案される修正 |
|-------|--------|---------------------|
| X | プロセッサ: N/A | [正しい値] |
| Y | バッテリー: N/A | [正しい値] |
またはその他すべてのN/Aの出現箇所

**適用する修正:**

**行 X - プロセッサ N/A:**

OLD: N/A NEW: [正しい値]


### 2. 文法エラー
| 行 | エラー | 修正 |
|-------|--------|------------|
| Y | Le cette | Cette |
| Z | Les la | La |
または検出されたその他すべての文法エラー

**適用する修正:**

**行 Y - 二重限定詞:**

OLD: Le cette configuration NEW: Cette configuration


**行 Z - 二重限定詞 + 一致:**

OLD: Les la gestion NEW: La gestion


### 3. RAM/ストレージエラー
| 行 | エラー | 修正 |
|-------|--------|------------|
| W | 256 Go de RAM | 12 Go de RAM et 256 Go de stockage |

**適用する修正:**

**行 W - RAM/ストレージ混同:**

OLD: Le smartphone propose 256 Go de RAM NEW: Le smartphone propose 12 Go de RAM et 256 Go de stockage


### 4. 誇張表現と禁止単語
| 行/フィールド | 検出された単語 | 違反されたルール |
|-------------|--------------|--------------|
| short_description.teaser | révolutionne | 過剰な広告語彙の使用は絶対禁止 |

**適用する修正:**

**フィールド short_description.teaser - 誇張表現:**

OLD: Le spectaculaire Blackview DCM6 révolutionne absolument le fastidieux travail nomade NEW: Le Blackview DCM6 simplifie le travail nomade


---

## 🟡 流暢性の問題

### 過剰な繰り返し
- **「De plus」がX回使用されています**(推奨最大: セクションごとに2回)
  - 行 A、B、C、D
  - **提案:** 「Par ailleurs」「D'ailleurs」「À noter」に置き換え

**提案される修正:**

**行 B:**

OLD: De plus, l'écran... NEW: Par ailleurs, l'écran...


### 繰り返し構造
- **パターン「[Sujet], le [Produit]」がX回検出されました**
  - 行: E、F、G

**提案される修正:**

**行 E:**

OLD: Les performances, le Huawei Nova 13 bénéficie... NEW: Côté performances, il bénéficie...


---

## 🟠 自然な語調の問題

### 置き換えるべき総称名
| 行 | 総称 | 修正 |
|-------|-----------|------------|
| H | Le 70 | Le Huawei Pura 70 |
| I | Le Pro | Ce modèle |

**適用する修正:**

**行 H:**

OLD: Le 70 adopte... NEW: Le Pura 70 adopte...


---

## ✅ 修正チェックリスト

- [ ] すべてのN/Aを修正
- [ ] すべての文法エラーを修正
- [ ] RAM/ストレージエラーを修正
- [ ] トランジションの繰り返しを多様化
- [ ] 総称名を置き換え
- [ ] 流暢な構造を確認
- [ ] 自然な語調を改善
- [ ] 技術情報の一貫性を確認
- [ ] テキストに誇張表現/禁止単語がないことを確認

---

## 📊 統計

- **致命的エラー:** X
- **流暢性の問題:** Y
- **語調の問題:** Z
- **検出されたエラーの合計:** X+Y+Z
- **修正の合計:** X+Y+Z

ステップ4: 修正の適用

エージェントは以下を実行する必要があります。

  1. 生成された修正レポートを読み取る
  2. リストされた各修正について:
    • ソースファイル内の正確なoldStringを特定する
    • oldString/newStringを指定して edit を使用する
    • 修正が適用されたことを確認する
  3. 修正がすべて完了するまで続ける

完全な使用例

シナリオ: 製品のlongファイルの修正

ステップ1: 分析

ユーザー: "products/huawei-nova-all/nova-13/long-nova-13.html" ファイルの品質をチェックしてください

ステップ2: 検出

アクション: read filePath="products/huawei-nova-all/nova-13/long-nova-13.html"
結果: 以下を検出:
- 1つのN/A(プロセッサ)
- 0件の文法エラー
- 4回の「De plus」の繰り返し
- 4つの構造「[Sujet], le [Produit]」

ステップ3: レポート生成

アクション: write filePath="Docs/correction-report-nova-13.md"
内容: oldString/newStringを含む構造化レポート

ステップ4: 修正

レポートの各エントリについて:
  アクション: edit filePath="..." oldString="..." newString="..."

ベストプラクティス

  1. レポートを生成する前に、必ずファイル全体を読み取る
  2. 修正を容易にするために、正確な行番号を記録する
  3. 各oldStringにコンテキスト(前後の行)を提供する
  4. 流暢性の問題よりも致命的エラーを優先する
  5. テキストと仕様表の間の一貫性を確認する

既知の制限

  • このスキルはHTMLレイアウトのエラーを検出しません
  • スタイルエラー(インラインスタイル)はここではチェックされませんが、別のフォーマットスキル、または validate_html_template.py、validate_product_pack.ps1 検証スクリプトを通じて検出される可能性があります
  • 自然な語調の検出は参考程度であり、人間による再確認が必要です
  • トランジションの置き換え提案は推奨であり、義務ではありません

リソース

  • サンプルレポート: 完全な検出例については Docs/rapport_audit_huawei_long_files.md を参照
  • フォーマットスキル: 参照標準については PRODUCT_FORMATTING_SKILL.md を参照

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル