[Claude]4.Code 실전

## 양식 파괴 대응 전략 - 항목명이 정확히 일치하지 않아도 유사 표현으로 매핑할 것 예: "참가 학생 수" → 실제 참여인원, "운영 기간" → 운영기간 - 항목을 찾지 못한 경우 빈칸으로 처리하고 로그에 기록 - 표 구조가 무너진 경우 전체 텍스트에서 정규식으로 숫자 추출 시도 - 이미지 기반 내용이 감지되면 OCR 처리 후 재시도 - 처리 실패 파일은 처리로그.txt에 파일명 + 실패 사유 기록

양식이 변형된 파일도 있어. 항목명이 다르거나 표 구조가 바뀐 경우에도 최대한 내용을 추출하는 유연한 로직으로 만들어줘. 추출 실패 항목은 빈칸 처리하고 로그에 남겨줘.

# AutoDocMerge — 업무 지시서 > 자공고2.0 부서별 프로그램 운영결과 문서를 자동 취합하고 보고서를 생성하는 AI 직원입니다. > 선생님들에게 배포할 목적으로 제작됩니다. 이 파일을 읽고 일합니다. 가볍게 유지하세요. --- ## 프로젝트 기술 스택 | 구성 요소 | 파일 타입 | 역할 | |---|---|---| | AI 지시서 | `CLAUDE.md` | Claude Code가 읽는 매뉴얼 | | 학교 설정 | `school-config.md` | 사람이 편집하는 설정 파일 | | 파서 도구 | `tools/parse_hwpx.py` 등 | hwpx / hwp / pdf 파싱 | | 취합·통계 | `tools/merge_stats.py` | 엑셀 집계표 생성 | | 보고서 생성 | `tools/make_report.py` | hwpx 보고서 생성 | | 실행 진입점 | `run.py` | 더블클릭 실행 (비개발자용) | | 사용법 안내 | `README.md` | 배포용 설치·사용 가이드 | | 환경변수 | `.env` | API 키 보관 (절대 공유 금지) | **배포 목표**: `run.py` 더블클릭 한 번으로 전체 실행 가능하도록 설계. 추후 `PyInstaller`로 `.exe` 단일 파일 패키징도 고려. --- ## 핵심 규칙 1. **플랜 먼저** — 바로 실행하지 말고 계획서 먼저 보여주기 2. **원본 파일 절대 수정 금지** — 결과물은 `output/` 폴더에만 저장 3. **파싱 실패 시 로그 기록 후 계속 진행** — 멈추지 않기 4. **`sample/` 없으면 작업 중단** — "sample/ 폴더에 기준 양식을 넣어주세요" 안내 5. **숫자 추출 시 단위 문자 제거** — '명', '시간', '일' 등 제거, UTF-8 유지 6. **결과물은 `output/` 폴더에만 저장** 7. **비개발자 배포 전제** — 코드 설명 없이 결과물과 다음 할 일만 안내 --- ## 기능 00: 초기화 "초기화해줘"라고 하면 아래 순서대로 실행한다. **폴더 및 파일 생성 (Windows PowerShell)** ```powershell mkdir AutoDocMerge cd AutoDocMerge mkdir input, output, sample, tools ``` **`school-config.md` 생성** ```markdown # 학교 설정 - 학교명: - 담당 부서: - 담당자: - 연락처: - 보고서 기준연도: ``` **`run.py` 생성** — 비개발자가 더블클릭으로 실행하는 진입점 ```python # run.py — 더블클릭으로 실행하세요 # 실행하면 메뉴가 나타납니다 from tools.merge_stats import run_merge from tools.make_report import run_report print("=" * 40) print(" AutoDocMerge — 자공고2.0 문서 취합기") print("=" * 40) print("1. 문서 취합 · 통계 (기능 01)") print("2. 연구학교 보고서 생성 (기능 04)") print("3. 사용법 안내 보기 (기능 05)") print("0. 종료") print("-" * 40) choice = input("번호를 입력하세요: ").strip() if choice == "1": run_merge() elif choice == "2": run_report() elif choice == "3": from tools.guide import run_guide run_guide() else: print("종료합니다.") ``` **완료 보고** ``` 초기화가 완료되었습니다! 📁 생성된 구조: AutoDocMerge/ ├── input/ ← 부서별 제출 파일 (.hwp / .hwpx / .pdf) ├── output/ ← 결과물 저장 ├── sample/ ← ★ 기준 양식 파일 (반드시 넣어주세요) ├── tools/ ← 자동 생성 스크립트 ├── run.py ← 더블클릭으로 실행 └── school-config.md ← 학교 정보 입력 다음으로 해주실 것: 1. school-config.md에 학교 정보를 채워주세요. 2. sample/ 폴더에 기준 양식 파일(.hwpx)을 넣어주세요. 3. input/ 폴더에 부서별 제출 파일을 모두 넣어주세요. 4. 준비되면 "문서 취합해줘"라고 말씀해주세요! ``` --- ## 기능 01: 문서 취합 · 통계 "문서 취합해줘" 또는 "통계 내줘"라고 하면 실행한다. `run.py` 메뉴 1번과 동일하다. ### 파일 형식별 처리 | 형식 | 처리 방법 | |---|---| | `.hwpx` | `zipfile` + `xml` 파싱 (python-hwpx 없으면 직접 파싱) | | `.hwp` | `hwp5` 라이브러리 우선, 실패 시 텍스트 추출 fallback | | `.pdf` | `pdfplumber` 우선, 실패 시 `PyMuPDF` fallback | ### 추출 대상 항목 (sample/ 기준 양식 구조 따름) - 프로그램명 / 운영장소 / 대상 학년 - 계획 참가인원 (숫자만) / 실제 참여인원 (숫자만) - 총 운영시간 (숫자만) / 운영기간 / 부서명 (파일명에서 추출) ### 양식 파괴 대응 - 항목명이 정확히 일치하지 않아도 유사 표현으로 매핑할 것 - 예: "참가 학생 수" → 실제 참여인원, "운영 기간" → 운영기간 - 표 구조가 무너진 경우 전체 텍스트에서 정규식으로 숫자 추출 시도 - 이미지 기반 내용이 감지되면 OCR 처리 후 재시도 - 항목을 찾지 못하면 빈칸 처리 후 오류 시트 + 처리로그.txt에 파일명 + 실패 사유 기록 ### Claude에게 줄 추가 지시 (작업 중 문제 발생 시) ``` 양식이 변형된 파일도 있어. 항목명이 다르거나 표 구조가 바뀐 경우에도 최대한 내용을 추출하는 유연한 로직으로 만들어줘. 추출 실패 항목은 빈칸 처리하고 로그에 남겨줘. ``` ### 출력물 — `output/통합통계.xlsx` (시트 3개) **시트 1: 집계표** - 부서별 항목 집계표 + 합계행 - 추출 실패 항목은 빈칸, 배경색 노란색으로 표시 **시트 2: 오류·확인 필요사항** | 파일명 | 부서명 | 오류 유형 | 상세 내용 | 확인 필요 항목 | |---|---|---|---|---| | 진로부_캠프.hwp | 진로부 | 양식 변형 | "참가 학생 수" → 매핑 처리 | 실제 참여인원 재확인 요망 | | 정보부_로봇.pdf | 정보부 | 파싱 실패 | 이미지 기반 PDF | 전체 항목 수동 확인 요망 | 오류 유형 분류: - `파싱 실패` — 파일 자체를 열지 못함 - `양식 변형` — 항목명이 기준 양식과 다름 - `항목 누락` — 해당 항목이 파일에 없음 - `값 이상` — 숫자가 아닌 값 또는 범위 초과 **시트 3: 처리로그** - 파일명 / 처리 시각 / 결과(성공·실패) / 사용한 파서 / 비고 --- ## 기능 04: 연구학교 보고서 "보고서 써줘" 또는 "운영결과 정리해줘"라고 하면 실행한다. `run.py` 메뉴 2번과 동일하다. ### 사전 확인 - `output/통합통계.xlsx`가 있으면 자동 참조 - 없으면 "먼저 '문서 취합해줘'를 실행해주세요" 안내 후 중단 ### 실행 순서 1. `school-config.md`에서 학교 정보 자동 반영 2. `output/통합통계.xlsx` 집계표 시트 데이터를 섹션별로 자동 채우기 3. 오류·확인 필요사항 시트에 미확인 항목이 있으면 보고서 생성 전 경고 출력 ``` ⚠ 확인이 필요한 항목이 N건 있습니다. output/통합통계.xlsx → [오류·확인 필요사항] 시트를 먼저 검토해주세요. 그래도 계속 진행할까요? (예 / 아니오) ``` 4. 플랜 먼저 제출 → 확인 받으면 문서 생성 5. `output/보고서_초안.hwpx` 저장 - `.hwpx` 생성 불가 시 `zipfile + XML` 방식으로 직접 생성 - 그것도 불가 시 `output/보고서_초안.docx` 로 fallback 후 사유 안내 ### 보고서 기본 섹션 (자공고2.0 양식 기준) 1. 프로그램 운영 개요 2. 참여 인원 통계 (기능 01 집계표 자동 삽입) 3. 프로그램별 운영 내용 요약 4. 성과 및 개선사항 --- ## 기능 05: 사용법 안내 "사용법 알려줘" 또는 `run.py` 메뉴 3번 실행 시 동작한다. 배포받은 선생님이 처음 실행했을 때 친절하게 안내하는 기능이다. ### 출력 내용 (터미널 또는 README.md 파일) ``` ======================================== AutoDocMerge 사용법 안내 ======================================== ■ 이 프로그램은 무엇인가요? 부서별로 따로 제출된 한글 문서(.hwp/.hwpx)와 PDF를 자동으로 읽어서 통계 엑셀과 보고서를 만들어주는 도구입니다. ■ 처음 사용하시나요? 이 순서대로 하세요. [준비] 1. school-config.md 파일을 메모장으로 열어 학교명, 담당 부서, 담당자 정보를 입력하세요. 2. sample/ 폴더에 기준이 되는 양식 파일(.hwpx) 하나를 넣으세요. → 이 파일을 기준으로 항목을 인식합니다. 3. input/ 폴더에 각 부서에서 받은 파일을 모두 넣으세요. (.hwp / .hwpx / .pdf 섞여도 됩니다) [실행] 4. run.py를 더블클릭하세요. 5. 메뉴에서 1번(문서 취합)을 선택하세요. 6. output/통합통계.xlsx 를 열어 결과를 확인하세요. 7. 오류·확인 필요사항 시트에 노란색 항목이 있으면 해당 원본 파일을 직접 열어 확인해주세요. 8. 메뉴에서 2번(보고서 생성)을 선택하면 output/보고서_초안.hwpx 가 만들어집니다. ■ 주의사항 ⚠ input/ 폴더의 원본 파일은 절대 수정되지 않습니다. ⚠ 결과물은 항상 output/ 폴더에만 저장됩니다. ⚠ sample/ 폴더가 비어 있으면 프로그램이 작동하지 않습니다. ⚠ 파일명에 부서명을 포함해주세요. 예) 교무부_해커톤.hwpx, 진로부_캠프.pdf ■ 자주 묻는 질문 Q. .hwp 파일이 안 읽혀요. A. output/처리로그.txt 를 열어 실패 사유를 확인하세요. 해당 파일만 .hwpx 또는 .pdf로 변환 후 다시 시도해보세요. Q. 항목이 빈칸으로 나와요. A. 해당 부서 파일의 양식이 기준 양식과 다를 수 있습니다. output/통합통계.xlsx → [오류·확인 필요사항] 시트를 확인하세요. Q. 보고서 글자가 깨져요. A. 한글 프로그램(HWP)에서 .hwpx 파일을 열어주세요. 없으면 output/보고서_초안.docx 파일을 사용하세요. ======================================== 문의: school-config.md 에 입력한 담당자 연락처 ======================================== ``` ### README.md 자동 생성 초기화 시 위 내용을 바탕으로 `README.md` 파일도 함께 생성한다. 배포 시 선생님들이 파일을 열어 바로 읽을 수 있도록 마크다운 형식으로 작성한다. --- ## 파일 구조 ``` AutoDocMerge/ ├── CLAUDE.md ← 이 파일 (AI 지시서) ├── school-config.md ← 학교 설정 ├── README.md ← 배포용 사용법 안내 (초기화 시 생성) ├── run.py ← 실행 진입점 (더블클릭) ├── .env ← API 키 보관 (절대 공유 금지) ├── input/ ← 부서별 제출 파일 (.hwp / .hwpx / .pdf) ├── output/ │ ├── 통합통계.xlsx ← 집계표 + 오류·확인 필요사항 + 처리로그 │ └── 보고서_초안.hwpx ← 최종 보고서 (fallback: .docx) ├── sample/ ← 기준 양식 파일 └── tools/ ├── parse_hwpx.py ← .hwpx 파서 ├── parse_hwp.py ← .hwp 파서 ├── parse_pdf.py ← .pdf 파서 ├── merge_stats.py ← 취합·통계 (기능 01) ├── make_report.py ← 보고서 생성 (기능 04) └── guide.py ← 사용법 안내 (기능 05) ``` --- ## 작업 톤 - 선생님한테 보고하듯이 결과물 전달 - "~했습니다" "~만들었습니다" 식으로 - 코드 설명 하지 않기 — 결과물과 다음 할 일만 안내 - 오류 발생 시 "어떤 파일에서 어떤 문제"인지 쉽게 설명 - 전문 용어는 괄호 안에 쉬운 설명 추가

모델 출력 → 평가/필터링 → 학습 데이터로 재활용 → 더 나은 모델 ↑___________________________________|

지금까지의 작업을 바탕으로 CLAUDE.md를 최적화 해서 저장해. 특히 어떤 부분을 업데이트했는지 업데이트 내용.txt파일을 생성해

# AutoDocMerge — 업무 지시서 > 자공고2.0 부서별 프로그램 운영결과 문서를 자동 취합하고 보고서를 생성하는 AI 직원입니다. > 선생님들에게 배포할 목적으로 제작됩니다. 이 파일을 읽고 일합니다. 가볍게 유지하세요. --- ## 프로젝트 기술 스택 | 구성 요소 | 파일 타입 | 역할 | |---|---|---| | AI 지시서 | `CLAUDE.md` | Claude Code가 읽는 매뉴얼 | | 학교 설정 | `school-config.md` | 사람이 편집하는 설정 파일 | | 파서 도구 | `tools/parse_hwpx.py` 등 | hwpx / hwp / pdf 파싱 | | 취합·통계 | `tools/merge_stats.py` | 엑셀 집계표 생성 | | 보고서 생성 | `tools/make_report.py` | hwpx 보고서 생성 | | 실행 진입점 | `run.py` | 더블클릭 실행 (비개발자용) | | 사용법 안내 | `README.md` | 배포용 설치·사용 가이드 | | 환경변수 | `.env` | API 키 보관 (절대 공유 금지) | | 의존성 목록 | `requirements.txt` | `pip install -r requirements.txt` | **배포 목표**: `run.py` 더블클릭 한 번으로 전체 실행 가능하도록 설계. --- ## 핵심 규칙 1. **플랜 먼저** — 바로 실행하지 말고 계획서 먼저 보여주기 2. **원본 파일 절대 수정 금지** — 결과물은 `output/` 폴더에만 저장 3. **파싱 실패 시 로그 기록 후 계속 진행** — 멈추지 않기 4. **`sample/` 없으면 작업 중단** — "sample/ 폴더에 기준 양식을 넣어주세요" 안내 5. **숫자 추출 시 단위 문자 제거** — '명', '시간', '일' 등 제거 후 마지막 숫자 또는 단위 직전 숫자 추출 6. **결과물은 `output/` 폴더에만 저장** 7. **비개발자 배포 전제** — 코드 설명 없이 결과물과 다음 할 일만 안내 8. **중복 파일 처리** — 동일 파일명의 hwpx+hwp 동시 존재 시 hwpx 우선 처리 --- ## 실제 양식 구조 (sample/ 분석 결과) `[양식]25년 자공고2.0 부서별 프로그램 운영결과 통계(서식).hwp` 기준 ### 표 내부 항목명 (header → FIELD_ALIASES 매핑) | 양식 항목명 | FIELD 키 | 비고 | |---|---|---| | 프로그램명 | `프로그램명` | | | 특이사항 | `특이사항` | | | 운영장소 | `운영장소` | | | 대상 | `대상학년` | "대상학년", "참가대상" 등도 매핑 | | 참가인원 | `계획참가인원` | "참가인원" 별칭 포함 | | 운영일정 | `운영기간` | "운영일정", "사업기간" 별칭 포함 | | 성취기준(강의목표) | (추출 대상 아님) | | ### 표 밖 별도 기재 항목 | 텍스트 패턴 | FIELD 키 | |---|---| | `실제 참여인원: N명` | `실제참여인원` | | `총 운영시간: N시간` | `총운영시간` | ### FIELD_ALIASES 설계 원칙 - `"프로그램"` 단독 별칭 **제외** — "프로그램 운영결과" 제목에 오매핑됨 - `"참여인원"` 단독 별칭 **제외** — "실제 참여인원"에 오매핑됨 - 숫자 필드는 단위 직전 숫자 우선 추출 (예: "43명" → 43, "2~3학년 43명" → 43) --- ## 파서 동작 방식 (기능 01) ### .hwp 파일 — parse_hwp.py ``` 1순위: hwp5proc xml → 표 셀 텍스트까지 추출 (핵심) hwp5proc 경로: APPDATA/Python/PythonXXX/Scripts/hwp5proc.exe 표 구조: <hp:tbl> → <hp:tr> → <hp:tc> → <hp:subList> → <hp:t> 2순위: hwp5txt fallback (표는 <표>로 치환 — 데이터 손실) 3순위: olefile PrvText 스트림 (UTF-16LE 디코딩) ``` **주의**: hwp5txt는 표 내용을 `<표>`로 치환하여 핵심 데이터 손실. 반드시 hwp5proc xml 우선 사용. ### .hwpx 파일 — parse_hwpx.py ``` 방식: zipfile 열기 → Contents/*.xml → ET.fromstring() → elem.text 수집 주의: ET.parse(stream) 사용 금지 — 네임스페이스 처리 오류 발생 텍스트 태그: {http://www.hancom.co.kr/hwpml/2011/paragraph}t ``` ### .pdf 파일 — parse_pdf.py ``` 1순위: pdfplumber — 표 셀 포함 텍스트 추출 (extract_tables + extract_text) 2순위: PyMuPDF(fitz) fallback ``` ### 파일 형식 우선순위 ``` 동일 파일명 존재 시: .hwpx > .hwp > .pdf ``` --- ## 기능 01: 문서 취합 · 통계 "문서 취합해줘" 또는 "통계 내줘"라고 하면 실행한다. ### 출력물 — `output/통합통계.xlsx` (시트 3개) **시트 1: 집계표** | 부서명 | 프로그램명 | 운영장소 | 대상학년 | 계획참가인원 | 실제참여인원 | 총운영시간 | 운영기간 | 특이사항 | - 추출 실패 항목은 빈칸 + 노란색 배경 - 마지막 행: 숫자 필드 합계 **필수 항목** (빈칸 시 오류시트 기록): 프로그램명, 운영장소, 대상학년, 운영기간 **선택 항목** (없어도 오류 아님): 총운영시간, 특이사항 **시트 2: 오류·확인 필요사항** | 파일명 | 부서명 | 오류유형 | 상세내용 | 확인필요항목 | 오류 유형: `파싱 실패` / `항목 누락` / `양식 변형` / `값 이상` **시트 3: 처리로그** | 파일명 | 처리시각 | 결과 | 사용파서 | 비고 | ### 부서명 추출 규칙 1. 파일명에 `_` 포함 → `_` 앞 텍스트 (예: `교무부_해커톤.hwpx` → `교무부`) 2. 파일명에 `_` 없음 → 마지막 괄호 안 텍스트 (예: `...(사제동행 독서토론).hwp` → `사제동행 독서토론`) - `"보고서 작성용"` 같은 행정 표현은 제외 --- ## 기능 04: 연구학교 보고서 "보고서 써줘" 또는 "운영결과 정리해줘"라고 하면 실행한다. ### 사전 확인 - `output/통합통계.xlsx`가 없으면 중단 후 안내 - 오류·확인 필요사항이 있으면 계속 진행 여부 확인 ### hwpx 생성 방식 ``` 1. input/*.hwpx 중 첫 번째 파일을 베이스 템플릿으로 사용 2. Contents/section0.xml 교체 (secPr 첫 단락은 보존) 3. Preview/PrvText.txt 교체 4. BinData/(이미지) 제외 5. 나머지 파일 그대로 복사 ``` ### section0.xml 핵심 구조 규칙 ``` hs:sec (루트) └── hp:p (첫 단락: secPr — 페이지 설정, 반드시 템플릿에서 복사) └── hp:p (텍스트 단락) └── hp:run [charPrIDRef="0~12"] └── hp:t └── hp:linesegarray └── hp:p (표를 담는 단락) └── hp:run [charPrIDRef="0"] └── hp:tbl ← 반드시 hp:p > hp:run 안에 위치! [hp:sz, hp:pos(treatAsChar="1"), hp:outMargin, hp:inMargin] └── hp:tr └── hp:tc [borderFillIDRef="3"] └── hp:subList └── hp:p > hp:run > hp:t └── hp:cellAddr, hp:cellSpan, hp:cellSz, hp:cellMargin └── hp:linesegarray (vertsize = 표 높이 추정값) ``` **금지사항**: - `hp:tbl`을 `hs:sec` 직접 자식으로 놓으면 표가 보이지 않음 - `hp:td` 사용 금지 — hwpx는 `hp:tc` 사용 - `borderFillIDRef`는 해당 템플릿의 header.xml에 정의된 ID만 사용 (공학스쿨.hwpx: 1~5) - `charPrIDRef`는 템플릿 header.xml 정의 범위 내 사용 (공학스쿨.hwpx: 0~12) - `ET.parse(stream)` 사용 금지 → `ET.fromstring(raw.decode(...))` 사용 ### 보고서 기본 섹션 1. 프로그램 운영 개요 (학교명, 담당자, 총계) 2. 프로그램별 운영개요 표 × N개 (프로그램명/특이사항/운영장소/대상/참가인원/운영일정) 3. 성과 및 개선사항 (담당자 직접 작성) --- ## 기능 05: 사용법 안내 "사용법 알려줘" 또는 `run.py` 메뉴 3번 실행 시 동작. --- ## 파일 구조 ``` AutoDocMerge/ ├── CLAUDE.md ← 이 파일 (AI 지시서) ├── school-config.md ← 학교 설정 (담당자·연락처는 배포 시 빈칸) ├── README.md ← 배포용 사용법 안내 ├── run.py ← 실행 진입점 (더블클릭) ├── requirements.txt ← pip install -r requirements.txt ├── .gitignore ← .env, output/, __pycache__/ 등 제외 ├── .env ← API 키 보관 (절대 공유 금지, 현재 미사용) ├── input/ ← 부서별 제출 파일 (.hwp / .hwpx / .pdf) ├── output/ │ ├── 통합통계.xlsx ← 집계표 + 오류시트 + 처리로그 │ └── 보고서_초안.hwpx ← 최종 보고서 ├── sample/ ← 기준 양식 파일 (.hwp 또는 .hwpx) └── tools/ ├── parse_hwpx.py ← .hwpx 파서 (ET.fromstring 방식) ├── parse_hwp.py ← .hwp 파서 (hwp5proc xml 우선) ├── parse_pdf.py ← .pdf 파서 (pdfplumber 우선) ├── merge_stats.py ← 취합·통계 (기능 01) ├── make_report.py ← 보고서 생성 (기능 04) └── guide.py ← 사용법 안내 (기능 05) ``` --- ## 알려진 한계 및 대응 | 상황 | 원인 | 대응 | |---|---|---| | hwp 파일 표 데이터 일부 누락 | hwp5proc xml이 일부 표 구조를 `<hp:tc>` 대신 다른 형태로 저장 | odt 변환 후 재시도 또는 수동 입력 | | hwpx 텍스트 추출 실패 | ET.parse(stream) 네임스페이스 오류 | ET.fromstring 사용 (이미 수정됨) | | 양식 변형 파일 항목 누락 | 자유 서술 형식 또는 항목명 상이 | 오류시트 확인 후 수동 입력 | | hwpx 보고서에 표 배경색 없음 | header.xml에 정의된 BorderFill ID만 사용 가능 | 한글에서 직접 서식 적용 | | 보고서 저장 PermissionError | 파일이 한글에서 열려 있음 | 한글을 먼저 닫고 재실행 | --- ## 보안 주의사항 - `.env` 파일은 `.gitignore`에 포함됨 — 절대 공유·커밋 금지 - `school-config.md` 배포 시 담당자·연락처 빈칸 확인 - `output/` 폴더는 `.gitignore`에 포함 — 개인정보 포함 가능 - `subprocess` 호출 시 리스트 형태 사용 (셸 인젝션 방지됨) - XML 파싱 시 학내 파일만 처리 (XXE 위험 현실적으로 낮음) --- ## 작업 톤 - 선생님한테 보고하듯이 결과물 전달 - "~했습니다" "~만들었습니다" 식으로 - 코드 설명 하지 않기 — 결과물과 다음 할 일만 안내 - 오류 발생 시 "어떤 파일에서 어떤 문제"인지 쉽게 설명 - 전문 용어는 괄호 안에 쉬운 설명 추가