automation: 나만의 업무 자동화 체험

핵심: 대화만으로 나만의 업무 자동화 스킬을 만든다.

반복 업무를 인터뷰로 발견하고 → 워크플로우를 같이 설계하고 → 재사용 가능한 스킬을 만들어 → 바로 검증한다. 코드를 몰라도, 스킬 포맷을 몰라도 된다.

실행 흐름 요약

Phase 0 → Phase 1 → Phase 2 → Phase 3 → Phase 4
환경 확인   인터뷰    설계      스킬 생성   마무리
 (자동)   (대화)   (구체화)   (실행)    (공유)

Phase 0: 환경 확인

목적: 연결된 도구를 파악한다.

Phase 0 시작 시, Read 도구로 ~/.claude/skills/smilegate-ai-tools/state.json의 connector 키를 확인한다.

connector.status === "completed" 또는 "partial": connected_services 목록의 서비스만 ToolSearch로 확인한다 (전체 7개 스캔 생략). failed_services에 있는 서비스는 즉시 ❌로 표시한다.
connector.status === "error" 또는 키 없음: 전체 7개 서비스를 직접 스캔한다 (기존 방식).

skills/connector/SKILL.md의 "연결 대상" 테이블을 참조하여 지원 서비스 목록을 파악한다.
connector의 진단 방법(ToolSearch/Bash)에 따라 각 서비스의 연결 여부를 확인한다.
- 상태 판별 규칙: ✅(정상 연결)과 ❌(미연결 또는 사용 불가) 두 가지만 사용한다.
- ⚠️(토큰 만료, 연결 오류 등 일시적 오류)도 사용 불가이므로 ❌로 취급한다.

연결 상태를 한 줄로 표시:

🔌 연결 상태: Jira ✅ Confluence ✅ Slack ✅ BISKIT ❌ API Docs ❌ GitLab ❌

연결된 도구가 0개면:

아직 연결된 업무 도구가 없어요.
자동화를 만들려면 먼저 도구를 연결해야 해요!
"커넥터" 또는 "/connector"라고 말하면 바로 연결할 수 있어요.

안내 후 종료.

❌ 표시된 도구가 1개 이상 있으면 한 줄로 안내:

연결이 필요한 도구가 있어요. "커넥터"로 연결하거나 재연결할 수 있어요.

연결된 도구(✅)가 1개 이상이면 Phase 1로 자연스럽게 전환:

이 도구들로 반복 업무를 자동화할 수 있어요.
어떤 자동화를 만들지, 같이 정해볼까요?

주의: 내부 진단 과정은 사용자에게 보여주지 않는다.

Phase 1: 인터뷰 — "어떤 일을 반복하고 계세요?"

목적: 대화를 통해 사용자의 반복 업무를 발견하고 자동화 후보를 정한다.

connector에서 넘어온 경우, 같은 대화 세션 내에서 이미 연결 상태를 파악했으므로 Phase 0을 건너뛰고 이 Phase부터 시작한다.

이 Phase가 스킬의 핵심이다. 사용자가 "뭘 자동화해야 할지 모르겠다"는 상태에서 구체적인 자동화 아이디어까지 도달하게 돕는다.

Step 1: 시작 질문

연결된 도구를 기반으로 맞춤 질문을 던진다. 연결된 도구에 해당하는 예시만 보여준다 (미연결 도구 예시 제외):

몇 가지 질문을 할 건데, 편하게 답해주세요.

이번 주에 했던 업무 중에서
"또 이거 해야 하나..." 싶었던 게 있나요?

예를 들면:
• {연결 도구 기반 예시 2~3개만}

예시 선택 기준 (연결된 도구에 따라):

Jira+Confluence: "매주 Jira 티켓 정리해서 주간보고 쓰기", "스프린트 결과 정리"

Slack+Confluence: "Slack에서 논의한 거 위키에 회의록으로 옮기기", "Slack 채널 대화 정리해서 위키에 남기기"

Jira+Slack: "Slack에서 논의된 할 일을 Jira 티켓으로 만들기", "프로젝트 현황을 Slack에 공유하기"

Jira만: "기획서에 있는 할 일을 Jira 티켓으로 하나씩 만들기", "프로젝트 현황을 PPT 발표자료로 만들기"

Jira+BISKIT: "Jira 이슈 현황 + BISKIT 데이터로 종합 리포트 만들기", "스프린트 결과 정리"

Slack만: "Slack 채널 대화 요약하기"

BISKIT 포함: 위 조합에 "BISKIT 데이터 분석" 예시 추가

GitLab 포함: "커밋 로그 정리", "MR 현황 요약" 예시 추가

API Docs 포함: "API 명세 정리" 예시 추가

모두 연결: 위 예시 중 2~3개 선별

PPT/Excel 출력 예시 (도구 조합과 무관하게 추가 가능): "프로젝트 현황 발표자료(PPT) 만들기", "이번 달 작업 내역을 엑셀로 정리"

AskUserQuestion으로 답변을 받는다.

Step 2: 후속 질문 (구체화)

사용자의 답변이 추상적이면 구체화 질문을 이어간다:

패턴 A — 사용자가 구체적으로 답한 경우:

"매주 금요일에 Jira 정리해서 주간보고 위키에 쓰는 거요" → Step 3로 바로 진행

패턴 B — 사용자가 막연하게 답한 경우:

"음... 보고서 쓰는 거?" → 한 번에 1~2개만 질문 (질문 폭격 금지):

보고서 쓰는 업무군요!
어떤 보고서인가요? (예: 주간보고, 월간보고, 프로젝트 현황)

→ 답변 후 필요하면 후속 질문:

그렇군요! 그 보고서 쓸 때 데이터는 보통 어디서 모으세요?
(예: Jira 티켓, Slack 대화, BISKIT 데이터)

→ 결과물 형태도 확인:

결과물은 어떤 형태가 좋으세요?
(예: 위키 페이지, PPT 발표자료, 엑셀 파일)

패턴 C — 사용자가 모르겠다고 한 경우:

"잘 모르겠는데..." → 연결된 도구 조합에 맞는 추천을 보여준다 (references/scenarios.md 참조):

괜찮아요! 연결된 도구 기반으로 많이 쓰는 자동화를 추천할게요.

{연결된 도구 조합}이 연결되어 있으니:
① {추천 시나리오 1} — {한 줄 설명}
② {추천 시나리오 2} — {한 줄 설명}
③ 직접 설명하기

어떤 게 끌리세요?

추천 시나리오 선택 기준 (references/scenarios.md의 조합별 추천 따름):

Jira+Confluence: 주간보고, 티켓 일괄 생성

Slack+Confluence: 회의록 작성, 채널 논의 정리

Jira+Slack: Slack→Jira 티켓 변환, Jira 현황 Slack 공유

Jira만: 티켓 일괄 생성, 프로젝트 현황 PPT

Jira+BISKIT: 프로젝트 현황 + BISKIT 데이터 종합 리포트, 티켓 일괄 생성

전체 연결: 주간보고, 회의록, 티켓 생성 중 2~3개

미연결 도구가 필요한 시나리오는 절대 추천하지 않는다

Confluence 미연결 시: 출력을 PPT/Excel/화면 표시/Jira 코멘트/Slack 메시지로 안내

Step 3: 자동화 요약 확인

사용자의 답변을 정리하여 확인한다:

정리해볼게요.

📋 자동화할 업무
• 이름: 주간보고
• 하는 일: Jira에서 이번 주 내 티켓을 조회해서 위키에 주간보고 작성
• 빈도: 매주 금요일
• 입력: 없음 (자동으로 Jira 조회)
• 출력: Confluence 위키 페이지
• 사용 도구: Jira, Confluence

이렇게 맞나요? 수정할 부분이 있으면 말씀해주세요.

AskUserQuestion으로 확인:

맞음 → Phase 2로
수정 필요 → 수정 후 다시 확인

Phase 2: 설계 — "이런 순서로 동작할 거예요"

목적: 자동화 워크플로우를 구체적인 단계로 설계하고, 한번 실행해서 검증한다.

Step 1: 워크플로우 초안

인터뷰 결과를 바탕으로 워크플로우를 설계한다:

이런 순서로 동작하게 만들어볼게요:

"주간보고" 스킬이 실행되면:
1. Jira에서 내 정보 확인
2. 이번 주 업데이트된 내 티켓 전체 조회
3. 상태별(완료/진행중/대기)로 분류
4. 주요 성과와 다음 주 전망 요약
5. 위키에 "주간 업무 리포트 — {이름} ({날짜})" 페이지 생성

이 순서로 괜찮을까요? 빠진 단계나 추가할 게 있으면 말씀해주세요.

AskUserQuestion으로 확인.

Step 2: 실행해서 검증 (핵심 와우 포인트)

와우 포인트 #1: "내 실제 데이터가 정리된 결과물이 되는 순간" 설계만 하고 끝이 아니라, 바로 실행해서 결과를 확인한다. 이 순간이 사용자가 "이게 된다고?!"를 느끼는 핵심 순간이다.

좋아요! 지금 바로 한번 실행해볼게요.
실제로 잘 되는지 확인하고, 문제 있으면 바로 고칠 수 있어요.

워크플로우를 실제 실행한다:

시나리오별 상세 실행은 references/ 파일 참조
기존 시나리오에 해당하지 않는 경우 references/custom-workflow.md 참조
실행 중 진행 상황 표시 (각 단계마다)
출력 전 반드시 미리보기 (출력 대상에 따라):
- Confluence 연결됨 → 위키 페이지 미리보기 후 생성
- PPT 요청 → PPT 구조 미리보기 후 파일 생성
- Excel 요청 → 테이블 미리보기 후 파일 생성
- Confluence 미연결 → 화면에 결과 표시 후 다른 저장 방법 제안 (PPT, Excel, Jira 코멘트, Slack 메시지, 또는 화면 표시만)

Before/After 시간 비교를 반드시 표시한다 (시나리오별 예상 시간은 각 reference 파일 참조):

✨ 실행 완료!

⏱️ 수작업: ~{수작업 시간} → 자동화: ~{자동화 시간}
📊 {빈도}하면 연간 약 {연간 절약}시간을 아낄 수 있어요.

결과가 괜찮으세요?

① 좋아요, 이대로 스킬로 만들어주세요
② 좀 수정하고 싶어요 → 어떤 부분을 수정할지 듣고 워크플로우 조정 후 다시 실행

시나리오별 시간 기준:

주간보고: 수작업 ~30분 → ~1분, 매주, 연간 ~25시간

회의록: 수작업 ~20분 → ~1분, 주 2회, 연간 ~30시간

티켓 생성: 수작업 ~5분/건 → ~30초/건, 수시

PPT 발표자료: 수작업 ~1시간 → ~~3분, 월 1~~2회, 연간 ~20시간

엑셀 데이터 정리: 수작업 ~30분 → ~2분, 주 1회, 연간 ~20시간

자유 시나리오: 사용자 설명 기반으로 현실적 추정

이 "설계 → 실행 → 피드백 → 수정" 루프가 반복되면서 사용자의 실제 업무에 딱 맞는 자동화가 만들어진다.

Phase 3: 스킬 생성 — "스킬로 저장할게요"

목적: 검증된 워크플로우를 재사용 가능한 스킬로 저장한다.

Step 1: 스킬 저장

🔧 스킬을 만들게요.

이름: 주간보고
동작: Jira 이번 주 내 티켓 조회 → 상태별 분류 → 위키에 주간보고 작성

skills/ 디렉토리에 새 스킬을 생성한다 — plugin-dev:skill-development 스킬의 가이드를 참조하거나, 공식 skill-creator 플러그인이 설치된 경우 해당 스킬을 활용한다.

Step 2: 저장 완료 + 즉시 테스트 (와우 포인트 #2)

와우 포인트 #2: "내가 만든 스킬이 진짜 동작한다" 스킬을 만든 직후, 바로 실행해서 동작을 확인시킨다. "이걸 내가 만들었다"는 성취감이 핵심.

✅ "주간보고" 스킬이 만들어졌어요!

한번 테스트해볼까요? "주간보고 해줘"라고 말해보세요!

사용자가 테스트하면 Phase 2에서 실행한 것과 동일하게 동작한다.

🎉 잘 작동해요! 다음부터 "주간보고"라고만 말하면 이 자동화가 실행돼요.
매주 ~30분 걸리던 작업이 ~1분이면, 연간 약 25시간을 아낄 수 있어요.

automation state.json 업데이트

Phase 3 Step 1(스킬 생성)이 완료되면 ~/.claude/skills/smilegate-ai-tools/state.json의 automation 키를 업데이트한다:

{
  "automation": {
    "status": "completed",
    "skill_count": "{기존 값 + 1, 없으면 1}",
    "last_completed_at": "{현재 ISO 8601 시각}"
  }
}

파일이 이미 존재하면 기존 내용을 보존하고 automation 키만 업데이트한다.
skill_count: 기존에 automation.skill_count가 있으면 +1, 없으면 1로 초기화.

Step 3: 추가 스킬 제안

💡 하나 더 만들어볼까요?

다른 반복 업무가 떠오르면 지금 바로 만들 수 있어요.
나중에 만들고 싶으면 "스킬 만들어줘"라고 말하면 돼요.

① 하나 더 만들기 → Phase 1로 돌아감
② 오늘은 여기까지 → Phase 4로

2번째 스킬은 더 빠르게: 사용자가 ①을 선택하면 Phase 1로 돌아가되, 이미 파악한 정보(연결 도구, 선호하는 위키 스페이스 등)를 재활용한다.

Phase 0 건너뜀 (이미 확인)

위키 스페이스 선택 시 이전 선택을 기본값으로 제안

인터뷰도 짧게 (이미 맥락을 알고 있으므로)

목표: 첫 스킬 ~8분 → 두 번째 스킬 ~3분

Phase 4: 마무리 — 요약 + 팀 공유

목적: 만든 스킬을 요약하고, 팀 확산과 재사용 방법을 안내한다.

완료 리포트:

🎉 오늘 만든 자동화

┌─────────────────────────────────────────────┐
│  주간보고                                     │
│  Jira 티켓 → 주간보고 위키 작성               │
│  예상 절약: 매주 ~30분 (연간 ~25시간)          │
└─────────────────────────────────────────────┘

팀 공유:

👥 팀에서도 쓸 수 있어요

프로젝트에 저장되어 있어서,
같은 프로젝트에서 작업하는 팀원도 "주간보고"라고 말하면 쓸 수 있어요.

재사용 안내:

💡 앞으로
• 새 스킬 만들기 → "스킬 만들어줘"
• 기존 스킬 수정 → "주간보고 스킬 수정해줘"
• 더 많은 도구 연결 → "connector"

미연결 도구 안내 (해당되는 경우만): 연결되지 않은 도구가 있으면, 연결 시 가능한 추가 기능을 안내한다:
```
💡 Confluence를 연결하면 결과를 위키에 자동 저장할 수 있어요!
"connector"로 바로 연결할 수 있어요.
```

connector 연동

이 스킬은 connector 스킬의 첫 실행 완료 시 자동으로 제안된다.

connector는 ~/.claude/skills/smilegate-ai-tools/state.json의 connector.first_completed_at 값으로 첫 실행을 감지한다.
- first_completed_at이 있으면 재실행 (이전에 이미 completed를 거침).
- first_completed_at이 없으면 첫 실행 (한 번도 completed된 적 없음).
- 레거시 형식(status 없이 completed: true만 있는 경우)에서는 first_completed_at이 없을 수 있으므로, completed: true이면서 first_completed_at이 없는 경우도 재실행으로 취급한다.
첫 실행이고 연결 성공 서비스가 1개 이상이면, 자동화 스킬을 제안한다.
사용자가 수락하면 Phase 0을 건너뛰고 Phase 1부터 시작한다. (connector가 이미 연결 상태를 확인했으므로)
재실행 시에는 제안하지 않는다.

행동 규칙

인터뷰 규칙 (Phase 1)

열린 질문으로 시작, 사용자 답변에 따라 구체화
한 번에 질문 1~2개만 (폭격하지 않기)
사용자가 막히면 연결된 도구 기반 추천으로 전환
추상적인 답 → 후속 질문으로 구체화
구체적인 답 → 빠르게 요약하고 다음 단계로
출력 형태(위키/PPT/Excel/화면)도 확인

설계 규칙 (Phase 2)

워크플로우는 자연어로 설명 (기술 용어 금지)
반드시 실행해서 검증 (설계만 하고 끝내지 않음)
피드백 받고 수정하는 루프 허용
미리보기로 결과물 확인 후 출력

결과물 품질 규칙

자동 생성 문서는 바로 제출할 수 있는 수준
단순 나열이 아닌 카테고리 분류 + 요약 + 인사이트
사용자 팀의 기존 포맷이 있으면 맞추기

출력 형태별 규칙 (내부 처리용, 사용자에게 노출하지 않음)

위키 페이지: Confluence Storage Format으로 변환하여 생성
PPT 파일: 깔끔한 레이아웃으로 생성, 차트 포함 가능
Excel 파일: 헤더/서식 포함, 필터 설정
화면 표시: 마크다운 포맷으로 보기 좋게 출력

시간 절약 표시 규칙

단건: "수작업 ~30분 → 자동화 ~1분"
누적: "매주 하면 연간 ~25시간 절약"
과장 금지, 현실적 범위

기술 용어 변환

기술 용어	사용자에게 보이는 표현
MCP 서버	연결된 도구
mcp__*	(보여주지 않음)
CLAUDE.md	(보여주지 않음)
SKILL.md	(보여주지 않음)
skills/ 디렉토리	(보여주지 않음)
YAML frontmatter	(보여주지 않음)
스페이스 키	(목록에서 선택)
프로젝트 키	(목록에서 선택)
JQL / XHTML	(보여주지 않음)
채널 (Slack)	그대로 사용 가능 (Slack 사용자에게 익숙한 용어)
데이터셋 쿼리	(보여주지 않음)
issue_type	(보여주지 않음)

에러 처리

기술적 에러 → 사용자 친화 메시지로 변환
연결 안 된 도구 필요 시 → "connector" 안내 + 대안 제안

Confluence/Jira 선택 규칙

"키" 직접 입력 금지 → 목록 조회 후 선택

automation