/solve - 문제 해결

체계적 문제 분석 및 해결

Data Flow Contract

Input (스킬 간 데이터 수신)

소스	데이터	용도
`/dev --build`	빌드 오류 로그	빌드 실패 시 에스컬레이션
QA 실패	테스트 실패 로그	QA 실패 시 에스컬레이션

Output (스킬 간 데이터 전달)

단계	산출물	다음 스킬 Input
분석	`.claude/problem-solving/active/{id}/analysis.md`	수정 단계
해결	`.claude/problem-solving/resolved/{id}/report.md`	`/dev --plan` (기능 전환 시)
지식베이스	`.claude/problem-solving/knowledge-base/solutions.json`	유사 문제 검색

State Update

•.claude/problem-solving/active/ → resolved/ 이동
•.claude/problem-solving/knowledge-base/solutions.json 패턴 등록

사용법

bash

/solve "문제 설명"           # 기본 문제 해결
/solve --5whys "문제"        # 5 Whys 기법
/solve --rca "문제"          # Root Cause Analysis
/solve --hypothesis "문제"   # 가설 기반 접근
/solve --log                 # 진행 상황
/solve --report              # 보고서 생성

에이전트 호출 (필수)

⚠️ 이 스킬이 로드되면 아래 지침을 따라 Task 도구를 호출하세요.

1. 탐색 단계

python

Task(
    subagent_type="Explore",
    description="문제 관련 코드 탐색",
    prompt="... (references/explore.md 참조)"
)

2. 분석 단계

Routing: references/analyze.md 참조

python

Task(
    subagent_type="calab-plugin:root-cause-finder",
    description="근본 원인 분석",
    prompt="... (references/analyze.md 참조)"
)

산출물 필수: .claude/problem-solving/active/{id}/analysis.md

3. 수정 단계

Routing: references/fix.md 참조

python

Task(
    subagent_type="calab-plugin:bug-fixer",
    description="TDD 기반 버그 수정",
    prompt="... (references/fix.md 참조)"
)

산출물 필수: .claude/problem-solving/resolved/{id}/fix-report.md

4. 검증 단계

python

Task(
    subagent_type="calab-plugin:validator",
    description="해결 검증",
    prompt="..."
)

산출물 필수: .claude/problem-solving/resolved/{id}/validation-report.md

검증/보강 체인 (필수)

mermaid

graph TD
    ANALYZE["분석 (root-cause-finder)"] --> FIX["수정 (bug-fixer)"]
    FIX --> VALIDATE["검증 (validator)"]
    VALIDATE -->|성공| KB["지식베이스 등록"]
    VALIDATE -->|실패| REINFORCE["reinforcer"]
    REINFORCE --> REVALIDATE["재검증 (validator)"]
    REVALIDATE -->|성공| KB

6단계 프로세스

code

1. 문제 정의 (Define)     → problem.md
2. 정보 수집 (Gather)     → Git 로그, 파일 분석
3. 원인 분석 (Analyze)    → 5whys/RCA/Hypothesis
4. 가설 검증 (Hypothesize)→ 예측→검증→결과
5. 해결 구현 (Solve)      → TDD 기반 수정
6. 문서화 (Document)      → 지식 베이스 등록

분석 기법

기법	옵션	설명
5 Whys	`--5whys`	"왜?"를 5번 반복
RCA	`--rca`	8단계 체계적 분석
가설 검증	`--hypothesis`	가설→예측→검증 사이클
Binary Search	`--binary`	이진 탐색으로 위치 좁히기

/dev 전환 기준

상황	액션
단순 버그 수정	solve 내에서 해결
새 기능 필요	`/dev --plan` 전환
설계 변경 필요	`/dev --design` 전환
3개+ 모듈 영향	`/dev --design` 전환

레퍼런스 라우팅

옵션	참조 파일
`--5whys`	`references/5whys.md`
`--rca`	`references/rca.md`
`--hypothesis`	`references/hypothesis.md`
`--log`	`references/log.md`
`--report`	`references/report.md`

파일 구조

code

.claude/problem-solving/
├── active/{problem-id}/
│   ├── problem.md
│   ├── analysis.md
│   └── hypotheses.md
├── resolved/{problem-id}/
│   └── report.md
└── knowledge-base/
    └── solutions.json

다음 단계 선택 (필수)

⚠️ 작업 완료 후 반드시 AskUserQuestion 호출

문제 해결이 완료되면 현재 상황을 분석하여 AskUserQuestion으로 다음 단계 선택지를 제시하세요.

•해결된 문제 요약

•새 기능 개발 필요 여부 (권장 표시)

•보고서 작성 옵션

•추가 문제 분석 옵션

•종료 옵션