ningzimu
1378c5ac44
* docs: require syncing all README translations * docs: simplify README language navigation * docs: add multilingual usage documentation * docs: reference multilingual documentation PR
4.0 KiB
표준 워크플로
개요
Codex PPT의 워크플로는 단계별 확인을 중요하게 생각합니다. 처음부터 전체 PPT를 바로 생성하지 않고 개요, 스타일, 이미지 백엔드와 샘플 슬라이드를 먼저 확인해 재작업 비용을 줄입니다.
단계 1: 입력 자료 읽기
agent는 먼저 다음 내용을 파악합니다.
- 주제와 핵심 관점
- 대상 청중
- 발표 목적
- 페이지 수 요구 사항
- 반드시 포함하거나 제외해야 하는 내용
- 필수 이미지 자료의 유무
단계 2: 개요 확인
agent가 outline.md를 생성하며, 일반적으로 다음 내용을 포함합니다.
- Slide 번호
- 각 페이지의 제목
- 핵심 내용 3~5개
- 표지, 목차, 개념 설명, 흐름, 비교, 데이터 근거, 요약 등의 페이지 역할
- 선택적 시각 아이디어
- 필수 이미지 자료와 용도
개요를 확인하기 전에는 최종 slide 이미지, speech.md 또는 .pptx를 생성하지 않아야 합니다.
단계 3: 시각 스타일 확인
agent가 2~3가지 스타일 방향을 제안하고 하나를 추천합니다. 후보 스타일은 12가지 내장 스타일(깔끔한 전문 스타일, 연구 발표 스타일, 손그림 기술 설명 스타일, McKinsey 스타일, 당·정 홍보용 레드 스타일, 교육용 코스웨어 스타일 등)과 개인 스타일 라이브러리에서 가져옵니다. 사용자가 제공한 스크린샷, PDF 또는 PPT를 바탕으로 스타일을 재현할 수도 있습니다. 전체 스타일 미리보기는 스타일 및 개인 스타일 라이브러리를 참고하세요.
스타일을 선택한 뒤에는 전체 PPT가 일관된 시각 언어를 유지해야 하지만, 각 슬라이드의 레이아웃은 내용에 따라 달라질 수 있습니다.
단계 4: 이미지 생성 백엔드 확인
Codex 내장 이미지 생성 도구를 우선 사용합니다. 내장 도구를 사용할 수 없거나, 사용자가 API/CLI fallback을 명시적으로 요청하거나, 현재 기능으로 요구 사항을 충족할 수 없는 경우에만 scripts/image_gen.py로 전환합니다.
이미지 백엔드를 확인한 뒤에는 전체 PPT에서 일관되게 유지하고 중간에 바꾸지 않아야 합니다.
단계 5: 샘플 슬라이드 생성 및 확인
먼저 샘플 슬라이드 1장을 생성해 다음을 확인합니다.
- 텍스트가 선명한지
- 스타일이 기대와 맞는지
- 페이지 밀도가 적절한지
- 색상과 레이아웃이 안정적인지
- 전체 PPT로 일괄 확장하기에 적합한지
샘플 슬라이드가 승인된 뒤 전체를 일괄 생성합니다.
단계 6: 일괄 생성
샘플 슬라이드 확인 후 agent는 각 페이지의 origin_image/slide_XX.png를 생성합니다. 하위 agent를 지원하는 환경에서는 각 하위 agent가 한 페이지씩 병렬로 생성해 여러 페이지의 제작 속도를 높입니다. 모든 페이지는 승인된 샘플 슬라이드와 동일한 스타일 및 이미지 생성 백엔드를 사용합니다.
단계 7: 품질 검사 및 수정
조립하기 전에 agent는 각 페이지의 텍스트 선명도, 개요와의 일치 여부, 내용 잘림, 스타일 일관성, 불필요한 페이지 번호와 요소 겹침 등을 검사합니다. 심각한 문제가 발견된 페이지는 더 엄격한 프롬프트로 다시 생성하고, 작은 국소 문제는 이미지 편집 기능으로 우선 수정합니다.
단계 8: 발표 대본 및 조립
speech.md 발표 대본을 생성한 뒤 assemble_ppt.py를 사용해 .pptx로 조립합니다. 발표 대본은 각 PPT 슬라이드의 메모 영역에 자동으로 입력됩니다.
단계 9(선택): 스타일 저장
이 PPT가 사용자 지정 또는 조정된 스타일을 사용한 경우, agent는 최종 보고에서 해당 스타일을 개인 스타일 라이브러리에 저장해 이후 이름으로 바로 재사용할 수 있다고 안내합니다. 자세한 내용은 스타일 및 개인 스타일 라이브러리를 참고하세요.