Communitygithub.com

slides-genedit

연구 자료를 바탕으로 학술 발표용 슬라이드 데크를 생성하고 편집합니다. (1) 제한된 청중, 시간, 슬라이드 수 제약 조건 하에 논문/노트에서 새 데크를 생성하고, 각 슬라이드의 주장, 인용 증거 매핑, 발표자 노트, 렌더링된 PDF 미리보기를 제공합니다. (2) 기존 데크를 원본 보존 방식으로 편집하여 인벤토리를 작성하고, 요청된 로컬 변경만 적용하며, 수정되지 않은 슬라이드가 바이트 단위로 동일하게 유지되었음을 입증합니다.

slides-genedit란 무엇인가요?

이 스킬은 연구 자료(논문, 노트, 기존 데크)를 체계적이고 증거 기반의 학술 발표 슬라이드로 변환하거나 수정하는 두 가지 주요 경로를 제공합니다. 첫 번째 경로(GENERATE)는 청중, 시간, 슬라이드 수 제약 조건에 따라 새 데크를 완전히 생성하며, 각 슬라이드는 하나의 주장에 집중하고 모든 숫자와 인용은 원본 자료에서 그대로 가져와 증거 맵에 기록합니다. 두 번째 경로(EDIT)는 기존 데크를 변경할 때 요청된 부분만 수정하고 나머지 슬라이드는 바이트 단위로 동일하게 유지함을 검증합니다. 이 스킬은 Cursor, Claude Code, Codex와 같은 터미널 기반 AI 에이전트에서 사용하기 위해 설계되었으며, 제공된 Python 스크립트(parse_case, assemble_deck, inventory_deck, edit_deck, render_check)가 결정론적 작업(파싱, 조립, 검증, 렌더링)을 처리합니다. 핵심 지적 작업인 자료 선택, 배열, 슬라이드 주장 및 증거 할당은 사용자가 직접 수행해야 하며, 스크립트는 이를 보조하고 검증하는 역할을 합니다. 예산 관리(~7 도구 단계, 900초 이하)가 강조되며, 초기 설정으로 결과 JSON 골격을 생성하여 중간 충돌에도 인도 가능한 결과물이 남도록 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/slides-genedit

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

slides-genedit — 학술 PPT 생성 및 원본 보존 편집

당신은 연구 자료(논문, 노트, 기존 데크)를 편집 가능하고 증거가 추적된 학술 발표 자료로 변환하고, 요청되지 않은 부분을 건드리지 않고 기존 데크를 편집합니다. 중요한 부분은 선택과 순서이며, 단락을 복사하는 것이 아닙니다: 어떤 결과가 자체 페이지를 가질 자격이 있는지, 메서드에 몇 개의 불릿이 필요한지, 어떤 그림이 먼저 나와야 하는지, 페이지 예산을 초과했을 때 무엇을 잘라낼지 결정합니다. 이러한 판단은 직접 내리고, scripts/의 스크립트는 결정론적 작업(파싱, 조립, 검증, 렌더링)을 수행합니다. 스크립트가 있을 때 XML을 수동으로 조립하지 마십시오.

경로 디스패치 (먼저 결정하고, 절대 혼용하지 마십시오)

/input/case.json과 task.md를 읽으십시오. 아래 1단계(parse_case.py)를 실행하면 경로 힌트와 그 증거를 출력합니다. 작업 내용과 대조하여 확인하십시오:

  • GENERATE — 입력에 시작 데크가 없습니다 (연구 자료 + 청중/시간/슬라이드 수 제약 조건 + 템플릿). 새 데크를 구축합니다.
  • EDIT — 시작 데크(.pptx)가 제공되고 AND 지시 사항이 로컬 변경(修改/压缩/换受众/加页/删页/调整)을 요청합니다. 인벤토리를 작성하고 정밀 작업을 적용합니다. 편집은 다음을 보존해야 합니다: 수정되지 않은 슬라이드는 바이트 단위로 동일, 마스터/레이아웃은 변경되지 않음, 템플릿 스타일 유지, 대상이 아닌 슬라이드의 노트 유지.
  • 데크가 존재하지만 지시 사항이 대부분의 콘텐츠를 다시 작성하거나 전체 내러티브를 재구성하는 경우, 이는 GENERATE 실행으로 간주합니다 — 동일한 템플릿으로 새로 만들고 시작 데크는 N-1 버전으로 보관합니다. 경로 결정과 그 증거를 기록하십시오.

예산 규율 유지: 약 7개의 도구 단계가 적정하며, 총 64개의 모델 요청 / 900초 이내. 1단계는 이미 완전한 계약에 부합하는 result.json 골격을 작성하므로, 그 이후 어떤 지점에서 충돌이 발생하더라도 검증 가능한 결과물이 남습니다. 이를 점진적으로 개선하고, 골격 상태로 남겨두지 마십시오.

1단계 — 입력 파싱, result.json 기초 작성 (두 경로 모두)

python scripts/parse_case.py --input /input/case.json --workdir /app/work --output-dir /app/output

경로를 확정하기 전에 출력된 경로 힌트와 실제 작업 텍스트를 모두 읽으십시오 (힌트는 증거이지 최종 판결이 아닙니다). 제약 조건 스캔(case-parsed.json)을 task.md와 직접 대조하여 확인하십시오 — 키워드 스캔은 놓치거나 과도하게 일치시킬 수 있습니다. 작업 설명이 우선입니다. 존재하는 모든 입력 파일(material*.md/pdf/tex, 그림)을 읽고, PDF의 경우 제공된 pdf-text-tool / pdf-render-tool / ocr-tool을 사용하십시오. 파일 이름에서 내용을 추측하지 마십시오.

2단계 — 인용문 캡처와 함께 추출 (GENERATE 경로)

실제 자료에서 연구 질문, 방법, 결과, 한계점 (내러티브의 핵심)을 추출합니다. 자료를 읽는 동안, 슬라이드에 나올 수 있는 모든 숫자와 주장에 대해 위치(절, 표, 그림)와 함께 인용문을 캡처합니다. 이것이 증거 맵이며, 한 번 수집하여 3단계와 7단계에서 재사용합니다. 자료에 결론/결과가 없는 경우, reference/exception-playbook.md #1을 적용합니다: 추론임을 표시하고, 절대 창작하지 마십시오.

3단계 — 페이지 수준 개요: 귀하의 판단, 기록됨 (GENERATE 경로)

reference/schemas.md에 따라 /app/work/outline.json을 작성합니다. 이는 핵심 지적 단계입니다 — 템플릿이 아닌 직접 수행하십시오:

  • 한 페이지 = 하나의 주장. 제목은 페이지의 메시지를 진술합니다 ("실험 결과"가 아닌 "결과: 동일 압축률에서 형상 오류 38.2% 감소"). 모든 슬라이드는 role (problem/method/result/limitation/...)과 발표자 notes (대본 — 노트 없는 데크는 불완전합니다)를 가져야 합니다.
  • 숫자는 그대로. 자료에서 숫자를 정확히 복사하십시오 (약 28이 아닌 28.4 BLEU, 42가 아닌 41.8). 각 숫자의 출처는 해당 슬라이드의 evidence에 포함됩니다. 숫자의 출처를 찾을 수 없으면 슬라이드에 넣지 마십시오.
  • 청중/시간 예산에 맞춘 선택. ~1-2분당 1슬라이드. 동료 그룹: 방법 세부 사항이 중요. 검토 위원회: 진행 상황과 계획이 중요. 논문 심사: 기여와 증거가 중요. 결과는 논문 절 순서가 아닌 내러티브 힘에 따라 정렬하십시오 (좋은가? → 얼마나? → 유효한가?).
  • 그림: 비트맵인 경우 원본 이미지와 그대로의 캡션을 인용하십시오. 데이터 테이블이 있는 경우에만 다시 그리십시오. 이미지만 있는 결과는 자체 페이지가 필요합니다. 부차적인 그림은 병합하거나 마지막 슬라이드 이후 백업 페이지로 이동하십시오.
  • decisions 로그: 유지/삭제/병합/재배치된 모든 항목과 그 이유 ("표 2 절제 — 페이지 예산 6페이지, 주요 결과 우선"). 이는 검증 가능성 증거이자 사례 연구 자료이므로, 빈 결정은 버그입니다.

4단계 — 데크 조립 (GENERATE 경로)

python scripts/assemble_deck.py --outline /app/work/outline.json \
  --template <template.pptx if provided> --out /app/output/deck_v1.pptx \
  --workdir /app/work/scratch

assembly-report.json을 읽으십시오. 오버플로우 위험, 레이아웃 폴백, 또는 예산 초과가 보고되면 (데크가 아닌) 개요를 수정한 후 다시 실행하십시오 — 데크와 결정 로그는 일관성을 유지해야 합니다. 스크립트는 다음을 보장합니다: 콘텐츠는 슬라이드 수준의 플레이스홀더에 배치되며 (누락 시 레이아웃에서 복제 — 레이아웃 플레이스홀더에 쓰면 렌더링되지 않음), 이미지는 종횡비가 유지되도록 잘리고(왜곡되지 않음), 노트는 첨부됩니다.

2'단계 — 시작 데크 인벤토리 작성 (EDIT 경로)

python scripts/inventory_deck.py --deck <starting.pptx> --out /app/work/inventory.json

인벤토리를 읽으십시오. 지시 사항이 명명한 정확한 대상을 찾으십시오 (슬라이드 인덱스 + 플레이스홀더 ID / 셰이프 이름). 편집 대상이 없으면 예외 처리 규칙 #8을 적용합니다: 명확하게 실패 선언, 대상을 재지정하거나 추가하되, 절대 조용히 건너뛰지 마십시오.

3'단계 — 정밀 편집 작업 작성 (EDIT 경로)

reference/schemas.md (작업 스키마)에 따라 /app/work/ops.json을 작성합니다. 작업은 1부터 시작하는 슬라이드 인덱스에 순서대로 적용됩니다. 지시 사항이 요청한 것만 포함합니다: replace_text (기존 서식 유지), append_bullets, set_notes, insert_image (종횡비 유지), add_slide, delete_slide, move_slide, duplicate_slide. 작업을 통해 전체 데크를 다시 쓰는 것은 오용이므로 경로를 전환하십시오.

4'단계 — 편집 적용 및 보존 확인 (EDIT 경로)

python scripts/edit_deck.py --deck <starting.pptx> --ops /app/work/ops.json \
  --out /app/output/deck_v2.pptx --workdir /app/work/scratch

edit-report.json을 확인하십시오: 모든 작업 ok; slides_identical_raw >= source slides − touched slides; masters_untouched 및 layouts_untouched가 true여야 합니다. 편집되지 않은 슬라이드가 구조적으로도 동일하지 않으면 편집이 누출된 것입니다 — 예외 처리 규칙 #9입니다. 다시 렌더링한 후 전달하십시오.

5단계 — 렌더링 및 확인 (두 경로 모두)

python scripts/render_check.py --pptx /app/output/deck_v1.pptx --outdir /app/output/render/

PDF 미리보기가 존재해야 하며 페이지 수는 슬라이드 수와 일치해야 합니다. 오버플로우, 글꼴 대체, 이미지 잘림이 있는지 미리보기를 검사하십시오 (pdf-render-tool / office-renderer 사용 가능). 미리보기의 글꼴 대체는 불확실성으로 기록됩니다 — 렌더러를 만족시키기 위해 데크의 템플릿 글꼴을 다시 작성하지 마십시오 (예외 처리 규칙 #4). 렌더링이 불가능하면 .pptx를 유지하고 실패를 정직하게 기록하십시오 (예외 처리 규칙 #6).

6단계 — 의도적으로 반복 (두 경로 모두)

사용자 피드백은 현재 데크에 대한 새로운 편집 지시 사항으로 도착합니다: 최신 버전에 대해 2'단계(EDIT 경로)로 돌아가십시오. 이전 버전을 유지하십시오 (deck_v1.pptx, deck_v2.pptx, ...) — 절대 덮어쓰지 마십시오. 각 렌더링 보고서와 작업 로그/결정 차이는 버전 기록입니다. 각 라운드에서 회귀를 확인하십시오: 수정되지 않은 슬라이드가 동일하게 유지되었습니까?

7단계 — result.json 최종 완료 (두 경로 모두)

/app/output/result.json (1단계의 골격)을 최종 값으로 업데이트하십시오: case.json의 모든 output_contract 필드가 채워짐 — 프레젠테이션 파일, 슬라이드 수, 슬라이드별 증거 매핑 (위치 + 인용문), 렌더링 미리보기 경로, 발표자 노트 상태; 편집 실행은 작업 로그와 보존 매트릭스를 추가합니다. 실제로 생성할 수 없었던 필드는 null로 두고 unanswered에 이유를 기재하십시오. status ∈ complete | partial (한계 언급). 그런 다음 중단하십시오 — .pptx, 노트, PDF 미리보기, result.json을 전달합니다.

불가침 규칙

  • 슬라이드의 숫자/인용문은 인용된 출처를 추적해야 합니다. 허구의 수치, 눈대중 재그림, 조용한 반올림은 금지됩니다.
  • EDIT 경로는 절대 마스터/레이아웃이나 대상이 아닌 슬라이드를 건드리지 않습니다. 보존 매트릭스가 이를 증명합니다.
  • result.json에서는 항상 가짜 성공보다 정직한 실패를 우선시합니다.
  • 템플릿, 종속성, 스키마, 예외 처리 규칙은 README.md 및 reference/에 있습니다. 이에서 벗어나기 전에 읽으십시오.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

biopathway-mechanism-diagram

Build or edit publication-grade biological mechanism/pathway diagrams from research materials (PDF/text) as a challengeable mechanism statement - three-layer model (typed entities, typed directed edges with verbatim evidence, compartment layout), semantics-correct SVG source, PNG/PDF exports and a traceable, uncertainty-aware result.json. Use for tasks asking to draw, generate or edit signaling pathways, mechanism figures, crosstalk diagrams or pathway flowcharts; refuses to guess regulation direction and marks unstated information instead.

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

relationship-schematic

Generate or edit scientific entity-relationship schematics (mechanism diagrams, pathway chains, experimental workflows, structural containment) as traceable, editable SVG with verified relation semantics. Extracts an evidence-quoted entity/relation table first, renders a layered SVG from it, reads the drawing back to verify every relation type, direction and containment, then exports 300-dpi PNG and vector PDF. Use for any "draw a mechanism/workflow/relationship figure from this paper or case material" task where scientific correctness of entities, arrow directions and hierarchy matters.

관련 스킬