ningzimu/codex-ppt-skill

해결하는 문제

시각적으로 매력적인 프레젠테이션을 만드는 데는 레이아웃과 디자인에 많은 수작업이 필요한 경우가 많습니다. 이 프로젝트는 AI 에이전트가 긴 형식의 콘텐츠(기사, 보고서, 논문, 강의 노트 등)를 사용자가 각 페이지를 수동으로 디자인할 필요 없이 시각적 일관성과 전문적인 미학을 유지하는 고품질 이미지 기반 프레젠테이션 슬라이드로 변환할 수 있는 구조화된 워크플로우를 제공합니다.

작동 방식

이 도구는 AI 에이전트(Codex, Claude Code, OpenClaw 등)의 "스킬"로 작동합니다. 다음과 같은 단계별 생성 프로세스를 따릅니다:

1. 계획: 에이전트가 입력 자료를 분석하여 아웃라인(outline.md)을 생성하고 페이지 수와 핵심 포인트를 결정합니다.
2. 스타일 설정: 사용자는 12가지 내장 시각적 스타일(예: McKinsey 스타일, 손으로 그린 기술 스타일, 과학적 방어 스타일 등) 중에서 선택하거나, 에이전트가 복제할 수 있는 사용자 지정 참조 이미지를 제공합니다.
3. 샘플링: 레이아웃과 품질을 확인하기 위해 단일 샘플 슬라이드를 먼저 생성한 후 진행합니다.
4. 제작: 에이전트는 이미지 생성 백엔드(예: gpt-image-2.5-flare 또는 Codex 내장 도구)를 사용하여 각 슬라이드를 전체 페이지 16:9 이미지로 생성합니다.
5. 조립: 로컬 Python 스크립트(assemble_ppt.py)가 이러한 이미지를 최종 .pptx 파일로 컴파일하고 생성된 스피치 스크립트(speech.md)를 슬라이드 노트에 통합합니다.

대상 사용자

• 연구원 및 학생: 학술 논문이나 논문 심사 자료를 프레젠테이션 덱으로 변환하려는 경우.
• 기술 작가: 기술 기사나 제품 노트를 공유용 슬라이드로 변환하려는 경우.
• 비즈니스 전문가: 상업용 보고서, 제품 소개, 조사 요약 등을 작성하려는 경우.
• 기존 텍스트 문서에서 시각적으로 통일된 이미지 기반 프레젠테이션을 빠르게 만들어야 하는 모든 사람.

주요 특징

• 멀티 에이전트 호환성: Codex, Claude Code, OpenClaw, Hermes Agent를 포함하여 SKILL.md를 지원하는 다양한 환경에서 작동합니다.
• 스타일 라이브러리: 12가지 사전 설정된 전문 스타일이 포함되어 있으며, 사용자는 ~/.codex-ppt-skill/references/에 개인 스타일 라이브러리를 구축하여 향후 재사용할 수 있습니다.
• 사용자 지정 비주얼: 특정 원본 이미지(예: 아키텍처 다이어그램이나 실험 결과)를 삽입하고 그 주변에 슬라이드의 나머지 부분을 생성하는 기능을 지원합니다.
• 품질 관리: 단계별 접근 방식(아웃라인 $ ightarrow$ 스타일 $ ightarrow$ 샘플 $ ightarrow$ 전체 생성)을 사용하여 재작업을 줄이고 일관성을 보장합니다.
• 자동화된 노트: 해당 스피치 스크립트를 자동으로 생성하여 PowerPoint의 노트 섹션에 삽입합니다.