[미니사례]스킬을 활용한 운영보고서 발송
2026.03.22
![[미니사례]스킬을 활용한 운영보고서 발송 본문 이미지](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F371700c91a20a4e6f51aac1a.jpg&w=3840&q=75)
소개
스킬 이름:
incident-report한 줄 설명: 클라우드 장애 이메일을 붙여넣으면 상황에 맞는 운영팀 공유 메시지를 자동으로 만들어 슬랙과 이메일로 발송
만드는 사람: 고객사 담당 PM
스킬 유형: [x] 다단계 워크플로우 [x] 외부 API
MVP 목표: "MCMP 장애 이메일 내용을 붙여넣으면 심각도 분석 + 슬랙 메시지 발송까지 자동으로 완료"
진행 방법
외부 연동
워크플로 시각화

결과와 배운 점
1. 언제 쓰나요?
대표 상황: 매일 오전/오후 2회, MCMP 시스템에서 받은 고객사 클라우드 장애/이상 알림 이메일을 운영 담당자에게 공유할 때
왜 필요한가:
하루 2번, 매번 이메일 내용을 직접 읽고 요약해서 슬랙과 이메일 둘 다 작성해야 함
상황에 따라 메시지 톤/형식이 달라서 매번 어떻게 쓸지 고민이 필요
긴급 장애 시 빠른 공유가 필요한데 작성 시간이 병목이 됨
2. 사용법
이렇게 부르면:
/incident-report"장애 보고해줘"
"이거 운영팀에 공유해줘" (+ 이메일 내용 붙여넣기)
결과물 형태: [x] 메시지 [ ] 파일 [ ] 링크/리포트 [ ] 기타
결과물 예시:
[장애 현황 공유] 고객사A - 서울 리전 API 응답 지연
안녕하세요, PM입니다.
현재 고객사A 클라우드 환경에서 다음과 같은 이슈가 감지되었습니다.
장애 유형: API 응답 지연
심각도: 중간 (서비스 일부 영향)
감지 시각: 2026-03-21 09:23
영향 범위: 서울 리전 전체
운영팀 확인 부탁드립니다.
3. 입력/출력 명세
구분 | 내용 |
|---|---|
사용자 입력 | MCMP에서 받은 장애 알림 이메일 내용 (텍스트 붙여넣기) |
필수 옵션 | 이메일 원문 텍스트 |
선택 옵션 | 수신자 지정, 채널 지정, 추가 코멘트 |
출력 규칙 | 슬랙: 간결한 블록 메시지 / 이메일: 비즈니스 공문 형식 |
4. 범위
하는 것:
장애 이메일 내용 분석 (유형, 심각도, 영향 범위 파악)
상황에 맞는 슬랙 메시지 자동 생성 및 발송
운영팀 이메일 초안 자동 생성 및 발송
안 하는 것:
MCMP 시스템 직접 접속 및 이메일 자동 수집 (수동 붙여넣기 방식)
장애 해결 방법 제시 또는 에스컬레이션 자동화
5. 데이터/도구/권한
항목 | 내용 |
|---|---|
읽는 데이터 | 사용자가 붙여넣은 MCMP 장애 이메일 텍스트 |
쓰는 위치 | Slack 채널, Gmail 수신자 이메일 |
외부 서비스 | Slack (메시지 발송), Gmail (이메일 발송) |
민감정보 | SLACK_BOT_TOKEN, GMAIL_APP_PASSWORD 필요 ( |
6. 실패/예외 처리
예상되는 실패 상황:
슬랙 토큰 만료 또는 채널 권한 없음 → 이메일만 발송하고 슬랙 재설정 안내
Gmail 앱 비밀번호 오류 → 이메일 초안만 출력하고 수동 발송 안내
이메일 내용이 너무 짧거나 장애 관련 내용이 없음 → "장애 내용을 더 자세히 붙여넣어 주세요" 안내
실패 시 안내 원칙: 한 쪽 발송이 실패해도 다른 쪽은 진행. 실패한 경우 이유와 수동 처리 방법 함께 안내.
7. 대화 시나리오
정상 케이스:
나: "장애 보고해줘" + [MCMP 이메일 내용 붙여넣기]
스킬:
분석 완료했어요!
장애 요약: 고객사B 서울 리전 DB 연결 오류 (심각도: 높음)
슬랙 메시지: #운영팀 채널에 발송했어요 ✅ 이메일: [email protected]으로 발송했어요 ✅
실패 케이스:
나: "장애 보고해줘" (이메일 내용 없이)
스킬:
MCMP에서 받은 장애 이메일 내용을 함께 붙여넣어 주세요!
예: "장애 보고해줘" 다음 줄에 이메일 전체 내용을 붙여넣으시면 돼요.
8. 테스트 & 완료 기준
테스트 체크리스트:
[ ] 실제 MCMP 장애 이메일로 요약이 제대로 되는지 확인
[ ] 슬랙 채널에 메시지가 정상 발송되는지 확인
[ ] Gmail로 이메일이 정상 발송되는지 확인
[ ] 이메일 내용이 없을 때 안내 메시지가 나오는지 확인
Done 기준: "MCMP 장애 이메일을 붙여넣고 '장애 보고해줘'라고 하면, 슬랙과 이메일이 동시에 발송되고 화면에 완료 메시지가 뜬다."
Optional
B. 외부 API 연동인 경우
2개의 외부 서비스 연동이 필요합니다.
환경변수 요약
변수명 | 서비스 | 발급 방법 |
|---|---|---|
| Slack | |
| Gmail | Google 계정 → 보안 → 앱 비밀번호 |
Tip: Claude Code에게 키를 알려주면 자동으로
.env에 설정해줘요! 예: "슬랙 토큰은 xoxb-xxxx야"
B-1. Slack
항목 | 내용 |
|---|---|
Context7 Library ID |
|
필요한 credential | Bot User OAuth Token |
환경변수 |
|
복잡도 | 중간 (앱 생성 + 봇 권한 설정) |
예상 설정 시간 | 약 20분 |
설정 가이드 요약: 상세 내용은 📘 설정 가이드 참조
B-2. Gmail
항목 | 내용 |
|---|---|
Context7 Library ID |
|
필요한 credential | Gmail 앱 비밀번호 |
환경변수 |
|
복잡도 | 중간 (2단계 인증 + 앱 비밀번호 발급) |
예상 설정 시간 | 약 15분 |
설정 가이드 요약: 상세 내용은 📘 설정 가이드 참조
참고: 상세 가이드는
연동가이드/폴더의 개별 파일을 확인하세요.
C. 다단계 워크플로우인 경우
단계 목록:
입력 수신 → 산출물: 이메일 원문 텍스트
장애 분석 → 산출물: 유형/심각도/영향범위 구조화 데이터
메시지 생성 → 산출물: 슬랙용 메시지 + 이메일용 메시지 (심각도에 따라 톤 조정)
발송 → 산출물: 슬랙 채널 + 이메일 동시 발송 완료
중단/재개 방법: 발송 단계에서 실패 시, 생성된 메시지 텍스트를 출력해주어 수동 복붙으로 대체 가능.
나중에 더 발전시킬 아이디어
[ ] 고객사별 담당 채널/수신자 자동 매핑 (고객사명 감지 → 해당 채널 발송)
[ ] 장애 이력 자동 기록 (Google Sheets에 날짜/유형/심각도 누적)
[ ] 아침/저녁 정해진 시간에 자동 실행 (MCMP 이메일 자동 수집 연동)
도움 받은 글
타 강의에서 배운 사례글 게시 SKILL 을 활용하여 게시글 작성



