# task-630.1: swing-skills 4종 설치 + 시스템 통합

## SCQA

**S (현황)**: task-627.1에서 whynowlab/swing-skills 6종을 분석하여 충돌 없는 4종(swing-trace, swing-mortem, swing-clarify, swing-options)의 설치를 권고받은 상태였다. 기존 시스템은 43종 스킬을 운영 중이며, 추론 투명성(swing-trace)과 사전 실패 분석(swing-mortem)은 명시적 스킬이 없었다.

**C (문제)**: 권고된 4종을 설치하고, 설치 금지된 2종(swing-research, swing-review)의 장점을 기존 스킬(cross-verified-research, adversarial-review)에 흡수해야 하며, 신규 스킬의 사용 방법과 기존 시스템과의 연동 가이드가 부재했다.

**Q (질문)**: 4종을 설치하고 기존 48종 스킬 체계와 충돌 없이 통합할 수 있는가?

**A (답변)**: 4종 설치 완료(43→47종), 트리거 충돌 0건(exact match 기준), YAML 프론트매터 유효성 6개 파일 전수 통과. cross-verified-research에 scaled effort + quality calibration, adversarial-review에 verdict criteria + specialized modes를 추가 완료. 학습 문서 249행 작성하여 사용 가이드와 통합 파이프라인을 정리했다.

---

## 작업 내용

### 1. 설치 (4종)
- `npx skills add whynowlab/swing-skills --skill <name> --yes`로 순차 설치
- swing-trace → swing-mortem → swing-clarify → swing-options 순서

설치 확인:
- `~/.claude/skills/swing-trace/SKILL.md` (351행)
- `~/.claude/skills/swing-mortem/SKILL.md` (409행)
- `~/.claude/skills/swing-clarify/SKILL.md` (195행)
- `~/.claude/skills/swing-options/SKILL.md` (222행)
- 4종 모두 `~/.agents/skills/` → `~/.claude/skills/` 심링크 정상

설치 금지 스킬 미설치 확인:
- swing-research: 미설치 ✓
- swing-review: 미설치 ✓

### 2. 학습 문서 작성
- 경로: `/home/jay/workspace/memory/research/swing-skills-learned.md` (249행)
- 스킬별: 핵심 프로세스, 트리거 조건, 출력 포맷, 우리 시스템 활용 가이드
- swing-trace: deep-dive-analyzer → swing-trace → adversarial-review 파이프라인 정리
- swing-mortem: pdp-agent Risk Phase와의 역할 경계 문서화 (pdp-agent risk.md 실제 확인)
  - pdp-agent: 도입 여부 결정(Go/No-Go), LOW~CRITICAL 4단계 판정
  - swing-mortem: 5카테고리 심층 분석 + 측정 가능 지표 + circuit breaker
  - 호출 포인트: pdp-agent Phase 2(Risk) → 고위험 항목 발견 시 swing-mortem 위임
- 통합 파이프라인 4가지 조합 정의

### 3. 기존 스킬 수정

#### cross-verified-research SKILL.md (v1.0→v1.1)
- Scaled Effort 섹션 추가 (83-95행): 좁은 사실 2-3회 / 기술 비교 5회(기본값) / 광범위 8회+
- Quality Calibration 섹션 추가 (210-251행): BAD/GOOD 예시 with 구체적 문제점 명시
- 기존 "최소 5회 검색 + 5개 소스" 규칙 유지 (Scaled Effort는 보조 가이드)
- 257행 (원본 199행, +58행)

#### adversarial-review SKILL.md (v1.0→v1.1)
- Stage 5 Verdict 추가 (118-135행): FAIL/PASS WITH CONDITIONS/PASS 판정 기준
- Specialized Modes 추가 (179-206행): 코드 리뷰 / 아키텍처 결정 / PR 리뷰 모드
- 231행 (원본 184행, +47행)

### 4. 검증

#### YAML 프론트매터 유효성: 6개 파일 전수 PASS
- 신규 4종 + 수정 2종 모두 `---` 구분자 정상, name/description 필드 존재

#### 트리거 충돌 검사: PASS (exact match 기준 충돌 0건)
- 주의 사항: pdp-agent "리스크 체크" vs swing-mortem "리스크" — substring 포함 관계 존재
- pdp-agent은 `triggers:` 배열 방식, swing-mortem은 `description` 내 embedded 방식으로 트리거 레이어가 다름
- 실사용에서는 사용자 입력이 "리스크 분석해줘" vs "리스크 체크해줘"로 구분되므로 실질 충돌 가능성 낮음

#### 스킬 총 수: 47종 (기존 43종 + 신규 4종)
- task-627.1에서 "44종"이라 언급했으나, 현재 기존 스킬은 43종으로 확인됨 (1종 차이는 본 작업 범위 외)

---

## 생성/수정 파일 목록

**생성 파일:**
- `/home/jay/workspace/memory/research/swing-skills-learned.md` (249행)

**수정 파일:**
- `~/.claude/skills/cross-verified-research/SKILL.md` (199→257행, v1.0→v1.1)
- `~/.claude/skills/adversarial-review/SKILL.md` (184→231행, v1.0→v1.1)

**설치 파일 (외부 패키지):**
- `~/.claude/skills/swing-trace/SKILL.md` (351행)
- `~/.claude/skills/swing-mortem/SKILL.md` (409행)
- `~/.claude/skills/swing-clarify/SKILL.md` (195행)
- `~/.claude/skills/swing-options/SKILL.md` (222행)

---

## 셀프 QC

### 체크리스트
- [x] 1. 영향 파일: cross-verified-research, adversarial-review SKILL.md 수정 — 추가만 수행, 기존 내용 삭제 없음
- [x] 2. 엣지 케이스: pdp-agent "리스크 체크" vs swing-mortem "리스크" substring 관계 식별 → 보고서에 명시
- [x] 3. 작업 지시 일치: 4종 설치, 학습 문서, 기존 스킬 수정, 검증 — 모두 완료
- [x] 4. 에러/보안: 해당 없음 (스킬 파일 수정, 코드 변경 없음)
- [x] 5. 테스트 커버리지: 해당 없음 (Lv.1 문서 작업)
- [x] 6. 발견 이슈 직접 해결: 아래 참조

### 발견 이슈 및 해결

#### 자체 해결 (3건)
1. **npx skills 인터랙티브 프롬프트** — `--yes` 플래그 추가로 해결
2. **스킬 총 수 불일치 (44→43종)** — task-627.1 보고서 대비 1종 차이 확인. 본 작업 범위 외이므로 보고서에 명시만 수행
3. **pdp-agent "리스크 체크" vs swing-mortem "리스크" 트리거 substring 관계** — 트리거 레이어 차이(triggers 배열 vs description embedded)와 실사용 문맥 차이로 실질 충돌 가능성 낮음을 확인. 보고서에 명시하되 즉각 수정 불필요 판단

---

## QC 자동 검증

- 실행: `qc_verify.py --gate --task-id task-630.1 --skip api_health`
- **결과: PASS (3 PASS, 7 SKIP)**
- file_check: PASS — 보고서 5,833 bytes 확인
- data_integrity: PASS — task-timers.json 정합성 확인
- critical_gap: PASS — CRITICAL 이슈 1건 해결 확인
- test_runner/tdd_check/pyright_check/style_check/scope_check/schema_contract: SKIP (Lv.1 문서 작업, 코드 변경 없음)
- .done 파일 자동 생성: `/home/jay/workspace/memory/events/task-630.1.done`