| name | sentry-triage |
| description | Sentry 이슈·유저 피드백을 조회하고 5단계 라벨(🔥 즉시 수정 / 📝 이슈 등록 / 👀 관찰 / 🚫 무시 / 💡 기능 요청)로 분류한 뒤 승인 게이트를 거쳐 GH 이슈 생성·Sentry 태그 부착 등 후속 액션을 자동화한다. 사용자가 "sentry 확인", "트리아지", "센트리 봐줘" 등을 말하거나 /sentry-triage 커맨드가 호출될 때 활성화한다. |
Sentry Triage 스킬
목적
Sentry의 unresolved 이슈와 User Feedback을 트리아지 프레임워크로 분류·조치한다. 단순 조회가 아니라 각 항목에 우선순위 라벨을 추천하고, 사용자 승인 후 GH 이슈 생성 / Sentry 태그 부착 / archive 추천을 수행한다.
전제 조건
amang-sentry MCP 연결됨 (org: amang-23, projects: web, api)gh CLI 인증됨 (skku-amang/main 접근 권한)- 레포 라벨 체계가 새 prefix 방식으로 설정되어 있어야 함:
kind:*, priority:*, from:*. 라벨 정의는 CONTRIBUTING.md의 "라벨 매니페스트" 섹션 참고
실행 흐름
1. 조회 (Collector)
기본 파라미터:
- 프로젝트:
web, api
- 환경:
production
- 상태:
unresolved
- 기간: 최근 7일
사용자가 인자로 오버라이드 가능 (예: "dev 환경 14일치"). 파라미터를 파싱해 조회 범위 조정.
두 번 호출 — 에러 이슈와 User Feedback은 별도 쿼리:
- 에러 이슈:
list_issues(query="is:unresolved environment:production lastSeen:-7d")
- User Feedback:
list_issues(query="issue.category:feedback is:unresolved")
- Sentry가 Feedback Widget 제출을
category=feedback 이슈로 저장하므로 list_events가 아닌 list_issues로 조회
- 환경·기간 필터는 필요에 따라 추가
두 결과를 합쳐 단일 큐로 처리. Classifier는 항목의 category가 feedback이면 먼저 💡 기능 요청 기준 검사 → 버그면 일반 플로우로 분기.
각 항목에 대해 수집:
- ID, 제목, 영향 유저 수, 이벤트 수, first_seen, last_seen
- tags: url, browser, environment, release
- 에러의 경우: 메시지, 스택트레이스 상위 10줄
- User Feedback의 경우:
event.contexts.feedback.message 필드(= 유저가 입력한 원문)를 사용. 이슈 description 필드는 Sentry가 AI로 자동 생성한 영문 요약이므로 분류·제목 용도로 쓰지 말 것. 원문은 대부분 한국어
🌐 언어 주의
amang 유저 피드백은 거의 한국어. AI 자동 요약 영문 title에 휘둘리지 말고 feedback.message 원문 기준으로:
- 분류(💡 vs 📝) 판단
- GH 이슈 제목 생성 시 원문 그대로 (또는 원문 요약) 사용 — 유저 목소리 번역 손실 방지
2. 자동 분류 (Classifier)
triage-criteria.md의 기준을 우선순위대로 적용:
- 🔥 즉시 수정 기준 매치 검사
- 🚫 무시 기준 매치 검사
- 💡 기능 요청 기준 검사 (User Feedback일 때만)
- 📝 이슈 등록 기준 검사
- 나머지는 👀 관찰
각 분류에 **근거(어떤 시그널을 봤는지)**를 2-3줄로 첨부.
3. 사용자 검토
5개 섹션으로 묶어 테이블·리스트 출력 (아래 "출력 형식" 참조). 사용자는 이 시점에 라벨 수정 지시 가능:
- "3번은 관찰로 바꿔"
- "💡의 2번은 Notion 대신 GH 이슈로"
4. 액션 실행 (Actor, 항목별 승인 게이트)
각 항목마다 [y/n/s] 프롬프트 (y=실행 / n=건너뜀 / s=skip all). 승인받은 항목만 실행.
| 라벨 | 액션 |
|---|
| 🔥 | gh issue create — kind: bug + priority: critical + from: sentry 또는 from: user-feedback. body는 .github/ISSUE_TEMPLATE/sentry_auto.md 적용. 제목은 자연어 (CC 포맷 금지) |
| 📝 | gh issue create — kind: bug + priority: high(영향 유저 ≥3) 또는 priority: low + from:* |
| 👀 | 별도 액션 없음 — Sentry는 unresolved 상태 유지. 다음 트리아지 라운드에 자연스레 다시 검토됨. (선택: 코멘트로 "observing - 다음 라운드 재평가" 추적 메모) |
| 🚫 | 출력만 — "Sentry 웹에서 Archive 권장" 메시지. 자동 실행 안 함 |
| 💡 | 사용자에게 대상 선택 프롬프트 (g=GH 이슈 / n=Notion / s=건너뜀). GH면 kind: enhancement + from: user-feedback + priority: low. Notion이면 amang-notion MCP로 아이디어 DB에 row 추가 |
5. 종료 요약
요약: 처리 완료 N건 / 보류 M건 / 실패 K건
- 🔥 N1건 → GH 이슈 #AAA, #BBB 생성됨
- 📝 N2건 → GH 이슈 #CCC~#DDD 생성됨
- 👀 N3건 → 액션 없음 (다음 라운드 재검토)
- 🚫 N4건 → 수동 archive 권장 목록 (링크)
- 💡 N5건 → GH N개, Notion N개
출력 형식
## Sentry Triage (YYYY-MM-DD)
조회: web + api / prod / 7d / unresolved — 총 N건
### 🔥 즉시 수정 (N건)
1. [TypeError: Cannot read 'user' of undefined](sentry-link)
- 영향: 12명 / 최근 24h 3배 증가
- 근거: 유저 5명↑ + `login` 키워드 매치
- [y/n/s] GH 이슈 생성 (`kind: bug`, `priority: critical`, `from: sentry`)
### 📝 이슈 등록 (N건)
...
### 👀 관찰 (N건)
...
### 🚫 무시 추천 (N건)
...
### 💡 기능 요청 (N건)
1. "예약 목록을 엑셀로 내보낼 수 있었으면 좋겠어요" ([feedback link])
- [g/n/s] g=GH 이슈 / n=Notion DB / s=건너뜀
에러 처리
- MCP 연결 실패: 즉시 중단, 사용자에게 원인 표시. fallback 없음.
- GH 이슈 생성 실패: 해당 항목만 실패 표시하고 계속 진행.
- 라벨 부재:
kind: bug 등이 레포에 없을 경우 "라벨 체계가 설정되지 않았습니다. CONTRIBUTING.md의 라벨 매니페스트를 참고하여 레포에 라벨을 생성하세요." 안내 후 중단.
- 분류 판단 불가: 👀(관찰)로 fallback.
드라이런 모드
사용자가 "드라이런으로", "--dry-run", "실제 실행 안 하고"를 지정하면 Actor 층의 side effect 대신 "다음 작업을 수행할 예정:" 출력만. 드라이런에서는 승인 프롬프트 생략.
기준 조정
분류 결과가 사용자 판단과 자주 어긋나면 triage-criteria.md "조정 이력" 섹션에 케이스 기록 + 규칙 수정. 스킬 사용하며 진화시키는 문서.
