simon-oncall

simon-oncall

온콜 문의 분석 스킬. 슬랙으로 들어온 기술 문의를 파악하고, 관련 코드와 사내 자료를 심층 분석(simon-study) → 원인/해결 방향 → 슬랙 답변 초안까지 제공합니다.

자율주행모드 ON 입니다. 여러 Agent와 병행하여 딥하게 조사해주세요. 이 선언은 CLAUDE.md의 모호성 확인 규칙보다 우선한다 — 분석 진행 중 세부 모호함은 스스로 판단해 진행한다. 단, 분석 대상 자체(코드/레포/질문)가 특정되지 않는 수준의 모호함은 시작 전 1회만 확인한다.

Why this exists

온콜 문의는 대부분 "이거 왜 이런 거야?", "이게 현재 가능할까요?" 형태입니다. 좋은 답변을 하려면 슬랙 맥락 파악 → 최신 코드 분석 → 사내 문서/논의 검색 → 종합 판단이 필요한데, 이 과정을 체계적으로 수행합니다.

Input

사용자가 제공하는 것:

1. 슬랙 URL — 온콜 문의 메시지 (buzzvil.slack.com)
2. 레포 이름 (선택) — 관련 서비스의 레포지토리 (~/buzzvil/{repo_name}에 위치)

슬랙 URL이 빠져 있으면 요청합니다. 레포 이름이 빠져 있으면 references/repo-map.md를 참조하여 문의 키워드로 관련 레포를 추천합니다. 추천이 명확하지 않을 때만 사용자에게 확인합니다.

Instructions

진행 체크포인트: 각 Phase 경계에서 1줄 진행 보고를 출력한다 — [Phase N 완료] {핵심 결과 요약} — Phase N+1 시작 형식. 장시간 무응답 구간에서 사용자가 진행 상태를 알 수 있게 한다 (AskUserQuestion 아님, 단순 텍스트).

Phase 1: 문의 파악

슬랙 스레드를 읽고 문의의 핵심을 파악합니다.

~/.claude/skills/buzzvil-slack/scripts/fetch_thread.sh "{slack_url}" --resolve-users

단일 메시지(스레드 없음)라면:

~/.claude/skills/buzzvil-slack/scripts/fetch_message.sh "{slack_url}"

스레드에서 추출할 것:

• 문의자: 누가 물어봤는가
• 핵심 질문: 한 문장으로 요약
• 문의 유형:
  • ERROR — 에러/장애 ("왜 500이 나와요?", "이거 깨졌어요")
  • DATA_ANOMALY — 데이터 이상 ("수치가 이상해요", "왜 0이 나오지?")
  • LOGIC_INQUIRY — 로직/동작 질문 ("이 로직이 왜 이렇게 동작해요?")
  • CAPABILITY — 기능 가능 여부 ("이런 게 가능할까요?")
• 추가 맥락: 이미 논의된 내용, 첨부 스크린샷/로그, 언급된 키워드

사용자에게 파악한 내용을 간단히 확인합니다:

"문의 내용을 이렇게 이해했습니다: [요약]. 맞나요?"

Phase 1.5: 레포 특정

사용자가 레포를 명시하지 않았으면 references/repo-map.md를 읽고, Phase 1에서 파악한 키워드와 대조하여 관련 레포를 특정합니다.

• 매핑이 명확하면 (1개 레포로 좁혀지면) 바로 진행하고 사용자에게 알림: "관련 레포로 {repo_name}을 선택했습니다"
• 후보가 2-3개면 사용자에게 선택지 제시: "A, B, C 중 어디를 먼저 볼까요?"
• 로컬에 레포가 없으면 클론: gh repo clone Buzzvil/{repo_name} ~/buzzvil/{repo_name} -- --depth 1

Phase 2: 레포 준비

최신 master(또는 main) 브랜치 기준으로 분석해야 합니다.

cd ~/buzzvil/{repo_name}
git fetch origin
# master 우선, 없으면 main
git checkout master 2>/dev/null || git checkout main
git pull origin $(git branch --show-current)