소개
매주 AI 수업 자료를 준비하는 데 시간이 너무 많이 걸렸습니다. 회사 업무 중 별도 시간을 내기도 눈치 보이고, 일요일 저녁에 급하게 만들다 보면 품질도 들쭉날쭉했습니다.
시도하고자 했던 것:
> "AI 키워드와 수업 목차만 입력하면, Claude Code가 사무직 대상 수업용 HTML 슬라이드를 자동으로 만들어주는 파이프라인 구축"
키워드와 목차를 담은 입력 파일 하나를 준비해두면, Claude Code가 내용을 구성하고 발표용 HTML 슬라이드까지 저장해주는 흐름을 만드는 것이 목표였습니다.
사람이 직접 해야 하는 부분은 입력 파일 작성과 최종 품질 검토 두 가지만 남기고 싶었습니다.
진행 방법
사용한 도구
| 도구 | 역할 |
|------|------|
| Claude Code | 파이프라인 전체 실행 (읽기 → 생성 → 저장) |
| Claude Code Read | 입력 파일 읽기 |
| Claude Code Write | HTML 슬라이드 파일 저장 |
| 텍스트 에디터 | 입력 파일(`.md`) 작성 |
| 브라우저 | 생성된 HTML 슬라이드 확인 |
---
Step 1. 업무 워크시트 작성 (`worksheet.md`)
자동화할 업무를 정의하는 단계입니다.
"무엇을, 언제, 어떻게, 왜" 자동화하는지 명확하게 정리했습니다.
핵심 정의 내용:
```
업무 이름: AI 키워드 기반 주간 수업 자료 자동 생성
업무 한 줄 설명: 매주 AI 키워드를 입력하면 사무직 대상 AI 자동화 수업용 슬라이드 웹 자료를 자동으로 생성한다
시작 시점: 매주 일요일 저녁
입력: AI 키워드 + 수업 목차 + 수강생 특성 (텍스트 파일)
출력: PPT 슬라이드형 웹 페이지 (HTML)
사람이 확인할 것: 실무 도움 여부, 수강생 수준 적합성
```
워크시트에서 모르는 부분은 [확인 필요]로 남기고 진행했습니다.
완벽하지 않아도 되는 단계입니다.
---
Step 2. 자동화 설계 초안 작성 (`automation_design.md`)
워크시트를 기반으로 자동화 흐름도를 설계했습니다.
Claude Code에 사용한 프롬프트:
```
worksheet.md 파일을 읽고, 이 업무의 자동화 설계 초안을 작성해줘.
입력 수집 및 검증 규칙, 핵심 처리 단계, 사람 검토 지점, 예외 처리,
중복 방지 규칙을 포함해줘.
현재 자동화가 가능한 범위와 그레이 영역(추가 설정 필요한 부분)도
구분해서 정리해줘.
```
생성된 처리 흐름:
```
[사람] 입력 파일 준비
↓
[Claude Code] 입력 파일 읽기 (Read 도구)
↓
[Claude Code] 키워드 기반 내용 구성
- 각 목차 항목별 설명 작성
- 실무 연관 예시 포함
- 사무직 눈높이 기준 표현
↓
[Claude Code] HTML 슬라이드 생성 (5~10장)
↓
[Claude Code] output/ 폴더에 파일 저장 (Write 도구)
↓
[사람] 품질 검토 → 수업 사용
```
Step 3. 도구 연결표 작성 (`tool_connection.md`)
각 처리 단계에 어떤 Claude Code 도구를 연결할지 매핑했습니다.
Claude Code에 사용한 프롬프트:
```
automation_design.md의 각 자동화 단계에 연결 가능한 Claude Code 도구를
찾아서 도구 연결표를 만들어줘.
현재 작업공간의 SKILL.md 파일을 먼저 탐색하고,
즉시 사용 가능 / 추가 설정 필요 / 그레이 영역으로 구분해줘.
```
도구 연결 결과 요약:
| 단계 | 도구 | 상태 |
|------|------|------|
| 입력 파일 읽기 | Read | ✅ 즉시 가능 |
| 내용 구성 및 슬라이드 작성 | Claude Code AI | ✅ 즉시 가능 |
| HTML 파일 저장 | Write | ✅ 즉시 가능 |
| 웹 검색 자료 수집 | WebSearch | 🔲 추가 설정 필요 |
| 매주 자동 스케줄 실행 | 없음 | ⬜ 그레이 영역 |
---
Step 4. 실제 입력 파일 작성 (`input_20260329_Claude실무활용.md`)
설계된 표준 형식에 맞춰 이번 주 수업 내용을 직접 입력 파일로 작성했습니다.
입력 파일 내용 (실제 사용본):
```markdown
AI 키워드
Claude 실무 활용 — 사무직이 바로 쓸 수 있는 Claude 사용법
수업 목차
1. Claude란 무엇인가 (1분 설명)
2. 사무직 실무에서 Claude가 가장 잘하는 것 3가지
3. 실습: 보고서 초안 자동 생성
4. 실습: 회의록 요약 자동화
5. 자주 하는 실수와 해결법
6. 오늘 배운 것 정리
수강생 특성
사무직 / 중급 / Claude 처음 써보는 분~가끔 쓰는 분 / 실무 바로 적용 원함
Step 5. 오케스트레이션 실행 및 슬라이드 생성
입력 파일을 Claude Code에 전달해 실제 실행했습니다.
Claude Code에 사용한 실행 명령:
```
source/input_20260329_Claude실무활용.md 파일을 읽고 수업용 HTML 슬라이드를 만들어줘.
```
생성 결과 (`slide_20260329_Claude실무활용.html`):
| 항목 | 결과 |
|------|------|
| 슬라이드 수 | 7장 (표지 1 + 내용 5 + 마무리 1) |
| 네비게이션 | 키보드(← →) + 버튼 방식 |
| 실무 예시 | 보고서 초안 프롬프트, 회의록 요약 프롬프트 직접 포함 |
| 수강생 수준 | 바로 복사해서 쓸 수 있는 프롬프트 제공 |
실행 결과 기록 파일 (`orchestration_run.md`)도 함께 생성:
```
- 입력 파일 정보 (키워드, 목차, 수강생 특성)
- 출력 파일 정보 (슬라이드 수, 형식, 실무 예시 포함 여부)
- 사람 최종 확인 체크리스트
- 재실행 방법 (품질 미달 시 명령 템플릿)
- 미해결 그레이 영역 목록
```
전체 파일 흐름 요약
```
[입력]
worksheet.md → 업무 정의
↓
automation_design.md → 자동화 흐름 설계
↓
tool_connection.md → 도구 매핑
↓
input_20260329_Claude실무활용.md → 이번 주 수업 내용
[출력]
orchestration_run.md → 실행 기록 + 체크리스트
slide_20260329_Claude실무활용.html → 발표용 수업 슬라이드
```
결과와 배운 점
배운 점
1. 입력 파일 형식을 고정해두는 것이 핵심이다
AI 키워드 / 수업 목차 / 수강생 특성 세 가지 섹션을 표준화하니, Claude Code가 일관된 품질의 슬라이드를 생성했습니다. 입력 형식이 흔들리면 출력 품질도 흔들립니다.
2. "사람이 할 것 vs AI가 할 것"을 미리 나눠야 한다
워크시트 단계에서 사람 개입 지점을 명확히 정해두니, 어느 단계에서 내가 확인해야 하는지 헷갈리지 않았습니다.
3. 모르는 것은 [확인 필요]로 남기고 진행해도 된다
완벽한 설계를 기다리다가 아무것도 못 만드는 것보다, 불완전한 채로 시작해서 실행하면서 채워가는 것이 더 빠릅니다.
4. 그레이 영역을 미리 기록해두면 나중에 확장이 쉽다
지금 당장은 수동으로 하는 부분(웹 검색, 자동 스케줄)도 나중에 어디서 막혔는지 기록해두면 후속 개선이 쉬워집니다.
시행착오
- 처음에는 프롬프트를 너무 길고 복잡하게 썼습니다. 단 순하게 "파일 읽고 슬라이드 만들어줘"가 오히려 더 잘 작동했습니다.
- 입력 파일에 수강생 특성을 빠뜨리면 슬라이드가 너무 일반적으로 나왔습니다. 수강생 특성 섹션이 슬라이드 난이도와 어조에 큰 영향을 미칩니다.
도움이 필요한 부분
- WebSearch 도구를 활성화해서 최신 AI 관련 자료를 자동으로 가져오는 방법
- 매주 자동으로 실행되는 스케줄러 설정 방법 (현재는 매주 수동 명령 필요)
앞으로의 계획
- 다음 주: 같은 방식으로 다른 AI 키워드(Gemini, NotebookLM 등)로 슬라이드 추가 생성
- 중기: WebSearch 도구를 연결해서 최신 사례가 자동으로 반영되도록 개선
- 장기: .claude/agents/ 에 자율 실행 Agent로 변환해서 수동 명령 없이 실행되도록 구축
