AI 기반 일일보고 자동 작성 도구 (Claude Code 스킬)

1. 개요

자연어로 "오늘 한 일 / 내일 할 일"을 말하면, AI가 사내 표준 보고 양식으로 변환하고 메일 초안(Outlook)까지 자동으로 띄워주는 Claude Code 스킬입니다. 사람은 말로 업무를 알려주고, 마지막에 초안을 검토·발송만 하면 됩니다.

2. 개발 배경 / 이유

평소 일일보고를 작성할 때, 일상적인 말투의 문장을 보고용 문장으로 바꾸고 항목별로 정리하는 과정에서 피로감을 많이 느꼈습니다. 이 반복 작업은 AI를 활용하면 충분히 줄일 수 있겠다고 판단했습니다.

여기에 더해, 단순히 문장 정리에서 그치지 않고 .ps1(PowerShell) 스크립트를 활용해 메일 초안 작성까지 자동화되면 훨씬 편할 것 같았습니다. AI를 통해 이 전 과정 자동화가 실제로 가능한지 확인한 결과 구현이 가능하여 진행하게 되었습니다.

3. 구성요소 상세 설명

이 도구는 4개의 구성요소가 맞물려 동작합니다. 각각의 역할은 다음과 같습니다.

① 스킬 정의 (작성 규칙)

도구의 "두뇌"에 해당하는 규칙 모음입니다. AI가 자연어 입력을 표준 보고서로 바꿀 때 따르는 모든 기준이 여기에 정의되어 있습니다.

• 작성 절차 — 요청 파싱 → 휴가 예외 확인 → 제목 매핑 → 본문 작성 → 매핑 테이블 갱신 → 스크립트 실행 → 요약 보고
• 양식 규칙 — 계층 구조(* 대분류 → - 소분류 → > 세부), 진행건수 자동 계산, 금요일은 "익일→차주" 자동 전환, 정기점검 여러 건은 하나로 묶음
• 표현 스타일 — 보고체 변환, 동행자 w/이름, 수량 N식, 배경·경위 설명 없이 팩트만 작성
• 안전 장치(금지 규칙) — 자동 발송 금지(초안만), 스크립트 새로 작성 금지(본문만 교체), 메일 서식 구조 변경 금지

② 제목 매핑 테이블 (task_titles.md)

사용자가 말한 업무 키워드를 보고서의 표준 대분류(* 제목)로 연결해 주는 사전(辭典)입니다. 같은 업무가 매번 같은 제목으로 분류되도록 일관성을 보장합니다.

• 구조 — "키워드(사용자 언급 패턴) → 표준 * 제목 → 마지막 사용일" 3열 표
• 예시 — "OpenUDS, 도메인 조인, 골든 이미지" → * Proxmox VE 기반 VDI 작업
• 자동 관리 — 사용한 항목의 날짜를 갱신, 1개월 이상 미사용 항목은 삭제(단 진행 중 프로젝트·정기점검은 항상 유지), 새 업무 등장 시 행 추가
• 예외 처리 — 매칭이 안 되거나 모호하면 AI가 작성 전에 사람에게 분류를 먼저 질문

③ 메일 발송 스크립트 (일일보고.ps1)

실제로 메일 초안을 만들어내는 실행 엔진(PowerShell)입니다. AI는 이 스크립트의 "본문 영역"만 교체하고, 나머지 로직은 고정되어 있습니다.

• 제목 자동 생성 — 실행 날짜·요일을 읽어 "[일일보고] YYYY년 MM월 DD일(요일) 인프라팀 정율권 일일보고" 형식으로 자동 작성
• 본문 주입 영역 — ##BODY_START## ~ ##BODY_END## 마커 사이의 here-string($bodyContent)에 보고 본문 HTML이 들어감 (AI가 매일 이 부분만 교체)
• 서명 보존 — 기존 Outlook 서명을 "이상입니다" 기준으로 분리해, 생성한 본문 + 기존 서명을 다시 합치고 서명 글꼴을 맑은 고딕 10pt로 보정
• 수신자 고정 — 원하는 대상 고정

④ Outlook 연동

스크립트가 Windows의 Outlook을 직접 제어하는 부분입니다(COM 연동). 메일 클라이언트를 자동으로 띄워 발송 직전 초안까지 완성합니다.

• 동작 — COM 객체로 Outlook 실행 → 새 메일 항목 생성 → 수신자·제목 설정 → HTML 본문 주입
• 초안만 표시 — .Display()로 초안만 띄우고 자동 발송(.Send())은 사용하지 않음 → 사람이 최종 검토 후 직접 발송
• 병합 — 생성한 본문 HTML을 기존 메일 서명과 합쳐 자연스러운 형태로 완성

4. 전체 흐름도

위 4개 구성요소가 트리거부터 최종 발송까지 어떻게 이어지는지 정리하면 다음과 같습니다.

[사람] 자연어로 업무 입력  →  예) "오늘 OO 정기점검 했고, 내일은 AD 도메인 조인 준비할 거야"

     ▼

(1) 요청 파싱 : 금일 업무 / 익일(차주) 업무 분리

     ▼

(2) 휴가 예외 확인 : 연차 / 공휴일 / 대체휴무이면 작성 중단 (보고 없음)

     ▼

(3) 제목 매핑 (task_titles.md 참조) : 각 업무를 표준 '*' 제목으로 분류

        └ 매칭되는 제목이 없거나 모호하면 → [사람] "기존 항목? 새 항목?" 선택 응답 → 테이블에 반영

     ▼

(4) 본문 작성 (표준 양식 변환) : 보고체 변환, 계층 구조(* → - → >), 표현 규칙(w/이름·N식·팩트), 진행건수 자동 계산

     ▼

(5) task_titles.md 갱신 : 사용 항목 날짜 갱신 / 신규 항목 등록

     ▼

(6) 일일보고.ps1 실행 → Outlook COM 연동으로 메일 초안 생성 (자동 발송 아님, 초안만 표시)

     ▼

[사람] Outlook 초안 검토 후 직접 발송

사람이 개입하는 지점은 3곳입니다.

• 시작 — 오늘/내일 한 일을 자연어로 입력 (트리거)
• 중간(필요 시) — 업무가 표준 제목에 매칭되지 않거나 모호할 때, 분류를 선택해 응답
• 마지막 — 완성된 Outlook 초안을 검토하고 직접 발송

5. 기술 완성 후, 전과 비교해 더 좋아진 부분

• 문장 변환 피로 제거 — 일상 말투를 보고체로 바꾸는 가장 귀찮은 작업을 AI가 대신함
• 양식 일관성 확보 — 제목 매핑 테이블 기반으로 매번 같은 기준의 분류·계층 구조가 유지됨
• 메일 초안까지 원스톱 — 본문 정리 후 별도로 메일을 새로 쓰고 복붙하는 과정이 사라짐
• 실수 방지 — 진행건수 자동 계산, 금요일이면 "익일→차주" 자동 전환 등 사람이 놓치기 쉬운 부분을 규칙으로 처리
• 표현 규칙 내장 — w/이름, 수량 N식 변환, 배경 설명 없이 팩트만 작성 등 사내 보고 스타일을 매번 신경 쓰지 않아도 일관되게 적용
• 작성 시간 단축 — 전체 소요 시간이 크게 줄어 보고 부담이 낮아짐

6. 향후 발전 가능성 및 방향

현재 만족도가 높아 추가 개발 우선순위는 낮지만, 확장한다면 다음 방향이 가능합니다.

• 주간/월간 보고 자동 집계 — 누적된 일일보고를 모아 주간·월간 보고로 자동 요약
• 업무 데이터 자동 수집 — 캘린더·이슈트래커·작업 로그와 연동해 "한 일"을 사람이 말하지 않아도 자동 수집
• 자동 발송 옵션 — 충분한 신뢰가 쌓이면 검토 단계 생략하고 자동 전송(현재는 안전상 초안만)
• 다중 사용자 일반화 — 작성자별 양식·매핑 테이블을 분리해 팀 전체가 사용할 수 있는 공용 도구로 확장

7. 실제 진행 화면 (프로세스 예시)

아래는 실제로 이 도구가 동작하는 순서를 캡처한 화면입니다. 위 흐름도가 실제로 어떻게 진행되는지 눈으로 확인할 수 있습니다.

① 업무 입력 — 사용자가 오늘/내일 한 일을 자연어로 전달 (트리거)

② 본문 작성 — AI가 표준 양식에 맞춰 일일보고.ps1 본문을 자동 교체

③ 작성 완료 — 표준 양식 변환 결과를 요약하고 Outlook 호출

④ 메일 초안 생성 — Outlook에 발송 직전 초안이 자동으로 열림 (사람이 검토 후 직접 발송)

                                                                                                                                                                                                                               ⭐발표자 : 정율권님