TL;DR

  • agy-ppt는 Antigravity, Kiro, Codex를 연결해 근거에 기반하고 실제 발표에 활용할 수 있는 파워포인트를 제작하는 에이전트 스킬임.
  • Antigravity가 개요·디자인 방향·내용·품질을 관리하고, Kiro가 엔지니어링을 담당하며, Codex의 GPT 이미지 모델이 슬라이드 이미지를 생성한 뒤 발표자 노트가 포함된 .pptx로 조립함.
  • 번체 중국어가 많은 슬라이드에서 Gemini 이미지 생성은 글자 수용량과 가독성이 부족하고 GPT는 수십 자를 처리할 수 있어, 이 분업은 선호가 아닌 실측에 따른 선택임.
  • 결과물은 이미지로 시각적 세부 사항을 보존하면서 편집 가능한 텍스트·네이티브 차트·교체 가능한 이미지를 적절히 포함하는 혼합형 파워포인트임.
  • 스킬 로드 및 이미지 생성이 가능한 에이전트 환경이 필수이며, 기본 진행 절차에는 개요·스타일·실제 샘플 승인이 포함되고 승인이 끝나기 전에는 전체 프레젠테이션을 생성하지 않음.

개요

  • agy-ppt는 Antigravity + Kiro + Codex 파이프라인을 위한 프레젠테이션 스킬임.
  • Antigravity는 감독 역할로 개요, 디자인 방향, 내용, 품질을 관리하고 Kiro는 모든 엔지니어링을 담당함.
  • Codex의 GPT 이미지 모델은 각 슬라이드를 이미지로 생성하고, 결과물을 발표자 노트가 포함된 .pptx로 조립함.
  • Gemini 대신 이미지 생성에 GPT를 사용하는 이유는 실측 결과 Gemini가 번체 중국어를 이미지에 많이 담지 못해 글자가 많으면 흐려지거나 잘못 쓰는 반면, GPT는 같은 레이아웃에서 수십 개의 중국어 문자를 처리하기 때문임. 프레젠테이션은 텍스트 밀도가 가장 높은 상황이므로 이 분업은 선호가 아니라 현실적 제약에 따른 선택임.
  • 결과물은 이미지로 시각적 세부 사항을 보존하는 동시에 적절한 경우 편집 가능한 텍스트, 네이티브 차트, 교체 가능한 이미지를 유지하는 혼합형 파워포인트임.
  • 스킬을 불러올 수 있고 이미지 생성 기능을 갖춘 에이전트 환경이 필요함. 이 프로젝트는 Codex 내장 이미지 생성 기능으로 구현 및 테스트했으며, 이미지 생성 기능이 없는 환경에서는 실행할 수 없음.
  • 제공 항목: 공식 웹사이트, 예시, 기여 안내.

쇼케이스

  • Dense Executive: 고밀도 서사, 구조화된 정보 카드, 네이티브 차트, 용도별 교체 가능 이미지.
  • Balanced Executive: 명확한 계층 구조, 중간 수준의 시각적 밀도, 편집 가능한 파워포인트 구성 요소.
  • 두 스타일 모두 편집 가능한 텍스트, 적절한 경우 네이티브 차트, 교체 가능한 이미지를 유지하며 단일 레이아웃에 한정되지 않음.
  • 재현 가능한 예시에서 슬라이드 미리보기 4장, 프롬프트, 개요, 스타일 설정, 자료 출처를 확인할 수 있음.

설치

  • 요구 사항은 Python 3.11 이상, Git, 로그인되어 있고 이미지 생성 도구를 사용할 수 있는 에이전트 환경임.
  • 저장소를 https://github.com/sujunmin/agy-ppt.git에서 복제한 뒤 agy-ppt 디렉터리로 이동하고, skills/agy-ppt/scripts/codex_ppt_runtime.py bootstrap을 실행해 공용 런타임과 실행 의존성을 설치함.
  • 이어 ~/.gemini/config/skills 디렉터리를 만들고 ./skills/agy-ppt/의 내용을 ~/.gemini/config/skills/agy-ppt/에 동기화함.
  • bootstrap은 공용 런타임을 만들고 실행에 필요한 의존성을 설치하지만, 테스트나 OCR 적격성 검증을 실행하거나 예시 프레젠테이션을 생성하지 않음.
  • 다른 에이전트에서는 skills/agy-ppt/를 지원되는 워크스페이스 스킬 위치에 배치할 수 있음.

기본 사용법

  • agy-ppt 스킬을 불러온 뒤 주제, 대상 청중, 슬라이드 수, 출처를 AGY에 전달함. 예를 들어 부서장을 대상으로 하는 번체 중국어 10장짜리 보고서 프레젠테이션을 요청할 수 있음.
  • 기본 상호작용 절차는 다음 순서임.
  • 개요 확인
  • 시각 스타일 확인
  • 실제 샘플 슬라이드 검토
  • 승인 후 전체 프레젠테이션 생성
  • 개요나 스타일을 수정하면 이에 의존하는 샘플 승인이 무효화됨. 세 가지 승인이 완료되기 전에는 전체 프레젠테이션을 생성하지 않음.
  • 고밀도·카드형·이미지 중심 레이아웃을 명시적으로 선택할 수 있으나, 이는 선택 사항임. 기본값은 균형 잡힌 밀도이며 반복 이미지, 내용이 빈약한 카드, 출처가 뒷받침하지 않는 텍스트로 분량을 채우지 않음.

작동 방식

  • 사용자 요청 및 출처에서 시작해 개요 승인, 스타일 승인, 단일 샘플 승인, 전체 프레젠테이션 생성 순서로 진행함.
  • OCR이 포함된 출처는 추적 가능한 증거를 먼저 만들고 이를 AGY에 전달해 판단하게 함. PDF·이미지에서 추출 및 OCR 증거를 생성하고 출처에 근거를 연결한 뒤 AGY에 전달함.
  • AGY는 항상 유일한 오케스트레이터이자 의미 판단자임. OCR 및 이미지 작업자는 내용을 자체적으로 다시 작성하거나 승인 단계를 건너뛰지 않음.

지원 입력

  • Markdown, 일반 텍스트, DOCX, 정적 HTML, 기존 출처 시스템이 지원하는 공개 원격 콘텐츠.
  • 검색 가능한 PDF, 스캔 PDF, 혼합형 PDF.
  • PNG, JPEG, 단일 프레임 TIFF.
  • 다중 프레임 TIFF는 명시적으로 거부됨. OCR 정확도는 출처 품질, 제공자, 모델에 따라 달라짐.

문서

  • 프레젠테이션 승인 절차.
  • Phase 16: 근거에 기반한 프레젠테이션 계획 및 사람의 편집 품질.
  • Phase 17: 프레젠테이션 전략 지능 및 실제 전달 품질.
  • Phase 18: 전달물의 충실도, 이식성, 지능형 편집 기능.
  • 아키텍처 및 역할 분담.
  • 출처 수집, 추출, 근거 연결.
  • OCR 아키텍처 및 제공자.
  • 보안, CI, 개발 테스트.
  • 장애 복구.
  • 변경 기록.
  • 개발자의 전체 테스트 및 릴리스 적격성 검증 명령은 위의 CI·테스트 문서에 있으며, 일반 사용자 설치 절차에는 포함되지 않음.

기여

  • 버그 수정, 문서, 테스트, 프레젠테이션 품질 및 레이아웃 개선, 파워포인트 호환성 수정, 신규 기능 기여를 환영함.
  • 작고 범위가 명확한 PR은 바로 제출할 수 있음. 제품 절차, AGY의 의미 판단 권한, 동결된 계약, 주요 아키텍처를 변경하는 경우에는 먼저 이슈나 토론을 개설해야 함.
  • 시각적 변경은 실제 렌더링 결과를 확인해야 하며, 단위 테스트 통과만으로 프레젠테이션 품질이 검증되는 것은 아님. 자세한 내용은 기여 안내를 참조함.

프로젝트 상태 및 라이선스

  • Phase 15의 OCR 및 출처 근거 연결 파이프라인, Phase 16의 근거 기반 프레젠테이션 및 편집 품질, Phase 17의 프레젠테이션 전략 및 실제 전달 품질, Phase 18의 전달물 충실도·이식성·지능형 편집 기능 기준선이 모두 완료되어 동결된 상태임.
  • 네이티브 텍스트, 도형, 차트, 이미지 객체를 사용하는 혼합형 파워포인트 출력은 근거가 있는 사실의 불변성과 승인된 시각 품질을 보장하면서 업무상 중요한 필드의 편집과 이미지 교체 기능을 제공함.
  • 100% 네이티브 편집, 클라이언트 간 완벽한 호환성, 글꼴의 보편적 이식성은 보장하지 않음.
  • Linux x86_64가 주요 프로덕션 대상이지만, 정식 배포에는 하드 격리 검증이 여전히 필요함. macOS는 개발 및 API 검증 용도이며, Windows는 프로덕션 보안 적격성 검증을 통과하지 않음.
  • OCR JSON 스키마는 아직 보류 상태임.
  • 프로젝트는 MIT 라이선스를 사용하며 ningzimu/codex-ppt-skill에서 파생된 것으로, 업스트림 공식 버전은 아님. 제3자 라이선스 정보는 THIRD_PARTY_NOTICES.md에 있음.