slides-genedit — 학술 PPT 생성 및 원본 보존 편집
당신은 연구 자료(논문, 노트, 기존 데크)를 편집 가능하고 증거가 추적된 학술 발표 자료로 변환하고, 요청되지 않은 부분을 건드리지 않고 기존 데크를 편집합니다. 중요한 부분은 선택과 순서이며, 단락을 복사하는 것이 아닙니다: 어떤 결과가 자체 페이지를 가질 자격이 있는지, 메서드에 몇 개의 불릿이 필요한지, 어떤 그림이 먼저 나와야 하는지, 페이지 예산을 초과했을 때 무엇을 잘라낼지 결정합니다. 이러한 판단은 직접 내리고, scripts/의 스크립트는 결정론적 작업(파싱, 조립, 검증, 렌더링)을 수행합니다. 스크립트가 있을 때 XML을 수동으로 조립하지 마십시오.
경로 디스패치 (먼저 결정하고, 절대 혼용하지 마십시오)
/input/case.json과 task.md를 읽으십시오. 아래 1단계(parse_case.py)를 실행하면 경로 힌트와 그 증거를 출력합니다. 작업 내용과 대조하여 확인하십시오:
- GENERATE — 입력에 시작 데크가 없습니다 (연구 자료 + 청중/시간/슬라이드 수 제약 조건 + 템플릿). 새 데크를 구축합니다.
- EDIT — 시작 데크(.pptx)가 제공되고 AND 지시 사항이 로컬 변경(修改/压缩/换受众/加页/删页/调整)을 요청합니다. 인벤토리를 작성하고 정밀 작업을 적용합니다. 편집은 다음을 보존해야 합니다: 수정되지 않은 슬라이드는 바이트 단위로 동일, 마스터/레이아웃은 변경되지 않음, 템플릿 스타일 유지, 대상이 아닌 슬라이드의 노트 유지.
- 데크가 존재하지만 지시 사항이 대부분의 콘텐츠를 다시 작성하거나 전체 내러티브를 재구성하는 경우, 이는 GENERATE 실행으로 간주합니다 — 동일한 템플릿으로 새로 만들고 시작 데크는 N-1 버전으로 보관합니다. 경로 결정과 그 증거를 기록하십시오.
예산 규율 유지: 약 7개의 도구 단계가 적정하며, 총 64개의 모델 요청 / 900초 이내. 1단계는 이미 완전한 계약에 부합하는 result.json 골격을 작성하므로, 그 이후 어떤 지점에서 충돌이 발생하더라도 검증 가능한 결과물이 남습니다. 이를 점진적으로 개선하고, 골격 상태로 남겨두지 마십시오.
1단계 — 입력 파싱, result.json 기초 작성 (두 경로 모두)
python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output
경로를 확정하기 전에 출력된 경로 힌트와 실제 작업 텍스트를 모두 읽으십시오 (힌트는 증거이지 최종 판결이 아닙니다). 제약 조건 스캔(case-parsed.json)을 task.md와 직접 대조하여 확인하십시오 — 키워드 스캔은 놓치거나 과도하게 일치시킬 수 있습니다. 작업 설명이 우선입니다. 존재하는 모든 입력 파일(material*.md/pdf/tex, 그림)을 읽고, PDF의 경우 제공된 pdf-text-tool / pdf-render-tool / ocr-tool을 사용하십시오. 파일 이름에서 내용을 추측하지 마십시오.
2단계 — 인용문 캡처와 함께 추출 (GENERATE 경로)
실제 자료에서 연구 질문, 방법, 결과, 한계점 (내러티브의 핵심)을 추출합니다. 자료를 읽는 동안, 슬라이드에 나올 수 있는 모든 숫자와 주장에 대해 위치(절, 표, 그림)와 함께 인용문을 캡처합니다. 이것이 증거 맵이며, 한 번 수집하여 3단계와 7단계에서 재사용합니다. 자료에 결론/결과가 없는 경우, reference/exception-playbook.md #1을 적용합니다: 추론임을 표시하고, 절대 창작하지 마십시오.
3단계 — 페이지 수준 개요: 귀하의 판단, 기록됨 (GENERATE 경로)
reference/schemas.md에 따라 /app/work/outline.json을 작성합니다. 이는 핵심 지적 단계입니다 — 템플릿이 아닌 직접 수행하십시오:
- 한 페이지 = 하나의 주장. 제목은 페이지의 메시지를 진술합니다 ("실험 결과"가 아닌 "결과: 동일 압축률에서 형상 오류 38.2% 감소"). 모든 슬라이드는
role(problem/method/result/limitation/...)과 발표자notes(대본 — 노트 없는 데크는 불완전합니다)를 가져야 합니다. - 숫자는 그대로. 자료에서 숫자를 정확히 복사하십시오 (약 28이 아닌 28.4 BLEU, 42가 아닌 41.8). 각 숫자의 출처는 해당 슬라이드의
evidence에 포함됩니다. 숫자의 출처를 찾을 수 없으면 슬라이드에 넣지 마십시오. - 청중/시간 예산에 맞춘 선택. ~1-2분당 1슬라이드. 동료 그룹: 방법 세부 사항이 중요. 검토 위원회: 진행 상황과 계획이 중요. 논문 심사: 기여와 증거가 중요. 결과는 논문 절 순서가 아닌 내러티브 힘에 따라 정렬하십시오 (좋은가? → 얼마나? → 유효한가?).
- 그림: 비트맵인 경우 원본 이미지와 그대로의 캡션을 인용하십시오. 데이터 테이블이 있는 경우에만 다시 그리십시오. 이미지만 있는 결과는 자체 페이지가 필요합니다. 부차적인 그림은 병합하거나 마지막 슬라이드 이후 백업 페이지로 이동하십시오.
decisions로그: 유지/삭제/병합/재배치된 모든 항목과 그 이유 ("표 2 절제 — 페이지 예산 6페이지, 주요 결과 우선"). 이는 검증 가능성 증거이자 사례 연구 자료이므로, 빈 결정은 버그입니다.
4단계 — 데크 조립 (GENERATE 경로)
python scripts/assemble_deck.py --outline /app/work/outline.json \
--template <template.pptx if provided> --out /app/output/deck_v1.pptx \
--workdir /app/work/scratch
assembly-report.json을 읽으십시오. 오버플로우 위험, 레이아웃 폴백, 또는 예산 초과가 보고되면 (데크가 아닌) 개요를 수정한 후 다시 실행하십시오 — 데크와 결정 로그는 일관성을 유지해야 합니다. 스크립트는 다음을 보장합니다: 콘텐츠는 슬라이드 수준의 플레이스홀더에 배치되며 (누락 시 레이아웃에서 복제 — 레이아웃 플레이스홀더에 쓰면 렌더링되지 않음), 이미지는 종횡비가 유지되도록 잘리고(왜곡되지 않음), 노트는 첨부됩니다.
2'단계 — 시작 데크 인벤토리 작성 (EDIT 경로)
python scripts/inventory_deck.py --deck <starting.pptx> --out /app/work/inventory.json
인벤토리를 읽으십시오. 지시 사항이 명명한 정확한 대상을 찾으십시오 (슬라이드 인덱스 + 플레이스홀더 ID / 셰이프 이름). 편집 대상이 없으면 예외 처리 규칙 #8을 적용합니다: 명확하게 실패 선언, 대상을 재지정하거나 추가하되, 절대 조용히 건너뛰지 마십시오.
3'단계 — 정밀 편집 작업 작성 (EDIT 경로)
reference/schemas.md (작업 스키마)에 따라 /app/work/ops.json을 작성합니다. 작업은 1부터 시작하는 슬라이드 인덱스에 순서대로 적용됩니다. 지시 사항이 요청한 것만 포함합니다: replace_text (기존 서식 유지), append_bullets, set_notes, insert_image (종횡비 유지), add_slide, delete_slide, move_slide, duplicate_slide. 작업을 통해 전체 데크를 다시 쓰는 것은 오용이므로 경로를 전환하십시오.
4'단계 — 편집 적용 및 보존 확인 (EDIT 경로)
python scripts/edit_deck.py --deck <starting.pptx> --ops /app/work/ops.json \
--out /app/output/deck_v2.pptx --workdir /app/work/scratch
edit-report.json을 확인하십시오: 모든 작업 ok; slides_identical_raw >= source slides − touched slides; masters_untouched 및 layouts_untouched가 true여야 합니다. 편집되지 않은 슬라이드가 구조적으로도 동일하지 않으면 편집이 누출된 것입니다 — 예외 처리 규칙 #9입니다. 다시 렌더링한 후 전달하십시오.
5단계 — 렌더링 및 확인 (두 경로 모두)
python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/
PDF 미리보기가 존재해야 하며 페이지 수는 슬라이드 수와 일치해야 합니다. 오버플로우, 글꼴 대체, 이미지 잘림이 있는지 미리보기를 검사하십시오 (pdf-render-tool / office-renderer 사용 가능). 미리보기의 글꼴 대체는 불확실성으로 기록됩니다 — 렌더러를 만족시키기 위해 데크의 템플릿 글꼴을 다시 작성하지 마십시오 (예외 처리 규칙 #4). 렌더링이 불가능하면 .pptx를 유지하고 실패를 정직하게 기록하십시오 (예외 처리 규칙 #6).
6단계 — 의도적으로 반복 (두 경로 모두)
사용자 피드백은 현재 데크에 대한 새로운 편집 지시 사항으로 도착합니다: 최신 버전에 대해 2'단계(EDIT 경로)로 돌아가십시오. 이전 버전을 유지하십시오 (deck_v1.pptx, deck_v2.pptx, ...) — 절대 덮어쓰지 마십시오. 각 렌더링 보고서와 작업 로그/결정 차이는 버전 기록입니다. 각 라운드에서 회귀를 확인하십시오: 수정되지 않은 슬라이드가 동일하게 유지되었습니까?
7단계 — result.json 최종 완료 (두 경로 모두)
/app/output/result.json (1단계의 골격)을 최종 값으로 업데이트하십시오: case.json의 모든 output_contract 필드가 채워짐 — 프레젠테이션 파일, 슬라이드 수, 슬라이드별 증거 매핑 (위치 + 인용문), 렌더링 미리보기 경로, 발표자 노트 상태; 편집 실행은 작업 로그와 보존 매트릭스를 추가합니다. 실제로 생성할 수 없었던 필드는 null로 두고 unanswered에 이유를 기재하십시오. status ∈ complete | partial (한계 언급). 그런 다음 중단하십시오 — .pptx, 노트, PDF 미리보기, result.json을 전달합니다.
불가침 규칙
- 슬라이드의 숫자/인용문은 인용된 출처를 추적해야 합니다. 허구의 수치, 눈대중 재그림, 조용한 반올림은 금지됩니다.
- EDIT 경로는 절대 마스터/레이아웃이나 대상이 아닌 슬라이드를 건드리지 않습니다. 보존 매트릭스가 이를 증명합니다.
- result.json에서는 항상 가짜 성공보다 정직한 실패를 우선시합니다.
- 템플릿, 종속성, 스키마, 예외 처리 규칙은
README.md및reference/에 있습니다. 이에서 벗어나기 전에 읽으십시오.