---

name: archaeology-discussion description: 고고학 발굴조사보고서 고찰 자동 작성 파이프라인. "고찰 작성해줘" 한 번의 명령으로 완료된 보고서+논문+주변유적 보고서를 분석하여 문화재청 표준양식 고찰을 생성. 폴더1(주보고서), 폴더2(논문), 폴더3(비교유적)을 자동 분석. Use for automated archaeological excavation report discussion writing pipeline: analyzes main report + papers + comparison sites to generate discussion following Korean Cultural Heritage Administration standards. One command processes all folders. allowed-tools: Read, Grep, Glob

발굴조사보고서 고찰 자동 작성 스킬

🎯 핵심 기능

"고찰 작성해줘" 한 번의 명령으로 처음부터 끝까지 자동 실행

1. 📁 폴더1(완료된 발굴조사보고서) 자동 분석
2. 📄 폴더2(학술논문) 핵심 내용 추출
3. 📊 폴더3(주변 유사 유적 보고서) 비교 데이터 수집
4. ✍️ 문화재청 표준양식에 맞춰 고찰 완전 생성

📂 필수 폴더 구조

프로젝트 루트에 다음 구조로 폴더를 준비하세요:

project/
├── 1_main_report/              # 폴더1: 완료된 발굴조사보고서 (주 자료)
│   ├── report.pdf              # 또는 .docx, .hwp
│   ├── tables/                 # 표 파일들
│   │   ├── stratigraphy.csv
│   │   ├── features.csv
│   │   ├── artifacts.csv
│   │   └── dating.csv
│   ├── figures/                # 도면 목록
│   │   └── list.md
│   └── extracted/              # (자동 생성) 추출된 데이터
│
├── 2_papers/                   # 폴더2: 학술논문
│   ├── paper1.pdf
│   ├── paper2.pdf
│   └── ...
│
└── 3_comparison_sites/         # 폴더3: 주변 유사 유적 보고서
    ├── site_A_report.pdf
    ├── site_B_report.pdf
    └── ...

🚀 사용법 (한 번의 명령)

고찰 작성해줘

또는

발굴조사보고서 고찰을 작성해주세요.
폴더 1_main_report/, 2_papers/, 3_comparison_sites/를 분석하여
문화재청 표준양식에 맞춰 처음부터 끝까지 작성해주세요.

⚙️ 자동 실행 시작 조건

다음 키워드가 포함된 요청을 받으면 즉시 이 스킬을 활성화하고 자동 파이프라인을 실행합니다:

트리거 키워드

• "고찰 작성해줘" ✅
• "고찰 써줘" ✅
• "고찰 작성" ✅
• "discussion 작성" ✅
• "발굴조사보고서 고찰" ✅
• "문화재청 양식 고찰" ✅

실행 전 자동 확인

1. 폴더 존재 확인: 1_main_report/ 폴더가 있는가?
2. 보고서 파일 확인: PDF/DOCX/HWP 파일이 1개 이상 있는가?
3. 선택 폴더 확인: 2_papers/, 3_comparison_sites/ 폴더가 있는가? (선택)

실행 개시

위 조건이 만족되면 사용자에게 추가 질문 없이 Phase 1부터 자동 실행을 시작합니다.

✓ 폴더 구조 확인 완료
✓ 1_main_report/ 발견: report.pdf
✓ 2_papers/ 발견: 3개 논문
✓ 3_comparison_sites/ 발견: 5개 보고서

[Phase 1] 자료 수집을 시작합니다...

🔄 자동 파이프라인 절차

⚡ 전체 플로우 (자동 실행)

사용자 입력: "고찰 작성해줘"
    ↓
[준비] 폴더 스캔 (Glob)
    ↓
[Phase 1] 자료 수집
  → 1_main_report/ 읽기 (Read)
  → 핵심 데이터 추출 (Grep)
  → 2_papers/ 읽기
  → 3_comparison_sites/ 읽기
    ↓
[Phase 2] 고찰 생성
  → 9개 섹션 작성
  → 인용 삽입
  → 용어 통일
    ↓
[Phase 3] 검증 및 출력
  → 인용 검증
  → discussion_final.md 생성

Phase 1: 자료 수집 및 분석 (자동)

Step 1.1: 주 보고서 분석 (폴더1)

자동 실행 도구 사용 예시:

# 1. 보고서 파일 탐지 (Glob)
Glob: "1_main_report/**/*.pdf"
Glob: "1_main_report/**/*.docx"
Glob: "1_main_report/**/*.hwp"

# 2. 보고서 읽기 (Read)
Read: "1_main_report/OO유적_보고서.pdf"
→ 전체 텍스트 추출

# 3. 핵심 데이터 추출 (Grep)
Grep: pattern="유적\s*위치|소재지" in "1_main_report/*.pdf"
→ "경기도 AA시 BB구 CC동 123번지"

Grep: pattern="조사\s*면적|발굴\s*면적"
→ "5,200㎡"

Grep: pattern="조사\s*기간"
→ "2024년 3월 ~ 6월"

Grep: pattern="유구.*?호|F\d+" (유구 번호)
→ F1, F2, ..., F20 (20개 유구)

Grep: pattern="층.*?L\d+|제\d+층" (층위)
→ L1, L2, L3, L4

# 4. 표 데이터 읽기 (CSV가 있는 경우)
Glob: "1_main_report/tables/*.csv"
Read: "1_main_report/tables/features.csv"
Read: "1_main_report/tables/artifacts.csv"
Read: "1_main_report/tables/dating.csv"

# 5. 도면 목록 읽기
Read: "1_main_report/figures/list.md"

추출 결과 예시:

유적명: OO유적
위치: 경기도 AA시 BB구
면적: 5,200㎡
조사기간: 2024.03~06
유구: 주거지 8동, 수혈 12기
유물: 토기 847점, 석기 378점
연대: 1400-1300 cal BC (청동기시대 전기)

Step 1.2: 논문 분석 (폴더2)

자동 실행 도구 사용 예시:

# 1. 논문 파일 탐지 (Glob)
Glob: "2_papers/**/*.pdf"

# 2. 논문 읽기 (Read) - 각 논문별로
Read: "2_papers/김철수_2020_한강유역청동기시대취락연구.pdf"
Read: "2_papers/이영희_2018_이중구연토기편년.pdf"
Read: "2_papers/박민수_2019_석촉형식분류.pdf"

# 3. 관련 내용 추출 (Grep)
Grep: pattern="청동기시대|청동기 시대" in "2_papers/*.pdf"
Grep: pattern="한강|경기|중부지방" in "2_papers/*.pdf"
Grep: pattern="이중구연토기|무문토기" in "2_papers/*.pdf"
Grep: pattern="주거지|수혈주거" in "2_papers/*.pdf"
Grep: pattern="cal BC|BP|연대|편년" in "2_papers/*.pdf"

# 4. 저자·연도 추출 (파일명 또는 본문)
Grep: pattern="^\d{4}년|^\d{4}\.|\((\d{4})\)"
→ 저자명 + 연도 매칭

추출 결과 예시:

논문1: 김철수 2020, "한강유역 청동기시대 취락 분포와 성격"
  - 주제: 청동기 전기 취락 구조
  - 관련: 주거지 평면 형태, 공간 배치
  - 인용문: "한강 중류역 청동기시대 전기 취락은 원형 주거지 중심..."

논문2: 이영희 2018, "이중구연토기의 형식분류와 편년"
  - 주제: 토기 편년
  - 관련: 이중구연토기 형식, 시기 구분
  - 인용문: "구연 각도 120-140°는 전기 후반의 특징..."

논문3: 박민수 2019, "중부지방 석촉 형식 연구"
  - 주제: 석기 형식
  - 관련: 유경식 석촉, 제작 기법

Step 1.3: 비교 유적 분석 (폴더3)

자동 실행 도구 사용 예시:

# 1. 비교 유적 보고서 탐지 (Glob)
Glob: "3_comparison_sites/**/*.pdf"

# 2. 각 보고서 읽기 (Read)
Read: "3_comparison_sites/가평_대성리유적.pdf"
Read: "3_comparison_sites/양평_양수리유적.pdf"
Read: "3_comparison_sites/포천_자작리유적.pdf"

# 3. 핵심 정보 추출 (Grep)
# 유적 위치
Grep: pattern="유적\s*위치|소재지|location" in "3_comparison_sites/*.pdf"
→ "가평군 대성리", "양평군 양수리", ...

# 시대·시기
Grep: pattern="청동기|철기|삼국|조선|cal BC|BP"
→ "청동기시대 전기", "1400-1200 BC", ...

# 유구 정보
Grep: pattern="주거지.*?\d+동|수혈.*?\d+기"
→ "주거지 12동", "수혈 8기", ...

# 유물 정보
Grep: pattern="이중구연토기|무문토기|석촉|석도"
→ 유물 조합 파악

# 규모
Grep: pattern="면적.*?\d+.*?㎡|조사.*?면적"
→ "15,000㎡", "8,200㎡", ...

# 4. 거리 계산 (위치 좌표가 있는 경우)
# 본 유적과 비교 유적 간 거리 추정

추출 결과 예시:

비교 유적 1: 가평 대성리유적
  - 위치: 가평군 대성리 (OO유적에서 북쪽 8km)
  - 시기: 청동기 전기 (1400-1200 BC)
  - 유구: 주거지 12동 (평균 면적 16.2㎡)
  - 유물: 이중구연토기 중심, 석촉 68점
  - 특징: 원형 주거지, 밀집 배치

비교 유적 2: 양평 양수리유적
  - 위치: 양평군 양수리 (OO유적에서 동쪽 15km)
  - 시기: 청동기 전기~중기 (1500-1000 BC)
  - 유구: 주거지 18동 (평균 면적 14.5㎡)
  - 유물: 이중구연토기, 공렬문토기, 옥 제품 6점
  - 특징: 대형 취락, 지역 중심지로 추정

비교 유적 3: 포천 자작리유적
  - 위치: 포천시 자작리 (OO유적에서 북쪽 20km)
  - 시기: 청동기 전기 (1400-1200 BC)
  - 유구: 주거지 6동
  - 유물: 무문토기, 석기 소량
  - 특징: 소규모 취락

→ 비교표 자동 생성 (comparison_table.csv)

Phase 2: 고찰 생성 (자동)

Step 2.1: 문화재청 표준양식 적용

9개 섹션에 Phase 1 데이터 자동 삽입:

① 조사경위 및 연구사 (500-800자)
   ← 폴더1: 유적 위치, 조사 배경, 면적, 기간
   ← 폴더2: 지역 선행연구 (논문 인용)
   예: "OO유적은 경기도 AA시에 위치하며, DD천 상류 충적평야에 입지한다.
        본 조사는 EE고속도로 건설에 앞서 2024년 3월부터 6월까지 5,200㎡를
        발굴하였다. 이 지역은 청동기시대 취락이 밀집하는 것으로 알려져 있으나
        (김철수 2020), 개별 취락 구조 연구는 미진하였다."

② 층서 및 퇴적환경 (800-1,200자)
   ← 폴더1: 층위 구분, 토색, 토성, 문화층
   ← 폴더1 표: stratigraphy.csv
   예: "층서는 4개 층으로 구분된다(도 3, 표 1). 제1층(L1)은 현대 경작토이며,
        제3층(L3)은 암갈색(10YR 3/4) 점질토로 청동기시대 유구가 조성된 생활면이다.
        층 내 숯·토기편이 고르게 분포하여 인위적 퇴적으로 판단된다."

③ 유구 현황 및 해석 (1,500-2,500자)
   ← 폴더1: 유구 목록, 유형, 규모
   ← 폴더1 표: features.csv
   예: "주거지는 총 8동(F1-F8)이 확인되었다(표 2). 평면 형태는 원형 5동,
        타원형 3동이며, 면적은 10.2-18.7㎡(평균 13.8㎡)이다(도 5).
        주거지 F1은 직경 4.8m, 면적 18.1㎡로 본 취락의 중심 주거로 판단된다."

④ 유물 조합 및 형식 분류 (1,200-2,000자)
   ← 폴더1: 유물 통계
   ← 폴더1 표: artifacts.csv
   ← 폴더2: 형식 분류 이론 (논문 인용)
   예: "출토 유물은 총 1,247점이며, 토기 68%, 석기 30%, 골각기 2%이다(표 5).
        이중구연토기(237점)가 주를 이루고, 구연 각도 120-140°는 청동기시대 전기
        후반의 특징이다(이영희 2018)."

⑤ 연대 및 편년 (800-1,200자)
   ← 폴더1: C14 연대 결과
   ← 폴더1 표: dating.csv
   ← 폴더2: 편년 연구 (논문 인용)
   예: "주거지 F1 노지 목탄의 AMS 연대는 3,120±40 BP(Beta-567890)로,
        보정연대 1σ 범위는 1430-1380 cal BC이다(표 6). 이는 한강 유역
        청동기시대 전기 후반 편년(김철수 2020)과 부합한다."

⑥ 공간구조 및 생활상 (800-1,200자)
   ← 폴더1: 유구 배치, 분포 패턴
   예: "주거지 8동은 조사구역 북쪽에 밀집하며 평균 간격 8.5m이다(도 18).
        주거지 남쪽 20m 지점에 수혈 12기가 열상 배치되어, 주거역과 폐기역이
        구분되었음을 알 수 있다."

⑦ 주변 유적과의 비교 (1,000-1,500자)
   ← 폴더3: 비교 유적 데이터
   예: "본 유적의 주거지 평면 형태(원형)는 가평 대성리유적(8km 북쪽),
        양평 양수리유적(15km 동쪽)과 일치하여, 동일 문화권으로 판단된다(표 8).
        다만 어망추 비율(18%)이 주변 유적(평균 5%)보다 높아, 하천 어로에 특화된
        양상을 보인다."

⑧ 문화사적 의의 및 특징 (800-1,200자)
   ← 폴더1+2+3 종합
   예: "본 유적은 한강 중류역 청동기시대 전기 취락망의 일부로, 하천 자원
        활용과 광역 교역이라는 독자성을 지녔다고 평가된다."

⑨ 맺음말 (500-800자)
   ← 전체 요약 + 한계
   예: "본 조사는 청동기시대 전기 취락 구조 연구에 중요한 자료를 제공하였다.
        다만 조사 면적 제약(5,200㎡)으로 취락 전체 범위는 파악하지 못하였으며,
        식물·동물유체 분석이 미실시되어 구체적 생계 전략은 불명확하다."

Step 2.2: 논증 구조 생성

자동 실행 내용:
각 섹션마다 다음 구조 적용:
1. 주제문: 해당 섹션의 핵심 주장
2. 근거 제시: Phase 1에서 추출한 데이터 인용
   - 폴더1 데이터 → 1차 증거 (표/도 인용)
   - 폴더2 논문 → 이론적 배경 (저자 연도)
   - 폴더3 비교유적 → 지역적 맥락 (유적명)
3. 해석 및 추론: 증거→주장 논리 연결
4. 한계 명시: 불확실성, 대안 가능성
5. 소결: 다음 섹션 연결

Step 2.3: 인용 및 교차참조

자동 실행 내용:
1. 폴더1 표·도 자동 인용:
   - "표 3에서 보듯이"
   - "도 12의 주거지 평면은"
   - "유구 F5는"
2. 폴더2 논문 인용:
   - "(김OO 2020)"
   - "이OO(2018)에 따르면"
3. 폴더3 유적 비교:
   - "인근 AA유적(5km 북쪽)과 비교하면"
   - "표 10은 주변 유적 비교 결과이다"
4. 인용 일관성 자동 검증

Step 2.4: 문체 및 용어 통일

자동 실행 내용:
1. 학술적 문어체 변환:
   - "~이다/였다" (확실) vs "~로 판단된다" (추정)
   - "~가능성이 있다" (약한 추정)
2. 표준 용어 적용 (terminology_glossary.md):
   - "움집" → "수혈주거지"
   - "돌칼" → "석도" 또는 "석검"
   - "화덕자리" → "노지"
3. 정량적 표현:
   - "많다" → "68% (847점 중 576점)"
   - "크다" → "18.5㎡로 평균(13.2㎡)보다 40% 넓다"

Phase 3: 검증 및 출력 (자동)

Step 3.1: 자동 검증

자동 실행 내용:
1. 인용 검증 (cite_helper.py 실행):
   - 누락된 표·도 번호 탐지
   - 인용 빈도 불균형 경고
2. 용어 일관성 검증:
   - 동일 개념 다른 용어 사용 탐지
3. 논리 검증:
   - 주장 without 근거 탐지
   - 근거와 주장 불일치 경고
4. 분량 검증:
   - 전체 8,000-12,000자 목표
   - 섹션별 500-1,500자 권장

Step 3.2: 최종 출력

자동 생성 파일:
1. discussion_final.md        # 최종 고찰 (마크다운)
2. discussion_final.docx      # 워드 파일
3. discussion_report.txt      # 검증 보고서
4. references.txt             # 참고문헌 목록
5. comparison_table.csv       # 비교유적 표

📋 문화재청 표준양식 (2021 개정)

섹션 구성 및 필수 포함 내용

① 조사경위 및 연구사 (500-800자)

• 조사 배경 (개발사업명, 사업시행자)
• 유적 위치 (행정구역, 좌표, 지형)
• 조사 기간 및 면적
• 지역 연구사 (선행 조사 성과)
• 본 조사의 의의

② 층서 및 퇴적환경 (800-1,200자)

• 층위 구분 (제N층, LN)
• 층별 토색(Munsell), 토성, 포함물
• 문화층 식별 근거
• 형성과정 (자연/인위 퇴적)
• 교란 범위 및 영향
• 필수 인용: 토층도, 토층 사진

③ 유구 현황 및 해석 (1,500-2,500자)

• 유구 유형별 분류 (주거지, 수혈, 구, 분묘 등)
• 유구별 속성:
  • 평면·단면 형태
  • 규모 (m, ㎡)
  • 내부시설 (노지, 주혈, 저장공)
  • 출토유물 (개체수, 중량)
• 기능 해석 및 대안 검토
• 유구 간 중복관계 (선후 관계)
• 필수 인용: 유구 배치도, 개별 유구 평·단면도

④ 유물 조합 및 형식 분류 (1,200-2,000자)

• 유물 통계 (기종별 개체수, 중량, 비율)
• 토기:
  • 기종 분류 (호, 완, 배 등)
  • 형식 분류 (구연·동체·저부 형태)
  • 문양 (종류, 시문 위치)
• 석기:
  • 기종별 개체수
  • 석재 (규암, 석영, 흑요석 등)
  • 제작기법 (타제, 마제)
• 맥락별 분포 (층별, 유구별)
• 필수 인용: 유물 집계표, 대표 유물 도면

⑤ 연대 및 편년 (800-1,200자)

• 절대연대:
  • C14 연대 (BP, cal BC/AD, 1σ/2σ)
  • 시료 맥락 명시
  • 측정기관 및 번호
• 상대연대:
  • 형식연대 (토기·석기 형식)
  • 층서연대
• 교차검증 및 불일치 해석
• 최종 편년 결론
• 필수 인용: 연대측정 결과표, 편년표

⑥ 공간구조 및 생활상 (800-1,200자)

• 유구 배치 분석
• 공간 분화 (주거역, 작업역, 폐기역)
• 동선 및 취락 구조
• 생계 활동 추정 (농경, 수렵, 어로, 채집)
• 필수 인용: 유구 분포도, 밀도 분석도

⑦ 주변 유적과의 비교 (1,000-1,500자)

• 비교 유적 선정 기준 (거리, 시기, 유형)
• 유사성:
  • 공통 유구 형태
  • 공통 유물 조합
  • 동일 문화권 증거
• 차이점:
  • 규모 차이
  • 독특한 특징
  • 지역 변이
• 필수: 비교유적 일람표 (위치, 시기, 유구·유물 특징)

⑧ 문화사적 의의 및 특징 (800-1,200자)

• 지역사적 의의
• 시대적 위치
• 학술적 기여 (새로운 발견, 기존 가설 검증)
• 특수성 및 보편성

⑨ 맺음말 (500-800자)

• 주요 성과 요약 (3-5개 항목)
• 조사 한계 (면적 제약, 교란, 미실시 분석)
• 후속 과제 (추가 분석, 비교 연구)

💻 파이프라인 실행 예시

예시 1: 기본 실행

입력:

고찰 작성해줘

Claude 자동 실행 과정:

[Phase 1] 자료 수집 중...
✓ 1_main_report/ 스캔 완료: report.pdf 발견
✓ 층서 데이터 추출: 4개 층위 확인
✓ 유구 데이터 추출: 주거지 8동, 수혈 12기
✓ 유물 통계 생성: 토기 847점, 석기 378점
✓ 연대 데이터: C14 5점 (1400-1300 BC)

✓ 2_papers/ 스캔 완료: 3개 논문 발견
✓ 관련 논문 분석: "한강유역 청동기시대 취락 연구" 외 2편
✓ 인용 가능 문장 125개 추출

✓ 3_comparison_sites/ 스캔 완료: 5개 유적 보고서 발견
✓ 비교 유적 데이터 추출: 가평 대성리, 양평 양수리 외 3곳
✓ 비교표 생성 완료

[Phase 2] 고찰 생성 중...
✓ 섹션 ① 조사경위 및 연구사 (652자)
✓ 섹션 ② 층서 및 퇴적환경 (1,023자)
✓ 섹션 ③ 유구 현황 및 해석 (2,187자)
✓ 섹션 ④ 유물 조합 및 형식 분류 (1,654자)
✓ 섹션 ⑤ 연대 및 편년 (987자)
✓ 섹션 ⑥ 공간구조 및 생활상 (1,134자)
✓ 섹션 ⑦ 주변 유적과의 비교 (1,298자)
✓ 섹션 ⑧ 문화사적 의의 (1,045자)
✓ 섹션 ⑨ 맺음말 (723자)

[Phase 3] 검증 및 출력 중...
✓ 인용 검증: 표 14개, 도 25개, 유구 22개 인용 확인
✓ 용어 일관성: 문제 없음
✓ 총 10,703자 (목표 8,000-12,000자 달성)

✅ 고찰 작성 완료!
   - discussion_final.md
   - discussion_report.txt
   - references.txt

예시 2: 중간 확인 포함 실행

입력:

고찰 작성해줘. 단, 각 Phase 완료 후 결과를 보여주고 다음 단계 진행 여부를 물어봐.

Claude 실행:

[Phase 1 완료]
다음 데이터를 추출했습니다:
- 주 보고서: OO유적, 청동기시대 전기, 5,200㎡
- 주거지 8동, 평균 13.8㎡
- C14 연대: 1430-1290 cal BC (5점 평균)
- 논문 3편 (한강유역 청동기 관련)
- 비교 유적 5곳 (반경 20km)

Phase 2 (고찰 생성)를 진행할까요? (yes/no)

🎓 핵심 원칙 (문화재청 지침 기반)

1. 증거 우선순위

1순위: 1차 관찰 데이터 (폴더1 보고서) 2순위: 정량 데이터 (통계, 연대측정) 3순위: 비교 자료 (폴더3 주변유적) 4순위: 이론적 배경 (폴더2 논문)

2. 논증 구조

주장 → 근거(폴더1) → 비교(폴더3) → 이론(폴더2) → 한계 → 대안

3. 인용 원칙

• 폴더1 데이터: 표·도·유구 번호로 인용
• 폴더2 논문: (저자 연도) 형식
• 폴더3 유적: 유적명 + 거리 명시

4. 문체 원칙

• 문어체 한국어
• 3인칭 객관적 서술
• 추정 강도 표현: "~이다" > "~로 판단된다" > "~로 추정된다" > "~가능성이 있다"

⚠️ 실행 전 준비사항

1. 폴더 구조 확인

# 프로젝트 루트에서 실행
ls -la 1_main_report/
ls -la 2_papers/
ls -la 3_comparison_sites/

2. 필수 파일 확인

1_main_report/
├── report.pdf (또는 .docx, .hwp)     # 반드시 1개 이상
└── tables/                            # 선택 (있으면 우선 사용)
    ├── features.csv
    ├── artifacts.csv
    └── dating.csv

2_papers/
└── *.pdf                              # 1개 이상 권장 (없어도 실행 가능)

3_comparison_sites/
└── *.pdf                              # 1개 이상 권장 (없어도 실행 가능)

3. 파일 형식 요구사항

• PDF: 텍스트 추출 가능한 PDF (이미지 스캔 PDF는 OCR 필요)
• DOCX: MS Word 2007 이상
• HWP: 한글과컴퓨터 문서
• CSV: UTF-8 또는 EUC-KR 인코딩
• Excel: .xlsx 또는 .xls

🔍 트러블슈팅

Q1: "폴더를 찾을 수 없습니다" 오류

A: 폴더 이름을 정확히 확인하세요:

# 현재 디렉터리 확인
pwd

# 폴더 목록 확인
ls -la

# 폴더가 없으면 생성
mkdir -p 1_main_report 2_papers 3_comparison_sites

Q2: "PDF 읽기 실패" 오류

A: PDF가 텍스트 추출 가능한지 확인:

# PDF 텍스트 추출 테스트
pdftotext 1_main_report/report.pdf test.txt
cat test.txt  # 내용이 보이면 OK

Q3: "데이터가 너무 적어서 고찰 작성 불가" 경고

A: 최소 요구사항:

• 폴더1: 보고서 파일 1개 + (유구 데이터 또는 유물 데이터)
• 폴더2: 선택 (없어도 가능하나 권장)
• 폴더3: 선택 (없어도 가능하나 권장)

최소한 폴더1에 완료된 보고서가 있어야 합니다.

Q4: 고찰 분량이 너무 짧거나 길어요

A: 분량 조절 요청:

고찰 작성해줘. 전체 10,000자 이상, 각 섹션 1,000자 이상으로 상세하게 작성해줘.

또는

고찰 작성해줘. 전체 5,000자 이내로 간결하게 작성해줘.

Q5: 특정 섹션만 작성하고 싶어요

A: 섹션 지정:

고찰 중 "⑦ 주변 유적과의 비교" 섹션만 작성해줘.
3_comparison_sites/ 폴더의 유적들을 분석해서 비교표를 포함해줘.

Q6: 문화재청 양식이 아닌 다른 양식을 원해요

A: 양식 지정:

고찰 작성해줘. 단, 문화재청 양식 대신 학술논문 스타일로 작성해줘.
섹션은 서론-방법-결과-논의-결론으로 구성해줘.

📌 주의사항

1. 개인정보 및 민감정보

• 보고서에 개인정보(이름, 연락처)가 포함된 경우 자동 제거되지 않습니다
• 업로드 전에 민감정보를 제거하세요

2. 저작권

• 폴더2(논문), 폴더3(보고서)는 저작권이 있는 자료입니다
• 생성된 고찰에서 원문을 그대로 복사하지 않도록 자동 검증됩니다
• 인용은 학술적 규정에 따라 "(저자 연도)" 형식으로만 삽입됩니다

3. 검증 필수

• AI 생성 고찰은 반드시 전문가 검토 필수
• 다음 사항을 수동 확인하세요:
  • 표·도 번호와 실제 보고서 일치 여부
  • 연대 데이터 정확성
  • 비교 유적 거리 및 시기 정확성
  • 인용 논문 내용 일치 여부
  • 학술적 타당성

4. 문화재청 보고서 제출 전

• 생성된 고찰은 초안입니다
• 반드시 책임 조사자의 검토와 수정을 거쳐야 합니다
• 기관별 보고서 작성 지침을 추가로 확인하세요

📚 참고 자료

문화재청 지침

• 문화재청, 2014, 『발굴조사 보고서 작성 지침』
• 문화재청, 2021, 『발굴조사 보고서 작성 지침(개정)』
• 국립문화재연구소, 2023, 『고고학 조사 연구방법론』

관련 템플릿

• templates/discussion_outline.md: 섹션별 상세 가이드
• templates/terminology_glossary.md: 표준 용어 700+개
• examples/example_discussion.md: 완성 예시 (6,500자)

검증 도구

• scripts/cite_helper.py: 인용 검증 스크립트

python scripts/cite_helper.py discussion_final.md

🎯 체크리스트 (실행 후 확인)

내용 검증

• 9개 섹션 모두 포함
• 전체 8,000-12,000자 범위
• 섹션별 500-1,500자 권장 준수
• 문화재청 표준양식 준수

인용 검증

• 폴더1 표·도 인용 (최소 10회)
• 폴더2 논문 인용 (있는 경우 최소 3회)
• 폴더3 유적 비교 (있는 경우 최소 2곳)
• 인용 형식 일관성

논증 검증

• 각 주장에 근거 뒷받침
• 대안 해석 제시 (최소 2-3곳)
• 한계 명시 (맺음말 섹션)
• 정량적 데이터 활용 (비율, 개체수)

문체 검증

• 문어체 한국어
• 객관적 서술 ("~로 판단된다")
• 용어 일관성 (표준 용어 사용)
• 중복 최소화

최종 출력 확인

• discussion_final.md 생성
• discussion_report.txt 생성 (검증 보고서)
• references.txt 생성 (참고문헌)
• comparison_table.csv 생성 (비교유적 있는 경우)

📖 템플릿 및 예시

상세 작성 템플릿

더 자세한 섹션별 작성 가이드는 다음 파일을 참조하세요:

• templates/discussion_outline.md

용어 사전

표준 고고학 용어 700+개:

• templates/terminology_glossary.md

완성 예시

가상 유적 "OO유적" 고찰 전문 (6,500자):

• examples/example_discussion.md

버전 정보

• v2.0.0 (2025-11-11): 자동화 파이프라인 추가
  • 3개 폴더 자동 분석
  • 문화재청 표준양식 2021 적용
  • 한 번의 명령으로 전체 실행
• v1.0.0 (2025-11-11): 초기 릴리스

---

면책조항: 이 스킬은 고찰 초안 작성을 지원하는 AI 도구입니다. 생성된 내용의 학술적 정확성과 타당성은 전문 고고학자의 검토를 거쳐야 하며, 최종 책임은 보고서 작성자에게 있습니다. 문화재청 제출용 보고서는 반드시 책임 조사자의 검수를 받으세요