Community编程与开发github.com

验证器:内容质量

自动检测产品描述文件中的质量问题(AIOSEO 合规性、句子长度、SKU、禁用风格),用于 QA 审计关口 /audit-product-pack。

验证器:内容质量 是什么?

该技能用于自动检测产品描述文件(long-*.html 和 short-*.html)中的质量问题,并生成详细的修正报告。代理将根据该报告通过编辑工具应用修正。它能够检测多种错误类型:关键错误(如 N/A 值、语法错误、RAM/存储混淆、技术不一致、过度夸张用语)、流畅性问题(过渡词重复、句子节奏、转换率)、自然语气问题(泛称、套话、动词单调)以及 SEO 电商错误(元标题/描述不合格、LSI 关键词不足、变体间 SEO 复制粘贴)。该技能支持任何基于 LLM 的代理(如 Claude Code、Cursor、Codex),工作流程包括:读取目标文件、按类型检测错误、生成结构化审计报告(PASS/FAIL)、并逐步应用 oldString/newString 修正。它特别强调 AIOSEO 规则(如 20 词句子阈值、30% 转换率)以及产品包装格式标准。

兼容平台✓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 的新对话。

文档

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 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)

    • 超过 25% 的句子包含超过 20 个单词(AIOSEO 阻止门槛)
    • 连续超过 3 个短句(少于 10 个单词)
    • 句子长度缺少变化
  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 电商错误(关键 V2.1)

  1. Meta Title 不具有描述性

    • 标题中缺少 RAM、存储或屏幕尺寸。
  2. Meta Description 离题

    • 包含“SAV”或“Garantie commerciale”字样。
    • 缺少“Livraison Abidjan”(或当地变体)的提及。
  3. LSI 关键词不足

    • 列表中少于 10 个关键词。
    • 包含信息性关键词(“test”、“avis”、“comment ça marche”)而非交易性关键词(“prix”、“acheter”)。
  4. 变体间复制粘贴(关键)

    • Short 部分的 seo 块与 Long 部分的 seo 块完全相同或几乎相同。IA 作弊。

使用流程

第 1 步:分析目标文件

动作:读取要分析的 long 或 short 文件
命令:read
参数:要检查的文件路径

第 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)

创建一个 markdown 文件,使用以下精确结构,该文件将返回给编排器或生产代理:

# 📋 质量控制报告 - [产品名称]
**文件:** [路径/至/文件.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 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
    • 使用 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 次“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.

相关技能