GitHubHelp

terryum/terry-slides

★ 0Forks 0GitHub ↗Compare

README

$slide Codex Skill Starter

이 패키지는 Codex에서 $slide라는 skill을 만들기 위한 초기 설계 문서입니다. 목표는 단순한 PPT 자동생성이 아니라, 멀티에이전트 기반의 슬라이드 생산·검증·품질점수 반복 루프를 만드는 것입니다.

핵심 설계

$slide는 3개 production mode를 지원합니다.

Mode 목적 기본 산출물
boardroom_report 임원 보고, 의사결정, 숫자·템플릿·편집 가능성 최우선 editable PPTX, appendix, QA report, score
stage_keynote 스티브잡스형 무대 발표, 큰 이미지·사진·밈·최소 텍스트 PPTX, speaker notes, script, asset manifest
visual_briefing 이미지 중심이지만 핵심 텍스트·KPI는 수정 가능한 중간형 editable text-over-visual PPTX, notes, appendix, QA report

기본 철학

  1. 생성보다 검증이 중요하다. 좋은 deck은 생성 직후가 아니라 render → QA → score → fix loop를 거친 뒤 나온다.
  2. mode별로 성공 기준이 달라야 한다. 임원 보고형은 숫자와 편집성이, keynote형은 시각적 임팩트와 speaker notes가 더 중요하다.
  3. 기존 레포를 그대로 fork하지 않는다. OpenAI $slides를 기본 생성·검증 엔진으로 쓰고, ppt-master, pptx-from-layouts, gpt-image2-ppt-skills의 강점을 원칙으로 흡수한다.
  4. 멀티에이전트는 역할이 아니라 리스크 단위로 나눈다. 자료조사, 템플릿 분석, 스토리, 비주얼, PPTX 빌드, 검증, 점수화는 서로 다른 failure mode를 가진다.

권장 설치 위치

Codex는 repository-scoped skill을 .agents/skills 아래에서 읽을 수 있다. 이 패키지는 아래 위치에 넣는 것을 전제로 한다.

your-project/
  .agents/
    skills/
      slide/
        SKILL.md
        agents/
        references/
  AGENTS.md
  prompts/
  docs/

첫 실행 순서

  1. 이 패키지를 새 repo 루트에 복사한다.
  2. Codex에서 @.agents/skills/slide/SKILL.md와 @prompts/01_bootstrap_project.md를 열어 프로젝트 생성을 지시한다.
  3. 우선 instruction-only skill로 시작한다.
  4. 첫 PoC는 visual_briefing 5장 deck으로 한다.
  5. 그 다음 boardroom_report mode에서 실제 회사 템플릿과 숫자 데이터 검증을 붙인다.

실제 사용 방식

개발 완료 후 $slide는 보통 아래 4가지 방식으로 사용한다.

사용 방식 설명 추천 상황
ChatGPT outline handoff ChatGPT에서 만든 슬라이드 구성을 inputs/01_outline.md로 넘기고 Codex가 deck을 생성·검증 사용자가 이미 내러티브를 잡은 경우
Plan-first controlled build 먼저 slide_plan.md, research_plan.md, template_profile.md만 만들고, 검토 후 deck 생성 임원/이사회/투자 보고
Template-first build 회사 템플릿을 먼저 분석한 뒤 해당 master/layout/font/color를 지켜 생성 편집 가능한 corporate deck
Research-augmented build 필요한 최신 숫자, 이미지, 기술 근거를 조사하고 claim_map.md로 검증 시장/기술/Physical AI/Robotics deck

표준 입력은 자연어 한 덩어리가 아니라 다음 파일 묶음이다.

inputs/00_deck_brief.md
inputs/01_outline.md
template/corporate_template.pptx
data/
sources/
images/

가장 안전한 운영 방식은 ChatGPT에서 storyline을 잡고, Codex에서는 $slide가 그 storyline을 slide_plan.md로 구조화한 뒤 PPTX 생성과 QA loop를 수행하게 하는 것이다. 자세한 사용 시나리오는 docs/USAGE_SCENARIOS.md를 본다.

주요 문서

파일 용도
.agents/skills/slide/SKILL.md Codex가 $slide 호출 시 읽을 핵심 skill instruction
.agents/skills/slide/references/01_modes.md 3개 mode 정의
.agents/skills/slide/references/02_agent_roster.md 멀티에이전트 역할표
.agents/skills/slide/references/03_workflow.md 전체 생성·검증 루프
.agents/skills/slide/references/04_quality_rubric.md mode별 품질점수 체계
.agents/skills/slide/references/05_template_policy.md 템플릿·편집성 정책
.agents/skills/slide/references/06_asset_policy.md 이미지·밈·생성 이미지 출처 정책
.agents/skills/slide/references/07_research_policy.md 자료조사와 출처 검증 정책
.agents/skills/slide/references/08_output_contract.md 산출물 파일 계약
.agents/skills/slide/references/09_repo_integration_strategy.md 기존 GitHub 레포 활용 전략
.agents/skills/slide/references/10_manufacturing_ai_patterns.md 제조업 AI/Robotics 발표 패턴
docs/USAGE_SCENARIOS.md 개발 완료 후 실제 사용 시나리오와 운영 패턴
input_templates/deck_brief.md 표준 deck brief 입력 양식
input_templates/deck_brief.yaml 자동화용 YAML deck brief 입력 양식
input_templates/outline_handoff_template.md ChatGPT에서 만든 슬라이드 구성을 Codex에 넘기는 양식
prompts/ Codex에 바로 붙여 넣을 프롬프트

MVP 범위

MVP는 다음만 해도 충분하다.

  • SKILL.md로 mode routing
  • slide plan 생성
  • OpenAI $slides 기반 PPTX 생성 또는 기존 deck 수정
  • render-to-PNG QA
  • font / overflow / overlap / editability checklist
  • score.json 생성
  • /goal로 target score 도달까지 반복

코드는 두 번째 단계다. 처음부터 모든 validator를 구현하려 하지 말고, Codex가 실행 가능한 QA script 후보를 scripts/TODO.md에서 하나씩 구현하게 한다.

Contributors

terryum

Issues