발표 초안은 있는데 슬라이드가 비어 있는 날이 있죠. 오늘은 Codex PDF 발표 슬라이드 7장 만들기로 갑니다. PDF나 정리 메모 하나만 넣으면 5분 안에 초안이 나오고, 마지막엔 바로 열리는 `deck.pptx`까지 남겨둘 겁니다.
지난번엔 구독료 비교 페이지를 만들었는데, 이번엔 그 자료를 말할 수 있는 화면으로 바꿔보죠. 썸네일로는 `slides.json`, `deck.pptx`, 첫 표지 화면 셋 중 하나만 잡아도 끝입니다.
준비물은 하나만
Codex만 있으면 됩니다. Claude Code 쓰는 분은 같은 프롬프트를 채팅창에 넣으면 되고, 아래 명령은 Codex 기준으로 적을게요. 모델 고르는 화면이 뜨면 `gpt-5.5`, 없으면 `gpt-5.4`로 가면 됩니다.
빈 폴더에서 바로 뽑기
1
초안부터 뽑기
`brief.txt`에 발표할 내용 붙여넣어. PDF만 있다면 텍스트 복사해서 넣어도 충분합니다. 일단 첫 결과부터 보죠.
AI에게 보낸 프롬프트
현재 폴더의 brief.txt를 읽고 발표 슬라이드 7장 초안을 markdown으로 만들어. 1장은 제목, 2~6장은 핵심 내용, 7장은 마무리. 각 장은 제목 1개와 bullet 3개만. 한 bullet은 18단어 이내. 결과 파일 이름은 slides-rough.md로 해.
왜 이렇게 시켰나: 첫 프롬프트에서 욕심내면 AI가 장수를 늘리거나 말이 길어집니다.
이렇게 나오면 OK: `slides-rough.md` 안에 7개 슬라이드가 번호대로 보이면 됩니다.
⚠여기서 이렇게 하면 안 돼요: Step 1에서 디자인까지 한 번에 시키면 첫 결과가 늦어집니다.
2
말투랑 형식 고정하기
이제 흔들리는 부분을 잡습니다. Codex 공식 문서에 나온 AGENTS.md는 다음 실행부터 바로 읽히니까, 이 단계부터 결과가 훨씬 덜 흔들려요. 메모장으로 `AGENTS.md`를 만들고 아래 내용만 넣으면 됩니다.
AI에게 보낸 프롬프트
슬라이드는 총 7장만. 한국어 제목부터 시작. 과장 표현 금지. 각 slide는 title, bullets 3개, speaker_note 1개만. 숫자는 brief.txt에 있는 값만 사용. 한 줄이 길어지면 줄이기부터.
왜 이렇게 시켰나: 이 한 줄 메모가 없으면 Codex가 멋부리다가 발표체가 길어집니다.
이렇게 나오면 OK: 다음 실행에서 장수, 말투, 숫자가 덜 흔들립니다.
⚠여기서 이렇게 하면 안 돼요: AGENTS.md에 규칙 20개 넣지 마세요. 길면 오히려 흐려집니다.
3
JSON으로 고정하기
이번엔 사람 읽는 초안 말고 기계가 바로 쓰는 파일로 바꿉니다. `schema.json`은 Codex에게 먼저 만들라고 시키면 돼요.
AI에게 보낸 프롬프트
현재 폴더에 schema.json을 만들어. 최종 구조는 slides 배열 하나만 있고 길이는 7. 각 slide는 title 문자열, bullets 문자열 배열 3개, speaker_note 문자열 1개를 가진다. 추가 필드는 금지.
왜 이렇게 시켰나: 공식 문서의 `--output-schema`가 여기서 진짜 편합니다. 형식이 안 흔들려요.
이렇게 나오면 OK: `schema.json`이 생기고 필드 이름이 딱 저 셋이면 됩니다.
⚠여기서 이렇게 하면 안 돼요: schema에 색상, 폰트, 애니메이션까지 다 넣지 마세요. 초보일수록 구조만 고정하는 게 낫습니다.
4
slides.json 만들기
AI에게 보낸 프롬프트
codex exec "brief.txt를 읽고 schema.json을 만족하는 slides.json을 만들어. 발표용 말투는 짧게, 중복 표현은 줄여." --output-schema schema.json -o slides.json
왜 이렇게 시켰나: `-o`까지 붙이면 마지막 결과가 바로 파일로 남아서 다시 복붙할 일이 없습니다.
이렇게 나오면 OK: `slides.json` 안에 7장 분량 데이터가 들어갑니다.
⚠여기서 이렇게 하면 안 돼요: `slides-rough.md`를 손으로 고치다 숫자를 바꾸면 나중에 다 꼬입니다.
5
PPTX 파일로 마무리
마지막은 오픈소스 하나 빌립니다. PptxGenJS는 실제로 많이 쓰이고, Codex use cases에도 슬라이드 생성 흐름이 잡혀 있더라구요.
AI에게 보낸 프롬프트
slides.json을 읽어서 deck.pptx를 만드는 Node 스크립트를 만들어. PptxGenJS를 사용하고 파일 이름은 make-slides.mjs로 해. 표지는 크게, 본문은 읽기 편하게, 마지막 장은 한 줄 정리로 넣어. package.json과 실행 명령도 같이 적어.
왜 이렇게 시켰나: 여기서야 비로소 디자인을 붙입니다. 앞 단계에서 구조를 잡아놔서 덜 헤맵니다.
이렇게 나오면 OK: `npm install` 뒤에 `node make-slides.mjs`를 쳤을 때 `deck.pptx`가 생기면 끝입니다.
⚠여기서 이렇게 하면 안 돼요: 처음부터 화려한 템플릿을 요구하면 글자 넘침부터 시작합니다.
6
마지막 검수
AI에게 보낸 프롬프트
/review
왜 이렇게 시켰나: Codex CLI의 `/review`는 수정한 파일 diff만 읽고 위험한 부분을 먼저 짚어줍니다. 저는 여기서 제목 반복이랑 문장 길이만 다시 봅니다.
이렇게 나오면 OK: "2번 슬라이드 bullet 2가 너무 길다" 같은 식으로 바로 손댈 곳이 보입니다.
⚠여기서 이렇게 하면 안 돼요: 검수에서 기능 추가까지 다시 부탁하면 끝이 안 납니다.
여기서 막히면
첫째. `slides.json`이 안 만들어지고 형식 오류가 뜹니다. 보통은 `schema.json`에 배열 길이 조건이 없거나, `AGENTS.md`에서 필드 이름을 다르게 써놨기 때문입니다. schema 파일에서 `title`, `bullets`, `speaker_note` 세 이름이 맞는지 먼저 보고 다시 실행하면 풀립니다.
둘째. `deck.pptx`는 생겼는데 글자가 슬라이드 밖으로 튑니다. 원인은 거의 늘 bullet 문장이 길어서 그래요. `AGENTS.md`에 `한 bullet은 18단어 이내`를 넣고 Step 4만 다시 돌리면 대부분 바로 줄어듭니다.
셋째. `npm install` 뒤에 모듈 에러가 납니다. Node 버전이 낮거나 `make-slides.js`와 `package.json`의 module 설정이 안 맞을 때 자주 이럽니다. 파일 확장자를 `.mjs`로 두고 Node 18 이상에서 다시 실행하면 웬만하면 끝납니다.
다음에 붙이면 더 재밌다
한 걸음 더
이 Codex PDF 발표 슬라이드 흐름은 한 번 만들어두면 발표 전날마다 다시 쓰게 됩니다. 다음엔 여기서 `--search`를 붙여 최신 숫자 한두 개까지 채우고, 표지 이미지만 뽑아서 쇼츠 썸네일까지 이어가면 진짜 쓸 일이 많아질 겁니다.
