# task-746.1 완료 보고서: 스킬 트리거 충돌 정비 (issue-025)

## SCQA

**S**: 47개 스킬 중 HIGH 충돌 4건, 완전 중복 1쌍, YAML frontmatter 미비 11개가 task-744.1 스캔에서 발견되었다.

**C**: 트리거 키워드가 중복되면 잘못된 스킬이 활성화되어 사용자 경험이 저하되고, YAML frontmatter가 없으면 스킬 자동 검색/매칭이 불가능하다.

**Q**: HIGH 충돌 4건 전부 해결하고, 모든 스킬에 YAML frontmatter를 추가할 수 있는가?

**A**: 4건 모두 해결 완료. conversion-copywriter를 DEPRECATED 처리하고 copywriting-prompt로 통합, human-writer에서 book-writer 전용 키워드 제거, blog-dominance에 블로그 특화 YAML 추가 및 NOT for 제외 명시. 11개 NO_YAML 스킬 전부 frontmatter 추가. 47/47 스킬 YAML 파싱 OK.

## 작업 내용

### 1. 완전 중복 통합: conversion-copywriter + copywriting-prompt
- conversion-copywriter → DEPRECATED 처리 (디렉토리 유지, SKILL.md에 리다이렉트 표기)
- copywriting-prompt → CRO 전환 최적화 특화 스킬로 YAML frontmatter 추가
- NOT for 절로 copywriting(일반 카피)과 분리

### 2. book-writer vs human-writer 트리거 분리
- human-writer description에서 "집필", "챕터", "원고" 키워드 제거
- "book-writer 보조 스킬" 역할 명시
- NOT for 절로 "집필, 챕터 작성, 원고 작업 → book-writer" 명시

### 3. SEO 3중 경합 해결
- blog-dominance: YAML frontmatter 추가, "블로그 SEO" 특화 키워드로 한정
- NOT for 절: "SEO 감사/진단(→ seo-audit), 대규모 템플릿 페이지(→ programmatic-seo)" 제외 명시
- seo-audit, programmatic-seo: 기존 description 유지 (이미 분리됨)

### 4. 카피라이팅 3중 경합 해결
- conversion-copywriter DEPRECATED → 3중 → 2중으로 축소
- copywriting = 일반 웹 페이지 마케팅 카피 (기존 유지)
- copywriting-prompt = 전환 최적화 특화 (CTA, 전환율, A/B 테스트, 후킹)

### 5. YAML frontmatter 없는 스킬 일괄 추가 (11개)
- advanced-crawling, blog-dominance, competitor-analyst, conversion-copywriter, copywriting-prompt, fullstack-builder, insight-extractor, marketing-strategist, research-prompt, strategy-prompt, thread-architect

## 수정 파일 목록

- `/home/jay/.claude/skills/conversion-copywriter/SKILL.md` — DEPRECATED 교체
- `/home/jay/.claude/skills/copywriting-prompt/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/human-writer/SKILL.md` — description 수정 (hardlink 없음, 메인만)
- `/home/jay/.claude/skills/blog-dominance/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/advanced-crawling/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/competitor-analyst/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/fullstack-builder/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/insight-extractor/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/marketing-strategist/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/research-prompt/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/strategy-prompt/SKILL.md` — YAML frontmatter 추가
- `/home/jay/.claude/skills/thread-architect/SKILL.md` — YAML frontmatter 추가

## 하드링크 동기화 확인
- book-writer: HARDLINK (inode 2100732) — 메인 수정 불필요 (description 변경 없음)
- copywriting: HARDLINK (inode 1225242) — 메인 수정 불필요 (description 변경 없음)
- seo-audit: HARDLINK (inode 1225217) — 메인 수정 불필요 (description 변경 없음)
- programmatic-seo: HARDLINK (inode 1225210) — 메인 수정 불필요 (description 변경 없음)
- human-writer: 단독 파일 (hardlink 없음)
- 나머지 수정 대상: 단독 파일 (hardlink 없음)

## 검증 결과

### YAML frontmatter 스캔
- 수정 전: HAS_YAML 36/47, NO_YAML 11/47
- 수정 후: HAS_YAML 47/47, NO_YAML 0/47

### YAML 파싱 검증
- 47/47 스킬: description 키 정상 파싱 확인

### 트리거 키워드 충돌 재스캔
- 원래 HIGH 충돌 4건 → 전부 해결
  1. conversion-copywriter + copywriting-prompt 중복 → DEPRECATED 처리 ✅
  2. book-writer vs human-writer 키워드 중복 → human-writer에서 제거 ✅
  3. SEO 3중 경합 → blog-dominance NOT for 절 추가 ✅
  4. 카피라이팅 3중 경합 → DEPRECATED + NOT for 분리 ✅
- 수정 후 HIGH 충돌: 0건 (NOT for 참조/제외 문구에서의 키워드 언급은 실질 충돌 아님)

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **YAML 파싱 검증 방법 이슈** — `yaml.safe_load(open(file))` 방식은 마크다운 frontmatter 파일에서 multi-document 오류 발생. frontmatter 블록(`---` 사이)만 추출하여 파싱하는 방식으로 검증 수행.
2. **키워드 스캔 false positive** — NOT for 제외 절에서 타 스킬명 언급 시 키워드 매칭됨. 이는 실질 충돌이 아닌 참조이므로 false positive로 분류.
3. **copywriting-prompt에 "블로그 SEO" 언급** — NOT for 절에서 blog-dominance 스킬 참조용으로 포함. 실질 트리거 아님.

### 범위 외 미해결 (0건)
없음