LearnPrompt/humanize-ppt
AST-based outline director for human-centered AI presentation workflows.
Humanize PPT – AI 기반의 "말할 수 있는" 슬라이드 데크
무엇인가요 – Humanize PPT는 원시 자료(Markdown, 메모, 데이터)를 프레젠테이션 준비 완료 상태의 슬라이드 데크로 변환하는 작고 Python 기반의 오케스트레이션 계층입니다. 시각적 디자인 자체를 렌더링하지는 않지만, 스토리의 흐름("AST" – Audience-State-Transfer 개요)을 결정하고, 어떤 슬라이드에 이미지, SVG 차트, 또는 짧은 비디오가 필요한지 판단한 후, 그 결정을 하류 렌더링 스킬(HTML 슬라이드 생성기, 네이티브 PowerPoint 내보내기, Remotion 비디오 제작기 등)에 위임합니다. 렌더링 후 자동 프레젠테이션 체크를 실행하여 "예쁘지만 말할 수 없는" 슬라이드(예: 배지에 의해 가려진 텍스트, 스피커 노트 누락)를 탐지하고, 렌더러에 수정을 위한 프롬프트를 생성합니다.
핵심 아이디어
| 개념 | Humanize PPT가 하는 일 |
|---|---|
| AST 개요 | 소스 자료를 분석하여 각 슬라이드의 청중의 초기 상태, 슬라이드 후 의도된 상태, 그리고 슬라이드의 목적을 기록한 JSON 계획(slide_plan.json)을 생성합니다. |
| 시각적 강화 | 각 슬라이드에 이미지, 결정론적 SVG 차트, 또는 Remotion 비디오가 필요한지 판단하고, 요청(프롬프트 힌트 + 대상 경로)을 계획에 기록합니다. 실제 자산은 baoyu-image-gen(로컬 Codex CLI) 또는 remotion-video-production과 같은 플러그인 스킬에 의해 생성됩니다. |
| 스타일 갤러리 | 개요가 고정되기 전에 렌더러에게 ≥4개의 커버 페이지 후보를 생성하게 하여, 사용자가 전체 데크를 확정하지 않고도 시각 스타일을 선택할 수 있도록 합니다. |
| 프레젠테이션 체크업 | 하류 렌더러가 완료한 후 Humanize PPT는 출력물을 스캔하고 AST 계획과 비교하여 "실패한" 슬라이드(예: 텍스트 오버플로우, 배지가 텍스트를 가림, 스피커 노트 누락)를 자동으로 보고합니다. fix_prompt.md를 생성하여 렌더러에 두 번째 실행을 요청할 수 있도록 합니다(최대 3회 반복). |
| 프레젠테이션 모드 | 현재 슬라이드, 타이머, 스피커 노트, 다음 슬라이드 미리보기, 슬라이드 맵을 표시하는 경량 HTML 프레젠테이션 쉘(presenter-shell.html)을 생성하여, 최종 데크가 렌더링되기 전에도 리허설이 가능하게 합니다. |
AI 에이전트 워크플로우에의 통합 방법
- 스킬로 설치 – Claude‑Code, Codex, Hermes와 같은 에이전트는 단일 줄(
npx skills add LearnPrompt/humanize-ppt)로 스킬을 추가할 수 있습니다. - 에이전트에 프롬프트 – "Humanize PPT를 사용하여 이 마크다운을 중국어 프레젠테이션 PPT로 변환하고,
guizang-ppt-skill로 네이티브 렌더링, 이미지는baoyu-image-gen으로 추가, 비디오는 Remotion으로 제작해 주세요." - Humanize PPT 실행 – AST 계획을 생성하고, 간단한 프롬프트(
guizang-production-prompt.md,ppt-master-production-prompt.md, ...)를 작성하여 선택된 렌더러에 전달합니다. - 렌더러가 데크 생성 – HTML 슬라이드 세트, 네이티브
.pptx, 또는 MP4 비디오 세트가 생성됩니다. - 자동 QA – Humanize PPT는 렌더링된 파일을 읽고, 3라운드 체크업을 실행한 후 간결한 보고서(
qa_report.md)와 수정 프롬프트를 반환합니다. - 반복 또는 발표 – 수정 프롬프트를 렌더러에 다시 전달하거나, 바로 프레젠테이션 쉘로 이동하여 리허설을 시작할 수 있습니다.
주요 구성 요소 (리포지토리에 설명됨)
scripts/humanize_ppt.py– CLI 진입점. 소스 마크다운, 출력 폴더, 제목, 렌더러 선택, 스타일 플래그 등을 수락합니다.slide_plan.json– 기계가 읽을 수 있는 계획. 모든 슬라이드, 그 AST 상태, 미디어 슬롯, 스타일 선택을 나열합니다.presenter-shell.html– 어떤 렌더링된 데크와도 호환되는 최소한의 HTML 프레젠테이션 쉘. 슬라이드, 타이머, 스피커 노트, 탐색 기능을 표시합니다.qa_report.md/fix_prompt.md– 인간이 읽을 수 있는 진단 정보와 하류 렌더러에 문제를 수정하도록 요청할 정확한 프롬프트.
하류 스킬 생태계 (완전한 파이프라인에 필요한 것으로 목록됨)
| 스킬 | 렌더링 내용 | 리포지토리 |
|---|---|---|
guizang-ppt-skill |
중국어 네이티브 PPT (매거진 / 스위스 스타일) | https://github.com/op7418/guizang-ppt-skill |
frontend-slides |
영어 HTML 슬라이드 데크 (뷰포트 안정성) | https://github.com/zarazhangrui/frontend-slides |
beautiful-html-templates |
영어 다중 템플릿 HTML 데크 | https://github.com/zarazhangrui/beautiful-html-templates |
ppt-master |
편집 가능한 완전한 .pptx (DrawingML, 노트, 전환 효과) |
https://github.com/hugohe3/ppt-master |
remotion-video-production |
슬라이드별 설명용 MP4 비디오 | (Remotion 생태계) |
baoyu-image-gen |
로컬 Codex‑CLI 이미지 생성 (API 키 필요 없음) | https://github.com/JimLiu/baoyu-skills/tree/main/skills/baoyu-image-gen |
빠른 시작 예제 (README에서)
# 에이전트용 스킬 설치
npx skills add LearnPrompt/humanize-ppt -g
# 에이전트에 한 줄 프롬프트로 전체 파이프라인 실행
"用 humanize-ppt 把这份材料做成中文演讲 PPT：先出 AST 大纲和每页意图，
按大纲调 guizang-ppt-skill 原生渲染，配图用 baoyu-image-gen、视频用 remotion，
渲染完跑一遍演讲体检告诉我哪几页只能看不能讲，最后出演讲模式。"
에이전트는 다음을 수행합니다:
humanize_ppt.py호출 →guizang-production-prompt.md생성.guizang-ppt-skill실행 → 아름다운 HTML/PPTX 데크 획득.baoyu-image-gen및 Remotion으로 미디어 자산 생성.- Humanize의 QA 단계 실행 → 문제 슬라이드 목록 수신.
- 필요 시 생성된 수정 프롬프트로 렌더러 재실행.
presenter-shell.html열어 리허설 시작.
얻는 것들
- AST 기반 슬라이드 계획 (
slide_plan.json). - 렌더러별 간결한 프롬프트 (
*-production-prompt.md). - 옵션 스타일 갤러리 HTML (커버 스타일 선택용).
- 미디어 자산 (실제 이미지, SVG 차트, MP4 비디오)를 지정된 경로에 배치.
- QA 리포트 (
qa_report.md) – "보기만 가능한" 슬라이드를 정확히 지적. - 편집 가능한 네이티브 PPTX (ppt-master 사용 시) 또는 바로 발표 가능한 HTML 데크.
- 즉시 리허설용 프레젠테이션 쉘.
라이선스
MIT – 자유롭게 사용, 수정, 다른 AI 에이전트 툴체인에 통합 가능.
요약
Humanize PPT는 시각 템플릿 라이브러리가 아닙니다. 그것은 AI 생성 슬라이드 데크를 말할 수 있게 만드는 스토리 오케스트레이션 계층입니다. 콘텐츠 기획 (AST) 과 시각 렌더링을 분리하고, 자동 "프레젠테이션 건강 점검"을 제공함으로써, LLM 기반 에이전트가 보기 좋고, 라이브 발표에 적합한 데크를 생성할 수 있도록 합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트