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

"고찰 작성해줘" 한 번의 명령으로 문화재청 표준양식 고찰을 자동 생성

🎯 핵심 기능

⚡ 완전 자동화 파이프라인

"고찰 작성해줘" 입력
    ↓
1. 폴더1 (완료된 보고서) 자동 분석 📁
2. 폴더2 (학술논문) 핵심 내용 추출 📄
3. 폴더3 (주변 유적 보고서) 비교 데이터 수집 📊
    ↓
문화재청 표준양식 고찰 완성! ✍️

🚀 주요 특징

✅ 한 번의 명령으로 전체 실행: 복잡한 절차 없이 "고찰 작성해줘"만 입력
✅ 3개 폴더 자동 분석: 주보고서 + 논문 + 비교유적을 자동으로 종합
✅ 문화재청 2021 표준양식: 9개 섹션 자동 생성
✅ 증거 기반 논증: 주장-근거-한계-대안 구조
✅ 자동 인용: 표/도/유구 번호, 논문, 비교 유적 자동 인용
✅ 안전한 읽기 전용: Read, Grep, Glob만 사용

설치 및 활성화

프로젝트 스킬로 설치 (팀과 공유)

# 이 디렉터리를 프로젝트에 복사
cp -r .claude/skills/archaeology-discussion /path/to/your/project/.claude/skills/

# Git에 커밋
cd /path/to/your/project
git add .claude/skills/archaeology-discussion
git commit -m "Add archaeology discussion skill"
git push

개인 스킬로 설치

# 홈 디렉터리로 복사
cp -r .claude/skills/archaeology-discussion ~/.claude/skills/

활성화 확인

Claude Code를 시작하고 다음과 같이 질문하세요:

발굴조사 고찰 작성을 도와줄 수 있나요?

또는

What skills are available?

스킬이 제대로 로드되면 Claude가 자동으로 이 스킬을 사용하여 응답합니다.

📂 폴더 준비 (필수)

3개 폴더 구조

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

your_project/
├── 1_main_report/              # 폴더1: 완료된 발굴조사보고서 (필수)
│   ├── report.pdf
│   └── tables/                 # 선택
│       ├── features.csv
│       ├── artifacts.csv
│       └── dating.csv
│
├── 2_papers/                   # 폴더2: 학술논문 (선택)
│   ├── 김OO_2020_논문.pdf
│   └── 이OO_2018_논문.pdf
│
└── 3_comparison_sites/         # 폴더3: 주변 유적 보고서 (선택)
    ├── 가평_대성리유적.pdf
    └── 양평_양수리유적.pdf

최소 요구사항

반드시 필요: 폴더1 + 보고서 PDF 1개

1_main_report/
└── OO유적_발굴조사보고서.pdf

이것만으로도 실행 가능합니다!

권장 구성

최상의 결과: 폴더1 + CSV 표 + 폴더2 논문 + 폴더3 비교유적

1_main_report/
├── report.pdf
└── tables/
    ├── features.csv
    ├── artifacts.csv
    └── dating.csv
2_papers/
├── paper1.pdf
└── paper2.pdf
3_comparison_sites/
├── site_A.pdf
└── site_B.pdf

📖 상세 가이드: templates/folder_structure_guide.md

🚀 사용법

1️⃣ 기본 사용 (한 번의 명령)

고찰 작성해줘

끝! 이 한 문장으로 모든 것이 자동 실행됩니다.

실행 과정 예시

[Phase 1] 자료 수집 중...
✓ 1_main_report/ 스캔: report.pdf 발견
✓ 층서 4개, 유구 8동, 유물 1,247점 추출
✓ 2_papers/ 스캔: 논문 3편 발견
✓ 3_comparison_sites/ 스캔: 비교 유적 5곳 발견

[Phase 2] 고찰 생성 중...
✓ ① 조사경위 및 연구사 (652자)
✓ ② 층서 및 퇴적환경 (1,023자)
✓ ③ 유구 현황 및 해석 (2,187자)
...
✓ ⑨ 맺음말 (723자)

[Phase 3] 검증 및 출력...
✓ 인용: 표 14개, 도 25개, 유구 22개
✓ 총 10,703자 (목표 달성)

✅ 완료! discussion_final.md 생성

2️⃣ 분량 조절

고찰 작성해줘. 전체 15,000자 이상으로 상세하게 작성해줘.

또는

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

3️⃣ 특정 섹션만 작성

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

4️⃣ 중간 확인하며 실행

고찰 작성해줘. 단, 각 Phase 완료 후 결과를 보여주고 다음 단계 진행 여부를 물어봐.
- 근거 부족한 주장 표시
- 표/도 인용 누락 보완
- 용어 일관성 점검
- 중복 문장 압축

[초안 텍스트 붙여넣기...]

입력 데이터 준비

필수 파일

프로젝트에 다음 구조로 데이터를 준비하세요:

project/
├── data/
│   ├── site_notes.md          # 조사 개요, 환경, 연구사
│   └── references.md          # 비교문헌 메모 (선택)
├── tables/
│   ├── stratigraphy.md        # 층위, 토양, 형성과정
│   ├── features.csv           # 유구 목록 (번호, 유형, 규모, 층위, 유물)
│   ├── artifacts.csv          # 유물 집계 (맥락, 품목, 개수, 중량, 비율)
│   └── dating.csv             # 연대 (시료코드, 방법, 결과, 오차, 맥락)
└── figures/
    └── list.md                # 표·도 번호와 설명

입력 파일 예시

tables/features.csv

번호,유형,평면형태,규모(m),면적(㎡),층위,유물수,비고
F1,주거지,원형,4.8,18.1,L3,267,노지+주혈4
F2,주거지,타원형,4.2×3.5,11.5,L3,89,노지+주혈4
F3,수혈,원형,1.2,1.1,L3,23,저장공

tables/artifacts.csv

맥락,토기,석기,골각기,합계,비율(%)
F1,189,64,14,267,21.4
F2,76,11,2,89,7.1
F3,18,5,0,23,1.8
L3,234,56,3,293,23.5
합계,847,378,22,1247,100

tables/dating.csv

시료코드,유구,시료,방법,결과(BP),오차,보정연대(1σ),보정연대(2σ)
Beta-567890,F1,목탄,AMS,3120,40,1430-1380 cal BC,1450-1320 cal BC
Beta-567891,F3,목탄,AMS,3085,35,1400-1320 cal BC,1420-1280 cal BC

디렉터리 구조

archaeology-discussion/
├── SKILL.md                       # 메인 스킬 정의 (필수)
├── README.md                      # 이 파일
├── templates/
│   ├── discussion_outline.md     # 9개 섹션별 작성 템플릿
│   └── terminology_glossary.md   # 고고학 표준 용어집
├── examples/
│   └── example_discussion.md     # 완성된 고찰 예시 (6,500자)
└── scripts/
    └── cite_helper.py            # 인용 검증 스크립트

주요 파일 설명

SKILL.md

스킬의 핵심 파일. Claude가 이 파일을 읽고 고찰 작성 방법을 학습합니다.

포함 내용:

9개 섹션 구조 (연구배경, 층서, 유구, 유물, 연대, 공간, 비교, 보존, 한계)
주장-근거-한계-대안 논증 구조
교차참조 형식 (표 N, 도 N, 유구 FN, 층 LN)
증거 우선순위 (1차 관찰 > 정량 데이터 > 연대측정 > 비교문헌)

templates/discussion_outline.md

각 섹션별 세부 작성 가이드.

포함 내용:

섹션별 목적, 포함 내용, 작성 예시, 체크포인트
단락 구조 템플릿 (주제문 → 증거 → 추론 → 한계 → 대안)
문체 가이드 (객관성, 간결성, 명확성)

templates/terminology_glossary.md

고고학 표준 용어 사전 (700+ 용어).

포함 범주:

유적·유구 용어 (주거지, 수혈, 구 등)
층서·퇴적 용어 (문화층, 기반층, 교란층 등)
유물 용어 (토기, 석기, 골각기 등)
연대·편년 용어 (C14, BP, cal BC 등)
분석·해석 용어 (형식 분류, 공간분석 등)

examples/example_discussion.md

가상 유적 "OO유적"의 완성된 고찰 예시 (6,500자).

특징:

9개 섹션 완전 구현
표/도/유구/층위 인용 50+ 사례
정량적 서술 (개체수, 비율, 밀도 등)
참고문헌 15편 인용

scripts/cite_helper.py

고찰 텍스트의 인용(표/도/유구/층위)을 검증하는 Python 스크립트.

기능:

인용 패턴 추출 및 통계
누락된 번호 탐지
인용 빈도 분석
검증 보고서 생성

사용법:

python scripts/cite_helper.py discussion.md

출력 예시

입력

다음 자료로 고찰을 작성하세요:
- data/site_notes.md (OO유적, 청동기시대, DD천 유역)
- tables/features.csv (주거지 8동, 수혈 12기)
- tables/artifacts.csv (토기 847점, 석기 378점)
- tables/dating.csv (C14 연대 5점, 1400-1300 BC)

출력 (일부)

## 1. 연구배경

OO유적은 경기도 AA시 BB구에 위치하며, DD천 상류의 충적평야(해발 35-42m)에 입지한다.
이 지역은 한강 중류역에 속하며, 청동기시대 취락이 밀집 분포하는 것으로 알려져 있다(이OO 2018).
본 조사는 EE고속도로 건설에 앞서 실시되었으며, 약 5,200㎡를 발굴하였다.

## 2. 층서 및 형성과정

층서는 크게 4개 층으로 구분된다(도 3, 표 1).
제3층(L3)은 암갈색 점질토로 청동기시대 유구가 조성된 생활면이다.
층 내 숯·소토·토기편이 고르게 분포하여 인위적 퇴적으로 판단된다.

## 3. 유구별 해석

주거지는 총 8동(F1-F8)이 확인되었으며, 모두 수혈주거지로 분류된다(표 2).
주거지 F1은 평면 원형, 직경 4.8m, 면적 18.1㎡로 본 취락의 중심 주거로 판단된다.
내부에서 이중구연토기 23점, 석촉 2점이 출토되었다(도 8-1~8).
...

고급 기능

1. 인용 검증

고찰 작성 후 인용 일관성을 검증:

python scripts/cite_helper.py discussion.md

출력:

============================================================
발굴조사보고서 인용 검증 보고서
============================================================

## 1. 인용 통계

- 표: 총 47회 인용, 14개 항목
- 도: 총 52회 인용, 25개 항목
- 유구: 총 89회 인용, 22개 항목
- 층: 총 23회 인용, 4개 항목

## 2. 인용 빈도 (상위 10개)

### 표
  - 표 2: 8회
  - 표 5: 6회
  ...

## 3. 일관성 검사

✅ 인용 일관성에 문제가 없습니다.

2. 용어 일관성 점검

다음 고찰 초안에서 용어 일관성을 점검하고 표준 용어로 수정하세요:
- "움집" → "수혈주거지"
- "돌칼" → "석도" 또는 "석검" (맥락 확인)
- "화덕자리" → "노지"

[초안 텍스트...]

3. 특정 유구만 상세 분석

주거지 F1에 대한 상세 해석을 작성하세요.
다음 항목을 포함:
- 평면·단면 형태 분석
- 내부 시설(노지, 주혈) 배치
- 출토 유물 조합 분석
- 기능 및 위계 추정
- 주변 유적과 비교

참고 파일:
- tables/features.csv (F1 행)
- tables/artifacts.csv (F1 맥락)
- figures/list.md (도 7-8)

체크리스트

고찰 작성 후 다음 항목을 점검하세요:

구조

9개 섹션 모두 포함
섹션 순서 준수 (연구배경 → 층서 → ... → 한계)
각 섹션 300-800자

논증

모든 주장에 증거(표/도/수치) 뒷받침
주장-근거-한계-대안 구조 유지
대안 해석 제시 (최소 2-3곳)

인용

표 인용 형식 일관 ("표 3", "표 3-2")
도면 인용 형식 일관 ("도 5", "도 8-1~5")
유구 인용 형식 일관 ("유구 F12", "주거지 1호")
층위 인용 형식 일관 ("층 L3", "제3층")

문체

객관적 서술 ("~로 판단된다", "~추정된다")
용어 일관성 (glossary 참조)
단락당 3-5문장
정량적 표현 ("많다" → "68%", "34점")

내용

층서 역전·혼입 가능성 언급
유구 기능 대안 제시
연대 오차 범위 명시
현대 교란·표본 편향 인정
지역 비교 2-3개 유적
한계 3-5가지 명시
후속 과제 2-3가지 제시

문제 해결

Q: Claude가 스킬을 사용하지 않아요

A: description에 트리거 키워드가 부족할 수 있습니다. 다음 단어를 사용해 질문하세요:

"발굴조사", "고찰", "층서", "유구", "유물", "연대"
"도판 인용", "표 참조", "학술적 문체"

예:

발굴조사 고찰 섹션을 작성해주세요. 층서, 유구, 유물 데이터를 참고하여 학술적 문체로 작성하고 표와 도면을 인용해주세요.

Q: 인용 형식이 일관되지 않아요

A: cite_helper.py로 검증 후 수정 요청:

python scripts/cite_helper.py discussion.md

검증 결과를 Claude에게 제공:

다음 인용 검증 결과를 참고하여 형식을 수정하세요:
[검증 보고서 붙여넣기]

Q: 용어가 일관되지 않아요

A: 용어 사전 참조를 명시:

templates/terminology_glossary.md를 참조하여 다음 초안의 용어를 표준화하세요:
[초안 텍스트...]

Q: 출력이 너무 짧아요 / 길어요

A: 목표 분량을 명시:

고찰을 작성하되, 전체 8,000-10,000자, 각 섹션 500-800자로 구성하세요.

개발 및 커스터마이징

섹션 추가

SKILL.md와 templates/discussion_outline.md를 수정하여 섹션을 추가할 수 있습니다.

예: "10. 활용 방안" 섹션 추가

SKILL.md → "섹션 구조" 항목에 추가
templates/discussion_outline.md 말미에 섹션 템플릿 추가

용어 추가

templates/terminology_glossary.md에 프로젝트별 특수 용어 추가:

### 프로젝트 특수 용어
| 표준 용어 | 유사 용어 | 영문 | 설명 |
|----------|----------|------|------|
| 적석유구 | 돌무지 | stone feature | 돌을 쌓아 만든 구조 |

스크립트 확장

scripts/cite_helper.py를 수정하여 검증 규칙 추가:

# 새로운 패턴 추가
self.patterns['reference'] = re.compile(r'\((\w+\s+\d{4})\)', re.UNICODE)

기여

이 스킬에 개선 제안이나 버그 리포트가 있으면 프로젝트 관리자에게 문의하세요.

개선 아이디어

영문 보고서 지원
다른 시대(삼국시대, 조선시대) 템플릿 추가
GIS 공간분석 결과 자동 해석
비교문헌 자동 검색 및 인용

라이선스

이 스킬은 고고학 발굴조사보고서 작성 지원을 위해 만들어졌습니다. 학술·연구 목적으로 자유롭게 사용하되, 최종 보고서는 반드시 전문가의 검토를 거쳐야 합니다.

연락처

버전: v1.0.0
최종 업데이트: 2025-11-11
문의: 프로젝트 관리자

중요 안내사항

이 스킬은 고찰 초안 작성을 지원하는 도구입니다. 최종 보고서는 반드시 다음 사항을 확인하세요:

✅ 전문 고고학자의 검토 필수
✅ 모든 주장에 대한 증거 재확인
✅ 기관별 보고서 작성 지침 준수
✅ 참고문헌 형식 재점검
✅ 표·도 번호와 텍스트 인용 일치 확인

AI는 초안 작성을 돕지만, 학술적 책임은 작성자에게 있습니다.