speclisted

# Spec - 기능 명세 작성 코드 작성 전에 "무엇을 만들 것인가"를 명확히 정의하는 스킬입니다. ## 사용법 ``` /spec 사용자 프로필 캐싱 # 독립 호출 ``` /dev에서 Phase 1로 자동 호출될 수도 있습니다. > 💡 입력이 흐릿하면 (목표/범위/완료기준이 한 문장으로 안 잡힘) `/deep-interview <요청>`을 먼저 권하세요. 발산-수렴 대화로 명확해진 뒤 `/spec`으로 못 박는 게 효율적입니다. ## pharos 프로토콜 ```bash source "$HOME/.claude/skills/_shared/pharos-helpers.sh" # 시작 (PHAROS_WORKSPACE_ID 미설정 시 wm_*는 exit 1) pw set-status phase "SPEC" --icon "📋" --color "#3B82F6" pw set-progress 0.0 --label "Spec: 시작" wm_append "## Spec: [기능명] Started: [날짜] ---" # 진행: 항목 정의 시마다 progress 갱신 (0.0 → 1.0) # 완료 wm_append "### Spec 완료 ✅ - 목표: ... - 비목표: ... - 성공 기준: ... - 경계 조건: ... ---" pw set-progress 1.0 --label "Spec: 완료" pw notify --title "Spec 완료" --body "[기능명]" # history 기록 (전역 축적) pw history add --type phase --phase spec --summary "SPEC 완료: [기능명]" # 각 결정사항마다: pw history add --type decision --phase spec --summary "[결정 내용]" --tags [D1,키워드] ``` > 📇 **GUI glance 카드 계약**: pharos 메모 패널은 `## 사람용 요약` 섹션과 > `<!-- STEP:N:slug:status -->` 마커를 파싱해(`parseMemoGlance`) 줄글 대신 > 사람용 요약 카드를 띄운다. spec 완료 메모에 `## 사람용 요약`(비기술 한 줄 > 요약)을 포함하면 plan 이전에도 메모가 한눈에 들어온다. ## 프로세스 ### 1. 컨텍스트 수집 사용자의 요청을 분석하고, 필요 시 기존 코드베이스를 탐색하여 관련 컨텍스트를 파악합니다. ```bash # 관련 코드 탐색 pw set-progress 0.1 --label "Spec: 컨텍스트 수집" ``` ### 2. 명세 항목 정의 사용자와 대화하며 다음 항목을 정의합니다: | 항목 | 설명 | 기준 | |------|------|------| | **목표** | 이 기능이 해결하는 문제 | 3문장 이내. 넘으면 쪼개라 | | **비목표** | 명시적으로 범위 밖인 것 | 최소 1개. "안 한다"고 적지 않으면 나중에 범위 확장 | | **성공 기준** | 측정 가능한 완료 조건 | "빨라야 한다" ✗