스킬: 콘텐츠 품질 검증기
설명
이 스킬은 제품 설명 파일(long-.html 및 short-.html)에서 자동으로 품질 오류를 감지하고 상세한 수정 보고서를 생성할 수 있도록 해줍니다. 에이전트는 이 보고서를 활용하여 편집 도구를 통해 수정 사항을 적용합니다.
감지되는 오류 유형
🔴 심각한 오류 (즉시 수정 필요)
-
사양 내 N/A 존재
- 감지: 사양 표와 텍스트에서 "N/A" 검색
- 영향: 품질 기준 위반
-
문법 오류
- "Le cette" → "Cette"로 변경
- "Sa cette" → "Cette"로 변경
- "Les la" → "La"로 변경
- "Ce cet" → "Cet"로 변경
- "Sa la" → "La"로 변경
- 등 (모든 이중 한정사 또는 일치 오류)
-
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 용량을 저장 공간과 혼동하는 모든 오류)
-
기술적 불일치
- 설명문과 표 간의 프로세서 차이
- 상충되는 사양
- 등
-
과장된 표현 및 지나친 최상급 사용 (심각 — V3.2)
- 감지: 정당화되지 않은 마케팅 용어 사용 (예: "incroyable", "révolutionnaire", "séduction fatale", "colossal", "sublime")
- 규칙: 절대 금지. 어조는 순수하게 사실적이고, 차분하며, 고급스러워야 합니다. 금지된 단어가 발견되면 감사 결과는 FAIL입니다.
🟡 유창성 문제 (개선 필요)
-
과도한 연결어 반복
- 섹션당 "De plus" 2회 이상 사용
- 파일 내 "Ensuite" 2회 이상 사용
- 등
-
반복적인 구조
- "[주제], le [제품]..."가 2회 이상 사용
- 연결을 위한 대명사 부족
- 섹션 도입부의 다양성 부족
- 다양한 논리적 연결어 부족 (Par ailleurs, D'ailleurs, À noter 등)
-
문장 리듬 (심각 — AIOSEO)
- 20단어 이상 문장 비율이 25% 초과 (AIOSEO 차단 임계값)
- 10단어 미만의 짧은 문장이 3개 이상 연속
- 문장 길이의 다양성 부족
-
전환어 비율 (심각 — AIOSEO)
- 전환어를 포함한 문장이 30% 미만
- 전환어는 문장의 어느 위치에나 올 수 있음 (처음뿐만 아니라)
🟠 자연스러운 어조 문제 (개선 필요)
-
일반명 사용
- "Le 70", "Le Pro", "Le Pro+", "Le X"
- 전체 제품명 또는 대명사로 대체해야 함
-
상투적인 표현 및 군더더기
- "Avec sa conception..."
- "Grâce à sa technologie..."
- "Doté de..."
- "Le summum de la technologie", "Incroyable", "Révolutionnaire" (일반적인 과장 표현 금지)
- "Le smartphone propose..." (반복되는 경우)
-
동사 다양성 부족
- "dispose de", "possède", "embarque"의 과도한 반복
🔵 이커머스 SEO 오류 (심각 V2.1)
-
비설명적인 메타 타이틀
- 제목에 RAM, 저장 공간, 또는 화면 크기가 누락된 경우
-
주제에서 벗어난 메타 설명
- "SAV" 또는 "Garantie commerciale" 단어 포함
- "Livraison Abidjan" (또는 지역 변형) 언급 누락
-
LSI 키워드 부족
- 목록에 키워드가 10개 미만
- 거래 관련 키워드("prix", "acheter") 대신 정보적 키워드("test", "avis", "comment ça marche") 포함
-
변형 간 복사-붙여넣기 (심각)
- 짧은 설명 섹션의
seo블록이 긴 설명 섹션의seo블록과 동일하거나 거의 동일한 경우. AI가 부정행위를 한 것입니다.
- 짧은 설명 섹션의
사용 절차
1단계: 대상 파일 분석
동작: 분석할 긴 설명 또는 짧은 설명 파일 읽기
명령어: 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" 등의 출현 횟수
- 식별: 반복적인 구조 "[주제], le [제품]"
2.5 일반명 감지
- 검색: "Le 70", "Le Pro", "Le Pro+", "Le X", "Le Mate" 등
- 기록: 전체 제품명을 사용해야 하는 줄
3단계: 감사 보고서 생성 (PASS / FAIL)
다음 정확한 구조로 마크다운 파일을 생성하여 오케스트레이터 또는 제작 에이전트에 반환합니다:
# 📋 품질 관리 보고서 - [제품명]
**파일:** [파일 경로.json 또는 .html]
**감사 상태:** ❌ FAIL (또는 ✅ PASS, 오류가 감지되지 않은 경우)
**에이전트:** content-quality-validator
---
## 🔴 심각한 오류 (필수 수정)
### 1. 이커머스 SEO 오류
| 줄 | 감지된 오류 | 위반 규칙 |
|-------|-----------------|--------------|
| X | RAM이 없는 제목 | 메타 타이틀은 모든 기술 사양을 포함해야 함 |
| Y | "SAV" 단어 포함 | 메타 설명은 오직 Abidjan 배송/품질만 언급해야 함 |
| Z | 키워드 6개 | 최소 10개의 키워드 필요 |
| W | 동일한 SEO | 짧은 설명의 SEO가 긴 설명과 동일함 (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...
### 반복되는 구조
- **"[주제], le [제품]" 패턴이 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단계: 수정 적용
에이전트는 다음을 수행해야 합니다:
- 생성된 수정 보고서 읽기
- 각 수정 항목에 대해:
- 소스 파일에서 정확한 oldString 찾기
edit명령어를 oldString/newString과 함께 사용- 수정이 적용되었는지 확인
- 모든 수정이 완료될 때까지 계속 진행
전체 사용 예시
시나리오: 제품의 긴 설명 파일 수정
1단계: 분석
사용자: "products/huawei-nova-all/nova-13/long-nova-13.html 파일의 품질을 확인해줘"
2단계: 감지
동작: read filePath="products/huawei-nova-all/nova-13/long-nova-13.html"
결과: 다음 오류 감지:
- N/A 1개 (프로세서)
- 문법 오류 0개
- "De plus" 반복 4회
- "[주제], le [제품]" 구조 4회
3단계: 보고서 생성
동작: write filePath="Docs/correction-report-nova-13.md"
내용: oldString/newString이 포함된 구조화된 보고서
4단계: 수정
보고서의 각 항목에 대해:
동작: edit filePath="..." oldString="..." newString="..."
모범 사례
- 보고서를 생성하기 전에 항상 전체 파일을 읽을 것
- 수정을 용이하게 하기 위해 정확한 줄 번호를 기록할 것
- 각 oldString에 대해 맥락(앞/뒤 줄)을 제공할 것
- 유창성 문제보다 심각한 오류를 우선 처리할 것
- 설명문과 사양 표 간의 일관성을 확인할 것
알려진 제한 사항
- 이 스킬은 HTML 레이아웃 오류를 감지하지 않습니다
- 스타일 오류(인라인 스타일)는 여기서 확인되지 않지만, 다른 서식 스킬이나 validate_html_template.py, validate_product_pack.ps1 검증 스크립트를 통해 감지될 수 있습니다
- 자연스러운 어조 감지는 참고용이며 사람의 재검토가 필요합니다
- 연결어 대체 제안은 권장 사항이며 필수 사항이 아닙니다
리소스
- 예시 보고서: 전체 감지 예시는
Docs/rapport_audit_huawei_long_files.md참조 - 서식 스킬: 참조 기준은
PRODUCT_FORMATTING_SKILL.md참조