Editable PPT Rebuilder란
Editable PPT Rebuilder는 Codex용 PowerPoint 재구성 Skill입니다. 전체 페이지 이미지, PPTX 페이지 또는 고해상도 슬라이드 스크린샷을 시각 및 텍스트 사실의 근거로 사용하여 편집 가능하고 감사 가능하며 납품 검증까지 완료된 PowerPoint 프레젠테이션을 재구성합니다.
단순히 전체 페이지 스크린샷을 PPT에 삽입하는 방식이 아닙니다. 객체 유형에 따라 적절한 표현 방식을 선택합니다. 읽을 수 있는 텍스트는 PowerPoint 텍스트 상자로 변환하고, 패널, 테두리, 화살표와 같은 단순 구조는 기본 도형으로 변환하며, 사진, 복잡한 차트 및 다이어그램은 독립적인 의미 기반 PNG 자산으로 보존합니다.
이미지 기반 입력만으로는 원본 파일에 보이지 않는 벡터 객체, 숨겨진 텍스트, 차트의 원시 데이터 또는 원래의 편집 계층을 완벽하게 복원할 수 없습니다. 신뢰성 있게 식별할 수 없는 내용은 추측하지 말고 수동 검토 상태로 유지해야 합니다.
핵심 기능 및 객체 분류
프로젝트는 ‘사람이 주도하고 AI가 지원하는’ 방식으로 설계되었습니다. AI는 긴 문서 요약, 구조 대안, 페이지별 스크립트, 시각적 초안 및 객체 분해에 사용할 수 있지만, 전문적인 방향, 페이지 선택, 핵심 데이터 확인, 기술적 한계 판단 및 최종 검토는 여전히 사람이 담당합니다.
- editable_text: 제목, 본문, 레이블, 범례, 축, 표 및 수식과 같은 읽을 수 있는 콘텐츠.
- native_shape: 패널, 색상 띠, 테두리, 구분선, 커넥터, 화살표, 배지 및 단순 도형.
- semantic_png: 사진, 인물, 제품, 복잡한 차트, 네트워크 다이어그램, 복잡한 다이어그램 및 복잡한 아이콘.
- background: 전경 제거 또는 별도 재구성 검토가 필요한 복잡한 대형 배경.
- backup_only: 보이지 않는 백업으로만 보존되는 콘텐츠이며, 최종 표시 객체를 대체할 수 없음.
작은 아이콘은 텍스트 없는 시각적 핵심 생성, 색상 키 제거, 투명 가장자리 확인, PPTX 삽입 및 검토 증거 기록을 포함하는 ImageGen 시각 핵심 프로세스를 반드시 거쳐야 합니다. 복잡한 시각 요소에도 명확한 의미 객체, 고유한 소속 및 검토 증거가 있어야 합니다.
설치 전 준비
먼저 Codex, Python 환경 및 전체 프로젝트 디렉터리를 준비합니다. 설치 후 디렉터리는 일반적으로 다음 경로에 있습니다.
$CODEX_HOME/skills/editable-ppt-rebuilderCODEX_HOME이 설정되지 않은 경우 일반적으로 다음 경로를 사용합니다.
~/.codex/skills/editable-ppt-rebuilder설치가 완료되면 $editable-ppt-rebuilder를 사용하여 해당 Skill을 호출할 수 있습니다. 현재 작업에서 새 Skill이 즉시 표시되지 않으면 Codex를 다시 로드하거나 새 작업을 생성합니다.
종속 항목 및 도구
Skill 설치와 전체 워크플로 실행은 별개의 작업입니다. 프로젝트의 requirements.txt 외에도 작업에 따라 다음 구성 요소를 준비해야 합니다.
- 스크립트 및 처리 절차 실행을 위한 Python 종속 항목.
- Tesseract OCR 및 해당 언어 데이터. 중국어 인식에는 일반적으로
chi_sim이 필요합니다. - 최종 렌더링 검사를 위한 Microsoft PowerPoint 또는 이에 준하는 고품질 렌더러.
- 작은 아이콘의 필수 시각 핵심 프로세스에 사용할 수 있는 ImageGen 기능.
프로젝트에는 렌더링, 분할, OCR 및 품질 검사 설정을 참고할 수 있는 config.example.yaml도 제공됩니다.
전체 재구성 과정
1단계: 원본 페이지 추출 및 저장
먼저 입력 PPT, PPTX 또는 스크린샷에서 원본 페이지를 추출하거나 렌더링하고 그 결과를 source_pages/에 저장합니다. 원본 페이지는 항상 보존하고 수정하지 않아야 하며, 이후의 시각적 비교, 좌표 지정 및 품질 검토를 위한 기준입니다.
2단계: 기준 분해 실행
scripts/decompose_visual_elements.py를 사용하여 OCR, 후보 영역 탐지 및 기준 출력을 실행합니다. 이 단계에서는 텍스트, 도형, 이미지 및 해당 좌표를 식별하고 이후 분해에 필요한 초기 결과를 생성합니다.
python scripts/decompose_visual_elements.py ...기준 결과가 최종 답은 아닙니다. 원본 페이지, 객체 목록, 검토 오버레이 및 대략적인 미리보기를 함께 확인해야 합니다. 잘못 인식되었거나 언어 모델 지원이 부족한 OCR 결과는 반드시 수동으로 수정하거나 검토 상태로 표시해야 합니다.
3단계: 각 객체의 표현 방식 선택
페이지별로 표시된 객체를 확인하고 각 객체의 최종 표현 유형을 하나씩 결정합니다. 읽을 수 있는 모든 텍스트는 편집 가능한 텍스트로, 단순 구조는 기본 도형으로, 복잡하거나 스타일에 민감한 시각 콘텐츠는 독립적인 의미 기반 PNG로 재구성하는 것을 우선합니다.
각 페이지에서는 먼저 고유한 답변 목적을 정의한 다음 텍스트, 기본 구조 및 복잡한 시각 요소의 조합 방식을 결정해야 합니다. 이렇게 하면 전체 페이지 스크린샷을 유지 관리가 어려운 여러 조각으로 잘라내는 일을 방지할 수 있습니다.
4단계: 원본 페이지 좌표에 따라 PPTX 재구성
원본 페이지 좌표에 따라 텍스트 상자, 기본 도형 및 독립적인 시각 자산을 결정론적으로 배치하고 원본 페이지의 가로세로 비율을 유지합니다. 제목, 데이터 및 레이블은 직접 편집할 수 있어야 하며, 색상 블록, 화살표 및 테두리는 조정할 수 있어야 합니다. 사진, 복잡한 다이어그램 및 아이콘은 독립적으로 교체하거나 관리할 수 있어야 합니다.
복잡한 시각 요소에 페이지 조각을 사용하여 전체 페이지를 콜라주처럼 구성해서는 안 됩니다. 모든 PNG에는 명확한 의미 객체, 고유한 소속 및 해당 검토 증거가 있어야 합니다.
5단계: 복잡한 시각 요소 및 아이콘 처리
복잡한 시각 요소와 각 작은 아이콘에 대해 독립적인 자산을 생성합니다. 작은 아이콘은 최종 표시 아이콘으로 사용하기 위해 원본 아이콘의 픽셀을 직접 잘라내거나 확대하거나 따라 그리거나 재사용해서는 안 됩니다. ImageGen을 사용할 때는 텍스트가 없는 시각적 핵심을 생성한 후 색상 키 제거, 투명 가장자리 확인 및 PPTX 삽입을 완료해야 합니다.
복잡한 배경에는 전경 제거 또는 재구성 검토를 수행해야 합니다. 단순한 배경은 기본 PowerPoint 도형을 우선 사용하고, 검토되지 않은 생성 배경을 최종 결과로 직접 사용하지 않습니다.
6단계: 렌더링 및 실제 결과 확인
재구성이 완료되면 PowerPoint 또는 이에 준하는 고품질 렌더러를 통해 최종 미리보기를 내보냅니다. 객체 데이터나 스크립트 출력만 확인하지 말고 실제 렌더링 결과의 텍스트, 자르기, 투명도, 겹침 및 시각적 일관성도 확인해야 합니다.
7단계: 목록 생성 및 납품 검증 실행
최종 출력에는 일반적으로 원본 페이지, 독립 PNG, CSV 또는 JSON 목록, 자르기 검토 증거, 배경 검토 증거, PowerPoint 미리보기, 차이 이미지 및 페이지별 품질 보고서가 포함되어야 합니다. 세부 재구성이 완료되면 다음을 실행합니다.
python scripts/validate_delivery.py <refined_output_dir> --pptx <refined_deck.pptx>엄격한 납품 요건에서는 검증기가 0을 반환해야 합니다. 검증기가 0이 아닌 상태로 종료되면 파일을 납품하지 말고 먼저 보고서의 문제를 해결해야 합니다.
여러 입력 일괄 처리
여러 페이지나 입력을 반복 처리해야 하는 경우 일괄 처리 스크립트를 사용할 수 있습니다.
python scripts/run_batches.py ...일괄 처리는 일관된 기준 분해 결과를 생성하는 데 적합하지만 페이지별 검토를 대체할 수는 없습니다. 각 페이지에서 객체 분류, OCR 품질, 자르기 소속 및 최종 시각적 결과를 확인해야 합니다.
품질 검토 핵심 사항
- 원본 페이지가 완전히 보존되었고 수정되지 않았는가.
- 읽을 수 있는 모든 텍스트가 편집 가능한 텍스트로 재구성되었으며 텍스트 PNG는 보이지 않는 백업으로만 사용되었는가.
- 단순 구조에 기본 PowerPoint 객체가 사용되었는가.
- 복잡한 PNG에 의미 있는 이름, 고유한 소속 및 검토 증거가 있는가.
- 페이지 가로세로 비율, 객체 위치, 투명도 및 자르기가 올바른가.
- 중복 자산, 콘텐츠 넘침, 객체 잘림, 의도하지 않은 겹침 또는 배경 잔여물이 없는가.
- 작은 아이콘에 대해 ImageGen, 투명 가장자리 및 의미 독립성 검토가 완료되었는가.
- 모든 검토 항목과 품질 문제가 종료되었고 검증기가 종료 상태 0을 반환했는가.
고급 사용 권장 사항
객체 경계를 우선적으로 관리
재구성의 가치는 전체 페이지를 픽셀 단위로 복제하는 데 있지 않고 명확한 객체 경계를 만드는 데 있습니다. 제목, 데이터, 색상 블록, 화살표, 사진 및 다이어그램을 각각 처리하면 이후 수정, 교체 및 검토를 더욱 안정적으로 수행할 수 있습니다.
검토 증거를 납품물에 포함
PPTX 외에도 목록, 자르기 검토, 배경 검토, 차이 이미지 및 페이지별 품질 보고서를 보존해야 합니다. 이러한 자료는 어떤 콘텐츠가 편집 가능한 객체인지, 어떤 콘텐츠가 독립적인 시각 자산인지, 최종 결과가 실제 렌더링 검사를 거쳤는지를 보여줍니다.
보이지 않는 콘텐츠를 과도하게 추론하지 않기
원본 이미지의 텍스트를 읽을 수 없거나 로고를 신뢰성 있게 식별할 수 없거나 차트의 원시 데이터가 보이지 않는 경우 수동 검토 상태를 유지해야 합니다. 빈 부분을 채우기 위해 텍스트, 데이터 또는 원래의 편집 계층을 추측하지 마세요.
요약
Editable PPT Rebuilder는 원본 페이지 추출, OCR 분해, 객체 분류, 결정론적 재구성 및 최종 검증을 아우르는 전체 워크플로를 제공합니다. 이를 올바르게 사용하는 핵심은 스크린샷을 PPT에 삽입하는 것이 아니라 페이지를 편집 가능한 텍스트, 기본 구조 및 명확한 의미를 가진 독립적인 시각 자산으로 분해하고, 실제 렌더링과 엄격한 검증을 통해 납품 품질을 보장하는 데 있습니다.