Skip to main content
ClaudeWave
Skill219 repo starsupdated 6d ago

detail-page-copy

>

Install in Claude Code
Copy
git clone --depth 1 https://github.com/modu-ai/cowork-plugins /tmp/detail-page-copy && cp -r /tmp/detail-page-copy/moai-commerce/skills/detail-page-copy ~/.claude/skills/detail-page-copy
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 상세페이지 카피 (Detail Page Copy)

## 개요

이커머스 고전환 상세페이지를 위한 카피 생성 전문 스킬입니다. **3가지 모드**를 지원합니다:

| 모드 | 플래그 | 설명 | 시연 시점 |
|------|--------|------|----------|
| 기본 (13섹션) | 없음 | 감정여정 13섹션 카피 전체 생성 (기존 하위 호환) | 기존 |
| 진단 | `--mode diagnose` | 현재 상세페이지 7단계 진단 점수 (V6 신규) | Day2 4교시 |
| 페르소나 카피 | `--mode copy` | ⑥⑦ 기반 카피 2세트 생성, 비율 25/50/25 강제 (V6 신규) | Day2 4교시 |

**V6 ↔ MCP 매핑** (SPEC-COMMERCE-V6-003 §5.3): V6 ③ 상세페이지 도구 wrapper.

**MCP 백엔드**: 본 스킬은 MoAI-Commerce MCP Phase 1 (SPEC-COMMERCE-MCP-002)의 ③ 상세페이지 도구를 호출합니다 (`--mode diagnose` 및 `--mode copy` 시). MCP 미출시 시점에는 강사 본인 워크스페이스 사전 녹화 영상 5분으로 시연 대체 (PDF §4 운영 노트 §S4 인용).

지원 카테고리: electronics / fashion / food / beauty / home / supplement / pet / kids / handmade / general

## 트리거 키워드

상세페이지, 상폐, 이커머스 상세페이지, 쇼핑몰 카피, 상품 상세, 제품 상세페이지, 상품 설명 페이지,
detail page, 상세 카피, 온라인 쇼핑몰 상품 페이지, 감정여정 카피, 13섹션 상세페이지,
상세페이지 진단, 상세페이지 점수, 7단계 진단, 페르소나 카피, 카피 2세트, 비율 가이드

---

## V6 신규 모드 워크플로우 (--mode diagnose / --mode copy)

### --mode diagnose: 7단계 진단 점수

현재 상세페이지 URL 또는 캡처 이미지를 입력하면 7단계 기준으로 진단 점수를 산출합니다.

**입력**: 현재 상세페이지 URL 또는 스크린샷 이미지

**7단계 진단 기준**:

| 단계 | 진단 항목 | 배점 |
|------|----------|------|
| 1 | Hero — 10초 내 가치 전달 여부 | 15점 |
| 2 | Pain·Problem — 고객 공감 + 문제 정의 명확성 | 15점 |
| 3 | Solution·How — 솔루션 + 작동 방식 설명 | 15점 |
| 4 | Proof·Authority — 사회적 증거 + 전문성 근거 | 15점 |
| 5 | Benefits — 혜택 구체성 + 차별화 | 10점 |
| 6 | Risk·Compare·Filter — 리스크 제거 + 비교 + 타겟 필터 | 15점 |
| 7 | CTA — 긴급성 + 행동 유도 명확성 | 15점 |

**출력 형식** (--mode diagnose):

```json
{
  "mode": "diagnose",
  "url": "{진단 URL 또는 이미지}",
  "total_score": 67,
  "grade": "B",
  "stages": [
    {"stage": 1, "name": "Hero", "score": 12, "max": 15, "issue": "서브카피 없음", "suggestion": "10초 내 USP 한 줄 추가"},
    {"stage": 2, "name": "Pain·Problem", "score": 8, "max": 15, "issue": "고통점 묘사 추상적", "suggestion": "구체 상황 예시 추가"},
    {"stage": 3, "name": "Solution·How", "score": 13, "max": 15, "issue": "작동 방식 3단계 중 2단계만 있음", "suggestion": "3단계 완성"},
    {"stage": 4, "name": "Proof·Authority", "score": 10, "max": 15, "issue": "리뷰 인용 없음", "suggestion": "실제 구매 리뷰 3개 삽입"},
    {"stage": 5, "name": "Benefits", "score": 7, "max": 10, "issue": "혜택 4개 중 2개 중복", "suggestion": "중복 혜택 제거 후 차별화"},
    {"stage": 6, "name": "Risk·Compare·Filter", "score": 8, "max": 15, "issue": "보증 정책 미표기", "suggestion": "환불 정책 + 비추천 대상 추가"},
    {"stage": 7, "name": "CTA", "score": 9, "max": 15, "issue": "긴급성 요소 없음", "suggestion": "한정 수량 또는 마감일 추가"}
  ],
  "priority_fixes": ["stage4 리뷰 추가", "stage1 서브카피", "stage6 보증 정책"],
  "next_step": "--mode copy 로 개선된 카피 2세트 생성 권장"
}
```

---

### --mode copy: 페르소나 2세트 카피 (비율 25/50/25 강제)

⑥⑦ JTBD·페르소나와 현재 상세페이지를 입력받아 메인·보조 페르소나용 카피 2세트를 생성합니다.

**비율 가이드 강제 적용 (REQ-V6-011 HARD)**:
- 문제·공감 섹션: **25%** (Hero + Pain + Problem)
- 핵심·증명 섹션: **50%** (Solution + How + Proof + Authority + Benefits)
- FAQ·CTA 섹션: **25%** (Risk + Compare + Filter + CTA)

**입력 슬롯** (--mode copy):

| 항목 | 필수 여부 | 예시 |
|------|----------|------|
| ⑥ JTBD 결과 | 필수 | commerce-jtbd-persona --mode jtbd 산출물 |
| ⑦ 페르소나 3명 | 필수 | commerce-jtbd-persona --mode persona 산출물 |
| 현재 상세페이지 | 권장 | URL 또는 --mode diagnose 결과 (개선점 반영) |

**출력 형식** (--mode copy):

```json
{
  "mode": "copy",
  "ratio_guide": "25/50/25",
  "persona_sets": [
    {
      "persona": "메인 (박지연, 32세, 직장인)",
      "jtbd_focus": "F1 — 성분 안전성",
      "sections": {
        "problem_empathy_25pct": {
          "hero": {...},
          "pain": {...},
          "problem": {...}
        },
        "core_proof_50pct": {
          "solution": {...},
          "how": {...},
          "proof": {...},
          "authority": {...},
          "benefits": {...}
        },
        "faq_cta_25pct": {
          "risk": {...},
          "compare": {...},
          "filter": {...},
          "cta": {...}
        }
      }
    },
    {
      "persona": "보조1 (김수현, 27세, 대학원생)",
      "jtbd_focus": "E2 — 클린 라이프스타일",
      "sections": {"...": "..."}
    }
  ],
  "slop_review": {
    "status": "passed",
    "changes_made": 3,
    "notes": "ai-slop-reviewer 검수 완료"
  }
}
```

**ai-slop-reviewer 자동 체이닝 (HARD)**: `--mode copy` 산출물은 모든 카피 생성 이후 `moai-core:ai-slop-reviewer`를 자동 체인합니다.

---

## 기존 모드 (13섹션, 하위 호환 유지)

**플래그 없이 호출 시 기존 13섹션 감정여정 카피 모드가 실행됩니다.** 기존 워크플로우, 출력 형식, ai-slop-reviewer 체이닝 모두 동일하게 유지됩니다.

---

## 카피 품질 가이드 (v2.4.0 신규)

### 좋은 예시 vs 피해야 할 예시 (상세페이지 체크리스트)

#### ✅ 좋은 예시
```
"하루 종일 피곤하고 집중력이 떨어지시나요?
많은 직장인들이 같은 고민을 하고 있습니다.
100% 자연 성분으로 만든 저희 에너지 드링크는
카페인 부작용 없이 6시간 동안 지속되는 활력을 선사합니다."
```
→ **문제 제시 + 공감 + 해결책 + 차별점**을 간결하게 포함. 7단계 구조 1·2·3 단계가 한 흐름.

#### ❌ 피해야 할 예시
```
"최고 품질의 에너지 드링크입니다.
맛있고 효과적입니다.
많은 분들이 구매하셨습니다.
빨리 구매하세요."
```
→ **구체적 증명과 차별점 없이 추상적 문구만 나열**. 7단계 중 어느 단계도 명확히 수행하지 못함.

### PAS 카피 공식 매핑

7단계 구조와 PAS(Problem-Agitate-Solution) 카피 공식의 매핑:

| 7단계 | PAS 매핑 | 심리 전략 |
|------|----------|----------|
| 1. 문제 인식 | **P (Problem)** | 타겟이 이미 인식하는 문제를 그들의 언어로 정확히 묘사. 제품 얘기 금지 |
| 2. 공감 | **A (Agitate)** | 문제를 더 크고 아프게 만듦. "지금 해결 안 하면 어떻게 되는가". **손실 회피 편향** 작동 |
| 3. 핵심 메시지 | **S (Solution) 도입** | 해결책 제시. 기능이 아닌 혜택으로 |
| 4. 증명 | **S 강화** | 사회적 증거로 마무리. 통계·리뷰·전문가 |
| 5. 사용법/혜택 | 가치 방정식 적용 | (얻는 것 - 잃는 것) × 신뢰 |
| 6. FAQ/반론 처리 | 제로 리스크 편향 | "30일 환불 보장" 등 |
| 7. 구매 유도 | 손실 회피 + 앵커링 | 마감·할인·증가 가격 대비 |

### 혜택 언어 3단계 변환법

대부분의 카피가 1단계(기능)에서 멈춤. 3단계까지 가야 정체성 구매 동기 작동.

| 단계 | 변환 결과 | 예시 (방수 소재) |
|------|----------|-----------------|
| **1단계 — 기능의 직접 결과** | 제품 → 무엇을 할 수 있나 | 방수 소재 → **비에 안 젖는다** |
| **2단계 — 결과의 변화** | 결과 → 일상에서 무엇이 바뀌나 | 비에 안 젖는다 → **우산 챙기는 걱정이 사라진다** |
| **3단계 — 변화의 감정 (정체성)** | 변화 → 어떤 사람이 되는 느낌 | 걱정이 사라진다 → **비 오는 날도 가볍게 나가는 사람이 된 느낌** |

> **고객 후기에서 언어를 훔쳐라**: "허리 통증이 사라졌어요"보다 "아침에 일어날 때 더 이상 인상 안 쓰게 됐어요"가 더 강한 혜택 언어. 고객이 실제로 쓴 말이 가장 공명이 강함.

### 카피 작성 체크리스트 (7단계 통합)

각 단계 카피 생성 후 자체 검수:

- [ ] **1·2단계** (25%): 고객 문제를 그들의 언어로 정확히 묘사 + 공감
- [ ] **3·4·5단계** (50%): 차별점 강조 + 구체적 증명(데이터·후기·성분) + 혜택 3단계 변환
- [ ] **6·7단계** (25%): 예상 질문 답변 + CTA 명확 + 긴급성·앵커링
- [ ] **PAS 흐름** 확인 (Problem 명확 → Agitate 강화 → Solution 도출)
- [ ] **혜택 언어 3단계** 변환 완료 (기능 → 변화 → 감정)
- [ ] **금지 표현 회피**: "최고 품질·맛있고