[미니사례]스킬을 활용한 운영보고서 발송

소개

• 스킬 이름: incident-report

• 한 줄 설명: 클라우드 장애 이메일을 붙여넣으면 상황에 맞는 운영팀 공유 메시지를 자동으로 만들어 슬랙과 이메일로 발송

• 만드는 사람: 고객사 담당 PM

• 스킬 유형: [x] 다단계 워크플로우 [x] 외부 API

• MVP 목표: "MCMP 장애 이메일 내용을 붙여넣으면 심각도 분석 + 슬랙 메시지 발송까지 자동으로 완료"

진행 방법

외부 연동

워크플로 시각화

ALT

비즈니스 프로세스의 흐름도

결과와 배운 점

1. 언제 쓰나요?

대표 상황: 매일 오전/오후 2회, MCMP 시스템에서 받은 고객사 클라우드 장애/이상 알림 이메일을 운영 담당자에게 공유할 때

왜 필요한가:

• 하루 2번, 매번 이메일 내용을 직접 읽고 요약해서 슬랙과 이메일 둘 다 작성해야 함

• 상황에 따라 메시지 톤/형식이 달라서 매번 어떻게 쓸지 고민이 필요

• 긴급 장애 시 빠른 공유가 필요한데 작성 시간이 병목이 됨

2. 사용법

이렇게 부르면:

• /incident-report

• "장애 보고해줘"

• "이거 운영팀에 공유해줘" (+ 이메일 내용 붙여넣기)

결과물 형태: [x] 메시지 [ ] 파일 [ ] 링크/리포트 [ ] 기타

결과물 예시:

[장애 현황 공유] 고객사A - 서울 리전 API 응답 지연

안녕하세요, PM입니다.

현재 고객사A 클라우드 환경에서 다음과 같은 이슈가 감지되었습니다.

• 장애 유형: API 응답 지연

• 심각도: 중간 (서비스 일부 영향)

• 감지 시각: 2026-03-21 09:23

• 영향 범위: 서울 리전 전체

운영팀 확인 부탁드립니다.

3. 입력/출력 명세

4. 범위

하는 것:

1. 장애 이메일 내용 분석 (유형, 심각도, 영향 범위 파악)

2. 상황에 맞는 슬랙 메시지 자동 생성 및 발송

3. 운영팀 이메일 초안 자동 생성 및 발송

안 하는 것:

1. MCMP 시스템 직접 접속 및 이메일 자동 수집 (수동 붙여넣기 방식)

2. 장애 해결 방법 제시 또는 에스컬레이션 자동화

5. 데이터/도구/권한

6. 실패/예외 처리

예상되는 실패 상황:

1. 슬랙 토큰 만료 또는 채널 권한 없음 → 이메일만 발송하고 슬랙 재설정 안내

2. Gmail 앱 비밀번호 오류 → 이메일 초안만 출력하고 수동 발송 안내

3. 이메일 내용이 너무 짧거나 장애 관련 내용이 없음 → "장애 내용을 더 자세히 붙여넣어 주세요" 안내

실패 시 안내 원칙: 한 쪽 발송이 실패해도 다른 쪽은 진행. 실패한 경우 이유와 수동 처리 방법 함께 안내.

7. 대화 시나리오

정상 케이스:

나: "장애 보고해줘" + [MCMP 이메일 내용 붙여넣기]

스킬:

분석 완료했어요!

장애 요약: 고객사B 서울 리전 DB 연결 오류 (심각도: 높음)

슬랙 메시지: #운영팀 채널에 발송했어요 ✅ 이메일: [email protected]으로 발송했어요 ✅

실패 케이스:

나: "장애 보고해줘" (이메일 내용 없이)

스킬:

MCMP에서 받은 장애 이메일 내용을 함께 붙여넣어 주세요!

예: "장애 보고해줘" 다음 줄에 이메일 전체 내용을 붙여넣으시면 돼요.

8. 테스트 & 완료 기준

테스트 체크리스트:

• [ ] 실제 MCMP 장애 이메일로 요약이 제대로 되는지 확인

• [ ] 슬랙 채널에 메시지가 정상 발송되는지 확인

• [ ] Gmail로 이메일이 정상 발송되는지 확인

• [ ] 이메일 내용이 없을 때 안내 메시지가 나오는지 확인

Done 기준: "MCMP 장애 이메일을 붙여넣고 '장애 보고해줘'라고 하면, 슬랙과 이메일이 동시에 발송되고 화면에 완료 메시지가 뜬다."

Optional

B. 외부 API 연동인 경우

2개의 외부 서비스 연동이 필요합니다.

환경변수 요약

Tip: Claude Code에게 키를 알려주면 자동으로 .env에 설정해줘요! 예: "슬랙 토큰은 xoxb-xxxx야"

B-1. Slack

설정 가이드 요약: 상세 내용은 📘 설정 가이드 참조

B-2. Gmail

설정 가이드 요약: 상세 내용은 📘 설정 가이드 참조

참고: 상세 가이드는 연동가이드/ 폴더의 개별 파일을 확인하세요.

C. 다단계 워크플로우인 경우

단계 목록:

1. 입력 수신 → 산출물: 이메일 원문 텍스트

2. 장애 분석 → 산출물: 유형/심각도/영향범위 구조화 데이터

3. 메시지 생성 → 산출물: 슬랙용 메시지 + 이메일용 메시지 (심각도에 따라 톤 조정)

4. 발송 → 산출물: 슬랙 채널 + 이메일 동시 발송 완료

중단/재개 방법: 발송 단계에서 실패 시, 생성된 메시지 텍스트를 출력해주어 수동 복붙으로 대체 가능.

나중에 더 발전시킬 아이디어

• [ ] 고객사별 담당 채널/수신자 자동 매핑 (고객사명 감지 → 해당 채널 발송)

• [ ] 장애 이력 자동 기록 (Google Sheets에 날짜/유형/심각도 누적)

• [ ] 아침/저녁 정해진 시간에 자동 실행 (MCMP 이메일 자동 수집 연동)

도움 받은 글

타 강의에서 배운 사례글 게시 SKILL 을 활용하여 게시글 작성