← 자료실 홈
직접 코딩 0% — CLAUDE CODE로 진짜 서비스 만들고 배포·운영까지

5장 프롬프트 모음 · 문서 자동화 — AI에게 일 시키기

각 프롬프트는 원고의 해당 절에 수록된 원문입니다. 어두운 상자는 터미널 명령어, 밝은 상자는 Claude Code 대화창에 입력하는 프롬프트 또는 규칙 파일(CLAUDE.md·Skill.md) 내용입니다.

5.1 [실습] HWPX 보고서 100건 자동 생성 hwpx-generator
프로젝트 폴더 준비 (터미널) — STUDENT_LIST.xlsx를 폴더에 먼저 저장
mkdir hwpx-generator cd hwpx-generator claude
실행 프롬프트 — 5단 구조 (만들 것 → 요구사항 → 방어 조건 → 체크리스트 → 증거 요구)
수료증을 한글(HWPX) 파일로 100개 자동 생성하는 프로그램을 만들어줘. ## 만들 것 엑셀 파일에서 정보를 읽어, 수료증 HWPX 파일을 수강생 수만큼 자동 생성. ## 요구사항 1. 엑셀 파일(STUDENT_LIST.xlsx)에서 이름, 소속, 수료일을 읽어옴 2. 수료증 템플릿을 기반으로, 각 수강생의 정보를 채워서 개별 HWPX 파일 생성 3. 파일 이름은 기본적으로 수료증_홍길동.hwpx 형식으로 만듦 (이름이 같은 수강생이 있으면 소속이나 순번을 붙여 수료증_홍길동_마케팅팀.hwpx처럼 서로 다른 파일로 저장하고, 기존 파일을 묻지 않고 덮어쓰지 않음) 4. 테스트용 수료증 5개는 output 폴더에 저장 5. STUDENT_LIST.xlsx의 실제 수료증 100개는 output_100 폴더에 저장 6. 진행 상황을 📌 [N/전체] 형식으로 보여줘 7. 테스트용으로 수강생 5명짜리 샘플 엑셀 파일도 만들어줘 ## 방어 조건 - 엑셀에 이름이 빈 행이 있으면 → 건너뛰고 "⚠ N행: 이름 없음, 건너뜀" 경고 - 파일명에 특수문자(/, \, * 등)가 있으면 → 자동 제거 후 생성 - 엑셀 파일이 없을 때 → "수강생명단을 찾을 수 없습니다" 안내 후 종료 ## ★ 완성 체크리스트 (전부 통과해야 완료) - [ ] output 폴더에 HWPX 파일 5개 존재하는가? - [ ] output_100 폴더에 실제 수강생 수와 같은 100개의 HWPX 파일이 생성됐는가? - [ ] 첫 번째·중간·마지막 수강생의 이름·소속·수료일이 명단과 일치하는가? - [ ] 수료증 서식(제목, 본문, 정렬)이 유지되는가? - [ ] 빈 이름 행을 넣었을 때 건너뛰고 경고하는가? - [ ] 진행 상황이 📌 형식으로 출력되는가? → 각 항목을 실제 테스트한 과정과 증거를 보여줘. → 실패 시 수정 후 재검증. 전부 통과할 때까지 반복.
※ 이 프롬프트를 CLAUDE.md 파일로 만들어 두면 "CLAUDE.md 파일의 내용에 맞춰서 HWPX 보고서 자동 생성 프로그램을 만들어 줘" 한 줄로 실행할 수 있습니다.
통제하기 — 양식 개선 (logo.png를 폴더에 먼저 저장)
수료증 상단에 우리 기관인 경희대학교 로고 이미지(logo.png)를 넣고, "이 수료증은 AI 교육 과정의 이수를 증명함" 문구가 들어가게 바꿔줘. 수정 후 기존 체크리스트 5개가 정확히 반영되었는지도 확인해줘.
에러가 났을 때
파이썬 실행 환경 문제 같아. uv를 사용해서 해결해줘.
에러를 수정해줘.
다른 방법으로 시도해줘.
만능 해결법 — 뭔가 안 될 때
체크리스트를 처음부터 다시 전부 통과시켜줘. 증거도 보여줘.
5.2 [실습] 엑셀 파일 일괄 처리 및 PDF 통합 리포트 excel-report
프로젝트 폴더 준비 (터미널) — INPUT 폴더에 매출_01~12.xlsx 저장
mkdir excel-report cd excel-report claude
실행 프롬프트 — 5단 구조
엑셀 파일 12개를 합쳐서 연간 매출 보고서를 만들어줘. ## 만들 것 12개의 월별 엑셀 파일 → 통합 분석 → PDF 보고서 1개 ## 요구사항 1. INPUT 폴더 안의 매출_*.xlsx 파일 12개를 읽어서 하나로 합침 2. 월별 매출 합계를 계산 3. 월별 매출 추이 꺾은선 그래프를 그림 4. 상위 매출 품목 TOP 5를 뽑아서 표로 정리 5. 전체 요약(총 매출, 월 평균, 최고 매출 월, 최저 매출 월)을 첫 페이지에 6. 위 내용을 합쳐서 PDF 보고서로 만듦 7. 한국어로, 보고서 제목은 "2025년 연간 매출 분석 보고서" 8. ⚠ 차트와 PDF에서 한글이 깨지지 않도록, 내 컴퓨터에 설치된 "맑은 고딕"이나 "AppleGothic" 폰트를 적용하는 코드를 반드시 포함해 줘 9. 진행 상황을 📌 [단계 N/전체] 형식으로 보여줘 10. 만약 INPUT 폴더에 엑셀 파일이 없으면, 테스트용 12개월짜리 샘플 엑셀 파일을 INPUT 폴더에 만들어줘 ## 방어 조건 - 빈 시트가 있으면 → "⚠ N월: 데이터 없음" 안내 후 해당 월 건너뛰기 - 숫자가 아닌 셀(문자, 빈칸) → 0으로 처리하고 "⚠ 비정상 값 N건 처리" 경고 - 엑셀이 아닌 파일(JPG 등) → 무시하고 경고 - 12개 미만일 때 → 있는 파일만으로 보고서 생성 + "N개월 데이터 누락" 안내 ## ★ 완성 체크리스트 (전부 통과해야 완료) - [ ] 12개월 매출 합산 혹은 입력 파일 중 유효한 매출 데이터의 합계가 정확한가? - [ ] 꺾은선 그래프에서 한글이 정상 표시되는가? (ㅁㅁㅁ 아닌가?) - [ ] TOP 5 품목이 실제 데이터와 일치하는가? - [ ] PDF가 정상적으로 열리는가? - [ ] 빈 시트를 넣었을 때 건너뛰고 경고하는가? - [ ] 진행 상황이 📌 형식으로 출력되는가? → 각 항목을 실제 테스트한 과정과 증거를 보여줘. → 실패 시 수정 후 재검증. 전부 통과할 때까지 반복.
※ 원고에서는 방어 조건 검증을 위해 7월 매출을 빈칸으로 두고, INPUT 폴더에 광고배너.jpg를 일부러 섞어 두었습니다 — 함정으로 방어 조건의 동작을 시험하는 기법입니다.
5.3 [실습] AI 감정 일기장 emotion-diary · Skill.md
프로젝트 폴더 준비 (터미널)
mkdir emotion-diary cd emotion-diary
Skill.md — 감정 분석 전문가 (폴더에 파일로 저장)
# Skill.md — 감정 분석 전문가 ## 역할 일기 텍스트를 읽고 감정을 분석하는 전문가. ## 감정 카테고리 (6가지) 기쁨(😊), 슬픔(😢), 불안(😰), 평온(🍃), 분노(😡), 감사(🙏) ## 분석 규칙 - 하나의 일기에서 주요 감정을 최소 2개, 최대 4개 추출 - 각 감정에 1~10 점수를 부여 (10이 가장 강함) - 감정의 흐름(시작→중간→끝)을 파악하여 순서대로 나열 ## 공감 코멘트 작성 규칙 - 반드시 일기 내용의 구체적 사건을 언급할 것 - "힘드셨겠네요" 같은 일반적 위로 금지 - "발표 전 긴장감이 컸겠지만, 팀장님의 칭찬이 큰 힘이 됐을 거예요"처럼 구체적으로 - 마지막 문장은 반드시 내일에 대한 긍정적 한마디로 끝낼 것 ## 금지 사항 - 일기 내용을 판단하거나 평가하지 않는다 - 의학적·심리학적 진단을 내리지 않는다 - "우울증", "불안장애" 같은 의료 용어를 사용하지 않는다
CLAUDE.md — 프로젝트 규칙 (같은 폴더에 저장)
# AI 감정 일기장 규칙 ## 만들 것 일기를 쓰면 AI가 만든 프로그램이 감정을 분석하는 웹앱. diary/ 폴더에 파일을 저장해야 하므로, 백엔드 서버를 포함할 것. ## 스킬 참조 감정 분석 작업은 반드시 Skill.md의 규칙을 따른다. ## 기능 - 일기 입력 화면: 날짜 + 오늘의 일기를 자유롭게 작성 - "분석하기" 버튼 → AI가 만든 프로그램이 감정 분류 - 주요 감정 (Skill.md의 6가지 카테고리 기준) - 감정 점수 (1~10) - 감정별 이모지 - 공감 코멘트: 일기 내용을 반영한 따뜻한 한마디 - diary/ 폴더에 YYYY-MM-DD.md 형식으로 저장 - "주간 리포트" 버튼: 최근 7일 감정 추이 그래프 - 주간 리포트를 인스타 스토리용 세로형(9:16) 이미지로 내보내기 ## 디자인 - 따뜻하고 감성적인 분위기, 연한 베이지+코럴 톤 - 한국어, 반응형 (375px에서도 정상 작동) ## 데이터 취급 규칙 - 분석 결과에 일기 원문 전체를 그대로 포함하지 않는다 - 파일명에 개인정보(이름, 전화번호 등)를 넣지 않는다 - 공감 코멘트에 일기 속 타인의 실명을 언급하지 않는다 ## 방어 규칙 - 빈 일기 제출 → 거부 + "오늘의 이야기를 적어주세요" - 일기 0건 상태에서 주간 리포트 → "아직 기록이 없습니다" 안내 - 7일 미만 주간 리포트 → 있는 날만 표시 + "N일 기록" 안내 ## ★ 완성 체크리스트 (전부 통과해야 완료) - [ ] 일기 작성 후 "분석하기" → 감정 2개 이상 추출? - [ ] 감정 점수 1~10 범위 내? - [ ] 공감 코멘트가 일기 내용을 반영? - [ ] diary/YYYY-MM-DD.md 파일 생성 확인? - [ ] 감정 카테고리가 Skill.md의 6가지 내에서만 추출? - [ ] 빈 일기 제출 → 거부 메시지? - [ ] 0건 상태 주간 리포트 → 안내 메시지? - [ ] 주간 리포트 그래프 정상 표시? - [ ] 375px 반응형 정상? → 각 항목을 실제 테스트한 과정과 증거를 보여줄 것. → 실패 시 수정 후 재검증. 전부 통과할 때까지 반복.
실행 프롬프트 — 단 두 줄
CLAUDE.md를 읽고, AI 감정 일기장을 만들어줘. 체크리스트를 전부 통과시키고 증거를 보여줘.
Skill.md를 공식 스킬로 승격 (재사용)
이 폴더의 Skill.md를 Claude Code의 공식 에이전트 스킬 형식으로 변환해서, 내 개인 스킬 폴더에 '감정분석'이라는 이름으로 설치해줘.
※ 이 프로젝트에서만 쓰려면 "개인 스킬 폴더" 대신 "이 프로젝트의 스킬 폴더"라고 말하면 됩니다.
5.4 [실습] 사내 문서 Q&A 챗봇 — RAG를 위한 준비 company-qa
프로젝트 폴더 준비 (터미널) — docs 폴더에 규정 문서(PDF/DOCX/TXT) 복사
mkdir company-qa cd company-qa
CLAUDE.md — 프로젝트 규칙 (폴더에 저장)
# 사내 문서 Q&A 시스템 규칙 ## 만들 것 사내 문서를 읽고 질문에 답하는 Q&A 시스템. Python 백엔드(Flask) + 채팅 UI 프론트엔드. ## 핵심 원리 완성된 Q&A 시스템이 docs/ 폴더에 접근하여 문서를 읽고, 질문과 관련된 부분을 찾아 답변을 생성한다. ## 기능 - docs/ 폴더의 PDF, DOCX, TXT 파일을 읽어서 내용 파악 - 웹 채팅 화면에서 질문 입력 → 관련 문서에서 답변 - 답변에 "출처: OO 문서 N페이지" 혹은 "출처: OO 문서 N항목" 등의 형태로 출처 표시 - 답변 못 찾으면: "해당 내용을 사내 문서에서 찾지 못했습니다. HR팀에 문의해 주세요." (추측 답변 금지) - 질문/답변 기록을 qa-log.txt에 날짜별 저장 ## 디자인 - 깔끔한 채팅 인터페이스, 한국어, 반응형 ## 답변 규칙 - docs/ 폴더의 문서 내용만을 근거로 답변한다 - 문서에 없는 내용은 절대 추측하지 않는다 - 답변할 때 반드시 출처(문서명, 섹션)를 명시한다 - 여러 문서에 관련 내용이 있으면 모두 인용한다 ## 방어 규칙 - 빈 질문 → "질문을 입력해 주세요" 안내 - docs/ 폴더가 비어 있을 때 → "문서가 없습니다. docs/ 폴더에 문서를 넣어주세요" 안내 - 문서에 없는 내용 질문 → "사내 문서에서 찾지 못했습니다" + 추측 금지 ## ★ 완성 체크리스트 (전부 통과해야 완료) - [ ] docs/ 폴더가 비어 있으면, 테스트 문서 2개(사내규정.txt, 휴가정책.txt) 생성? - [ ] "연차 신청은 어떻게 해?" → 정확한 답변 + 출처? - [ ] "재택근무는 주 몇 회?" → 정확한 답변 + 출처? - [ ] 문서에 없는 질문 → "찾지 못했습니다" 응답? - [ ] qa-log.txt에 질문/답변 기록 저장? - [ ] 375px 반응형 정상? → 각 항목을 실제 테스트한 과정과 증거를 보여줄 것. → 실패 시 수정 후 재검증. 전부 통과할 때까지 반복.
실행 (터미널 새 창)
cd company-qa python3 app.py # 또는 python app.py — 브라우저에서 127.0.0.1:5001 접속
통제하기 — 신뢰성 개선 (묶어서 하나의 프롬프트로)
답변 정확도를 높이기 위해, 답변할 때 원문을 인용해서 보여줘. '원문: …' 형태로. 채팅 화면 상단에 '현재 등록된 문서: N개'를 표시해줘. 그리고 문서 목록을 볼 수 있는 사이드바도 추가해줘. 문서를 추가하면 자동으로 인식하게 해줘. 그리고 체크리스트를 다시 통과시키고 증거 보여줘.
서버 실행이 안 될 때
실행 환경을 준비해서 서버를 띄워줘.
5.5 커스텀 명령어 — 반복 작업을 명령어 하나로 .claude/commands
수료증 생성 명령어 등록 (hwpx-generator 폴더의 Claude Code에서)
이 프로젝트의 수료증 생성 작업을 커스텀 명령어로 등록해줘. - 명령어 이름: 수료증 - 하는 일: STUDENT_LIST.xlsx를 읽어 수강생별 수료증 HWPX를 output 폴더에 생성하고 검증 - 방어 조건과 완성 체크리스트도 명령어 안에 포함해줘.
매출 보고서 명령어 등록 (excel-report 폴더에서)
이 프로젝트의 연간 매출 보고서 생성 작업을 /매출보고서 커스텀 명령어로 등록해줘. 요구사항, 방어 조건, 체크리스트를 모두 포함해줘.
등록 후 사용 — 대화창에서 한 줄
/수료증 /매출보고서 /감정분석 ← 명령어 안에서 Skill.md를 참조하게 만들 수도 있음
※ .claude/commands/ 폴더 안의 .md 파일이 커스텀 슬래시 명령어로 인식됩니다(공식 기능). 완료 후에는 명단 인원수와 생성 파일 수가 같은지, 핵심 숫자를 사람이 다시 확인합니다.
5.6 외부 서비스 연결 — MCP 확인 · 미니 실습
현재 연결된 MCP 확인
현재 Claude Code에 연결된 MCP가 있는지 확인해줘. 설정은 변경하지 말고, 연결된 이름과 할 수 있는 일을 한국어로 설명해줘.
[미니 실습] 1단계 — 말하기 (원본을 바꾸지 않는 검색만)
연결된 외부 서비스에서 제목에 "회의록"이 포함된 최근 자료를 찾아줘. 규칙: 1. 파일이나 메시지를 수정·이동·삭제하지 말 것 2. 먼저 자료 이름, 저장 위치, 수정 날짜만 보여줄 것 3. 내용을 읽기 전에 내가 선택하도록 기다릴 것 4. 찾지 못하면 없다고 말하고 비슷한 자료를 임의로 만들지 말 것
3단계 — 통제하기 (읽기 확인 뒤에만)
선택한 회의록을 읽고 결정 사항만 정리해줘. 각 결정 사항 아래에 근거가 된 원문을 함께 보여줘. 외부 서비스의 원본은 수정하지 말고, 결과는 현재 프로젝트 폴더에 회의록_요약.txt로 저장해줘.
※ 처음 MCP를 사용할 때는 "외부 자료는 읽기만, 결과는 내 작업 폴더에 저장" 방식이 안전합니다. 권한 요청 창은 읽고 나서 허용하세요.
5.7 [실습] 업무 자동화 통합 실습 monthly-automation
프로젝트 폴더 준비 (터미널)
mkdir monthly-automation cd monthly-automation claude
통합 프롬프트 — 세 개의 규칙 파일 + 샘플 데이터를 한 번에
월말 업무 자동화 시스템을 만들어줘. 아래 세 개의 파일을 먼저 만들어줘. ## 1. CLAUDE.md 다음 규칙으로 작성: - 이 프로젝트는 월말 업무 자동화 시스템이다 - 모든 코드의 주석은 한국어로 작성한다 - 수료증 생성은 Skill.md의 규칙을 따른다 - 파일을 삭제하기 전에 반드시 확인을 받는다 - 에러가 나면 원인을 쉬운 말로 설명한다 ## 2. Skill.md — 수료증 작성 전문가 다음 내용으로 작성: - 역할: 수강생 정보를 기반으로 수료증을 작성하는 전문가 - 수료증 형식: 제목 "수료증" (24pt 볼드, 가운데 정렬), 본문에 이름/소속/수료일, 하단에 발급 기관명 - 파일명 규칙: "수료증_홍길동.hwpx" - 금지 사항: 수강생 정보를 임의로 변경하지 않는다, 엑셀에 없는 정보를 추측하여 넣지 않는다 ## 3. .claude/commands/월말정산.md — 커스텀 명령어 다음 동작을 순서대로 실행하는 명령어: ① data/ 폴더에서 수강생명단.xlsx를 읽어 수료 대상자 확인 ② 수료 대상자 각각의 수료증(HWPX)을 output/수료증/ 폴더에 생성 ③ data/ 폴더에서 매출.xlsx를 읽어 월간 매출 보고서(PDF)를 output/보고서/ 폴더에 생성 ④ 전체 처리 결과 요약을 output/완료리포트.txt로 출력 ⑤ 진행 상황을 📌 형식으로 보여줘 방어 조건: - data/ 폴더에 엑셀 파일이 없으면 → 안내 후 종료 - 빈 이름 행 → 건너뛰고 경고 - 이미 output/ 폴더에 같은 이름의 파일이 있으면 → 덮어쓰기 전 확인 체크리스트: - [ ] 수료증 HWPX 파일이 수료 대상자 수만큼 생성? - [ ] 각 수료증의 이름/소속/수료일이 정확? - [ ] 매출 PDF 보고서가 정상 생성? - [ ] 완료리포트.txt에 전체 요약 기록? - [ ] 빈 이름 행 건너뛰기 + 경고 출력? → 각 항목을 실제 테스트한 과정과 증거를 보여줘. 그리고 테스트용 샘플 데이터도 data/ 폴더에 만들어줘: - 수강생명단.xlsx (5명 + 빈 행 1개) - 매출.xlsx (3개월분 샘플 데이터)
통제하기 — 리포트·양식 개선
완료리포트.txt에 처리 일시, 총 소요 시간도 기록해줘. 수정 후 체크리스트를 다시 전부 통과시켜줘.
수료증에 기관 로고(logo.png)를 넣어줘. PDF 보고서 상단에도 같은 로고를 넣어줘. Skill.md에 "수료증 상단에 반드시 로고를 포함한다" 규칙을 추가해줘.
다음 달부터 — 한 줄
/월말정산