Community程式設計與開發github.com

Cism-Ch/content-quality-validator

自動偵測商品描述中的品質錯誤(AIOSEO 合規性、句子長度、SKU、禁用風格),用於 QA 審核關卡 /audit-product-pack。

content-quality-validator 是什麼?

Content Quality Validator 是一個專為審核商品描述檔案(long-*.html 與 short-*.html)而設計的 AI 代理技能。它能自動偵測多種類型的品質錯誤,包括嚴重的 SEO 問題(如中繼標題缺少 RAM/儲存空間)、文法與前後不一致、RAM 與儲存混淆、過度行銷用語(如「驚人」、「革命性」)、以及句子長度與轉折詞使用率等流暢度問題。技能會產出結構化的 PASS/FAIL 稽核報告,列出每項錯誤的 exact line 與建議修正(oldString → newString),並引導代理工具逐一套用編輯。此技能支援 Claude Code、Cursor、Codex 等命令列或編輯器整合的代理工具,適用於 QA 閘道 /audit-product-pack。運作方式為:讀取目標檔案 → 對照規則清單掃描 → 產生 markdown 報告 → 逐項修正。最佳實踐包括:完整讀取檔案、記錄行號、優先處理關鍵錯誤。已知限制:不檢查 HTML 排版、語調偵測僅供參考。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

技能:內容品質驗證器

說明

此技能可自動偵測商品描述檔案(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 的 RAM」→ 應為「12 Go 的 RAM 與 256 Go 的儲存空間」
    • 「512 Go 的 RAM」→ 應為「16 Go 的 RAM 與 512 Go 的儲存空間」
    • 等等(所有 RAM 數量與儲存空間混淆的情況)
  4. 技術不一致

    • 處理器在文字與表格中不同
    • 規格互相矛盾
    • 等等
  5. 出現誇飾與過度最高級(關鍵 — V3.2)

    • 偵測:使用未經證實的誇張行銷詞彙(例如「驚人」、「革命性」、「致命魅力」、「巨大」、「絕妙」)
    • 規則:絕對禁止。語氣必須保持純事實、簡潔且高階。任何禁用詞都會導致稽核 FAIL。

🟡 流暢度問題(需改善)

  1. 過多重複的轉折詞

    • 每節使用「此外」超過 2 次
    • 檔案中使用「接著」超過 2 次
    • 等等
  2. 重複結構

    • 「[主詞],[產品]...」使用超過 2 次
    • 缺少代名詞以建立連貫
    • 節標題缺乏變化
    • 缺乏多樣的邏輯連接詞(此外、順帶一提、值得注意的是等)
  3. 句子節奏(關鍵 — AIOSEO)

    • 超過 25% 的句子包含超過 20 個字(AIOSEO 阻斷門檻)
    • 連續超過 3 個短句(少於 10 個字)
    • 句子長度缺乏變化
  4. 轉折詞使用率(關鍵 — AIOSEO)

    • 少於 30% 的句子包含一個轉折詞
    • 轉折詞可位於句子的任何位置,不限於開頭

🟠 語氣自然度問題(需改善)

  1. 通用名稱

    • 「70 型」、「Pro 型」、「Pro+ 型」、「X 型」
    • 應替換為完整名稱或代名詞
  2. 套裝公式與空話

    • 「以其設計...」
    • 「憑藉其技術...」
    • 「配備...」
    • 「技術的巔峰」、「驚人」、「革命性」(不允許任何通用誇飾)
    • 「該智慧型手機提供...」(如果重複)
  3. 動詞變化不足

    • 過度重複「配備有」、「擁有」、「搭載」

🔵 SEO 電商錯誤(關鍵 V2.1)

  1. 中繼標題不具描述性

    • 標題中缺少 RAM、儲存空間或螢幕尺寸
  2. 中繼描述離題

    • 出現「SAV」或「商業保固」等字眼
    • 缺少「阿比讓送貨」(或當地變體)的提及
  3. LSI 關鍵字不足

    • 清單中少於 10 個關鍵字
    • 出現資訊型關鍵字(「測試」、「評論」、「如何運作」)而非交易型關鍵字(「價格」、「購買」)
  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 的 RAM」
  • 檢查:該數字確實是 RAM 還是儲存空間

2.4 偵測重複

  • 計算:邏輯連接詞「此外」、「接著」、「順帶一提」等的出現次數
  • 識別:重複結構「[主詞],[產品]」

2.5 偵測通用名稱

  • 搜尋:「70 型」、「Pro 型」、「Pro+ 型」、「X 型」、「Mate 型」等
  • 記錄:應使用完整名稱的行

步驟 3:產生稽核報告(PASS / FAIL)

建立一個具有下列確切結構的 markdown 檔案,該檔案將回傳給協調器或生產代理:

# 📋 品質控制報告 - [產品名稱]
**檔案:** [path/to/file.json 或 .html]
**稽核狀態:** ❌ FAIL(若未偵測到錯誤則 ✅ PASS)
**代理:** content-quality-validator

---

## 🔴 關鍵錯誤(必須修正)

### 1. SEO 電商錯誤
| 行數 | 偵測到的錯誤 | 違反規則 |
|-------|-----------------|--------------|
| X | 標題缺少 RAM | Meta Title 必須包含所有技術規格 |
| Y | 出現「SAV」字眼 | Meta Description 只能提及阿比讓送貨/品質 |
| 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 的 RAM | 12 Go 的 RAM 與 256 Go 的儲存空間 |

**需套用的修正:**

**第 W 行 - RAM/儲存混淆:**

OLD: 該智慧型手機提供 256 Go 的 RAM NEW: 該智慧型手機提供 12 Go 的 RAM 與 256 Go 的儲存空間


### 4. 誇飾與禁用詞
| 行數/欄位 | 偵測到的詞 | 違反規則 |
|-------------|--------------|--------------|
| short_description.teaser | 革命 | 絕對禁止使用過度廣告詞彙 |

**需套用的修正:**

**short_description.teaser 欄位 - 誇飾:**

OLD: 驚人的 Blackview DCM6 徹底革命了繁瑣的行動工作 NEW: Blackview DCM6 簡化了行動工作


---

## 🟡 流暢度問題

### 過多重複
- **「此外」使用了 X 次**(每節最多建議:2 次)
  - 第 A、B、C、D 行
  - **建議:** 替換為「順帶一提」、「值得注意的是」

**建議修正:**

**第 B 行:**

OLD: 此外,該螢幕... NEW: 順帶一提,該螢幕...


### 重複結構
- **模式「[主詞],[產品]」偵測到 X 次**
  - 行數:E、F、G

**建議修正:**

**第 E 行:**

OLD: 在效能方面,Huawei Nova 13 受益於... NEW: 在效能方面,它受益於...


---

## 🟠 語氣自然度問題

### 需替換的通用名稱
| 行數 | 通用名稱 | 修正 |
|-------|-----------|------------|
| H | 70 型 | Huawei Pura 70 |
| I | Pro 型 | 此型號 |

**需套用的修正:**

**第 H 行:**

OLD: 70 型採用... NEW: Pura 70 採用...


---

## ✅ 修正核對清單

- [ ] 所有 N/A 已修正
- [ ] 所有文法錯誤已修正
- [ ] RAM/儲存錯誤已修正
- [ ] 轉折詞重複已變化
- [ ] 通用名稱已替換
- [ ] 結構流暢度已檢查
- [ ] 語氣自然度已改善
- [ ] 技術資訊一致
- [ ] 文字中無任何誇飾/禁用詞

---

## 📊 統計資料

- **關鍵錯誤:** X
- **流暢度問題:** Y
- **語氣問題:** Z
- **偵測到的錯誤總數:** X+Y+Z
- **修正總數:** X+Y+Z

步驟 4:套用修正

代理必須:

  1. 讀取產生的修正報告
  2. 針對每一項列出的修正:
    • 在原始檔案中定位確切的 oldString
    • 使用 edit 搭配 oldString/newString
    • 確認修正已套用
  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 次「此外」重複
- 4 個「[主詞],[產品]」結構

步驟 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.

相關技能