Slice 스킬은(는) 무엇을 하나요?
글, 노트, 논문, 또는 주제 개요를 세로 1080×1920 카드형 비디오로 변환합니다 — TTS 리듬에 맞춰 페이지가 나뉘며, 13가지 시각 테마가 抖音 / 小红书 / 知乎 / X / 公众号 / 飞书 / TikTok / LinkedIn / 雪球 / 微博 / 即刻 / B 站 / 播客 플랫폼을 지원합니다.
paper-slide에서slice로 이름 변경됨. 제품 이름은 이제 Slice (voxflow.studio/apps/slice)입니다. 기존 슬러그는 더 이상 등록되지 않았으며,paper-slide는 13개 테마 ID 중 하나로만 남아 있습니다.
경로 선택
| 상황 | 경로 | 참고사항 |
|---|---|---|
| 사용자가 덱(deck) JSON만 원함(렌더링 없음) — 빠르고 스크립트 가능, 파이프 가능 | CLI: voxflow slice <article.md> --theme <id> | /api/slice/deck을 직접 호출 (할당량 200, #3307 배포 2에서 /api/paper-slide/slice에서 이름 변경됨). 웹 앱과 동일한 백엔드가 검증한 표준 5~8 카드 덱 JSON 반환, 13개 테마 모두 허용. MP4 없음 — --json을 커스텀 도구, 로컬 Remotion 구성(기여자 전용), 또는 웹 앱에 붙여넣어 렌더링할 수 있습니다. |
| 사용자가 덱을 반복 편집 중 — 렌더링 전에 문구/구조를 여러 차례 수정 | CLI: voxflow slice stage <deck.json> | 로컬호스트 프리뷰 페이지 실행 (할당량 소모 없음), 덱 JSON 저장 시마다 핫 리로드. 유용한 루프: voxflow slice ... -o deck.json → voxflow slice stage deck.json → 프롬프트 조정 → slice 재실행 → 프리뷰 즉시 업데이트. 아래 Stage 경로 참조. |
| 사용자가 완성된 MP4 + 커버 이미지를 원함 (기본 소비자 흐름) | 웹 앱: https://voxflow.studio/apps/slice | 정확히 6개의 Slice 테마를 처음부터 끝까지 실행하는 유일한 장소. 무료 티어는 9:16 MP4 + 다중 비율 커버(9:16/3:4/1:1) 제공. |
사용자가 CLI로 비슷한 비디오를 오프라인에서 원하지만 덱 전용 voxflow slice가 부족할 때 | voxflow present 또는 voxflow picstory --style sketchnote | 근사치일 뿐입니다. 다른 시각적 구성표를 사용하며, Slice의 editorial-mag / notion-card / brutalist / glass-dark 테마를 출력할 수 없습니다. 아래 CLI 근사 경로 참조. |
로컬 체크아웃에 video-present/src/compositions/PaperSlide가 있음 (VoxFlow 기여자만 해당) | 로컬 Remotion 실험 스크립트 | 아래 로컬 Remotion 경로 참조. 참고: 실험 스크립트는 원래 paper-slide 구성만 실행하며, 나머지 12개 테마는 클라우드 워커를 통해서만 렌더링됩니다. |
| 사용자가 전략이나 카피만 원함 | voxflow slice를 통해 덱 JSON 생성 (또는 수동으로 스키마 준수); 어떤 렌더러를 사용할지 알려줍니다. | 덱 스키마는 렌더러에 독립적입니다. 동일한 JSON이 모든 테마에서 렌더링됩니다. |
| 사용자가 오픈소스/패키징을 요청함 | 비공개 API, 토큰, 생성된 오디오, MP4 출력물을 스킬 패키지에 포함하지 마세요. |
워크플로우
- 플랫폼에 맞는 테마를 선택하세요.
references/themes.md를 한 번 읽어보세요 — 13개 테마, 각각의 시각적 특징, 그리고 어떤 플랫폼/콘텐츠 유형에 적합한지 나와 있습니다. 모든 것에paper-slide를 기본값으로 사용하지 마세요. - 시나리오를 선택하세요. 구체적인 사용 사례가 일반적인 내용보다 좋습니다: 논문 요약, 제품 업데이트, 회의 마무리, 경력 조언, 창업자 교훈, 시장 해설, 사고 검토.
- 간결한 덱을 작성하세요. 4-6 카드: 제목 하나 + 본문 3-5개. 각 본문 카드에 하나의 아이디어만 넣으세요. 캡션은 한 줄에 들어갈 만큼 짧게 유지하세요.
- 제어된 키워드로 시각 자료를 선택하세요. 웹에서 검색하거나 렌더링 시에 임의의 이미지를 생성하지 마세요 — 표준
figureKeyword를 선택하면 렌더러가 로컬 손그림 씬/포즈/아이콘에 매핑합니다. (references/deck-schema.md참조.) - 선택한 경로를 통해 렌더링하세요. 정확한 테마는 웹 앱 사용; 근사치는 CLI; 기여자는 로컬 스크립트 사용.
- 결과물을 확인하세요. 완료 보고 전에 지속 시간, 해상도(1080×1920), 그리고 최소 하나의 제목 프레임과 본문 프레임을 확인하세요.
- 경로를 보고하세요. MP4/포스터/프롭스의 절대 경로.
덱 JSON 작성, 키워드 선택, 또는 레이아웃 디버깅 시 references/deck-schema.md를 읽으세요. 시드 덱은 references/example-decks.md를 읽으세요. 테마를 선택하거나 테마의 장단점을 설명할 때 references/themes.md를 읽으세요.
웹 앱 경로 (기본 — 모두에게 작동)
https://voxflow.studio/apps/slice
워크플로우:
- 글/노트를 히어로 컴포저에 붙여넣으세요.
- AI가 5~8개 카드로 분할합니다.
- 테마(13개 옵션 —
references/themes.md참조) + 음성(6개 프로덕션 음성: 男主播 / 霸总男声 / 闲聊男声 / 小美 / 小心 / 小徐)을 선택하세요. - 렌더링 → 1080×1920 mp4 + 다중 비율 커버 (9:16 / 3:4 / 1:1).
이것이 유일하게 13개 테마 모두에 대해 정확한 Slice 렌더링을 제공하는 경로임을 사용자에게 알리세요 — 이들은 비공개 Remotion 구성이며 CLI와 함께 제공되지 않습니다.
CLI 덱 경로 (voxflow slice)
렌더링 없이 구조화된 덱 JSON을 원하는 사용자에게 적합 — 빠르고(왕복 1회, 할당량 200), 파이프 가능, 테마 인식. 웹 앱이 사용하는 동일한 /api/slice/deck 백엔드를 호출하므로 덱 형태는 표준입니다.
voxflow slice article.md # 기본 테마: paper-slide
voxflow slice article.md --theme editorial-mag -o deck.json
voxflow slice --text "긴 글..." --theme bold-poster --json | jq .deck
이 경로를 사용해야 할 때:
- 사용자가 렌더링을 진행하기 전에 AI의 분할 품질을 검사/반복하고 싶을 때.
- 사용자가 덱을 웹 앱의 "덱 가져오기" 흐름에 붙여넣어 다른 테마로 렌더링하고 싶을 때.
- 기여자가 비공개
video-present/src/compositions/PaperSlideRemotion 구성을 가지고 있으며 덱을 로컬에서 렌더링하려 할 때 —voxflow slice ... --json -o props.json후props.json을 실험 스크립트에 입력. - 사용자가 구조화된 출력이 필요한 자동화를 구축 중일 때 (예:
deck.cards[*].caption + narration에서 텍스트로 지식 카드 발행).
제한 사항:
- MP4 없음. 1080×1920 비디오를 생성하는 클라우드 렌더러는 웹 앱에 있습니다.
- TTS 없음. 렌더링 없이 카드별 오디오를 원한다면
voxflow slice를voxflow narrate와 함께 사용하세요.
Stage 경로 — voxflow slice stage (반복 프리뷰)
클라우드 렌더링을 결정하기 전에 인간이 개입하는 반복 단계를 위해 설계되었습니다. Stage는 핫 리로드가 포함된 로컬호스트 HTTP 서버를 시작합니다 — 덱 JSON을 저장할 때마다 페이지가 즉시 업데이트됩니다. 할당량 비용 없음, 네트워크 왕복 없음.
voxflow slice deck.md -o deck.json # 1. 덱 생성 (할당량 200)
voxflow slice stage deck.json # 2. 로컬호스트 프리뷰 열기 (무료)
# 3. 덱.json을 수동으로 편집하거나 slice 재실행
# 4. 저장 시 프리뷰 핫 리로드
할당량 없음, 로그인 없는 스타터를 원하시나요? 번들 샘플을 직접 사용하세요:
voxflow slice stage examples/11-slice-stage/sample-deck.json
플래그:
voxflow slice stage <deck.json> [--port <n>] [--theme <id>] [--no-open]
--port 기본값 5180. 충돌 시 5189까지 +1 자동 건너뛰기.
--theme 프리뷰를 하나의 테마로 고정 (13개 유효 ID 중 하나여야 함).
--no-open 브라우저를 자동으로 열지 않음 (CI/SSH/에이전트 환경용).
Stage를 사용해야 할 때:
- 사용자가 여러 차례 편집 루프에 있을 때 — 카피 조정, 카드 재정렬, 테마 A/B 비교 — 매번 MP4를 다시 여는 것은 비용이 많이 드는 마찰입니다.
- 사용자가 텍스트 우선 플랫폼(X/Twitter/即刻/Threads/Mastodon/블로그 댓글)에 개별 카드를 일반 텍스트로 게시하려 할 때. Stage는 각 카드에 "텍스트 복사" 버튼(제목 + 캡션 + 내레이션)을 제공하고, 덱 수준 도구 모음은 "JSON 복사 / .json 다운로드 / 마크다운으로 복사"를 제공하여 Notion/블로그/飞书에 붙여넣기에 사용합니다. 小红书/微博/公众号 头图용 이미지/캐러셀 내보내기는 카드별 스틸 이미지가 제공되는 향후 단계로 예정되어 있습니다.
- AI 주도 루프에서 에이전트가
deck.json을 재생성하고 인간이 브라우저를 통해 검토하는 경우 — 페이지가 업데이트되며 에이전트가 경로를 다시 인쇄할 필요가 없습니다.
텍스트 내보내기 유틸리티 (Phase 1.4 텍스트 전용)
Stage UI는 텍스트 전용 플랫폼에서 카드를 재사용할 수 있도록 텍스트 우선 내보내기 컨트롤을 제공합니다 (전체 렌더링 비용 없음):
- 카드별 "텍스트 복사" — 아무 카드의 작은 버튼 클릭 → 클립보드에
{제목}\n\n{캡션 (다른 경우)}\n\n{내레이션}(정리됨). 트윗, 即刻 게시물, 블로그 스니펫에 붙여넣기. - 덱 도구 모음 — "JSON 복사" — 전체 덱 JSON을 클립보드에 복사 (커스텀 도구 파이프 / 다른 에이전트와 공유 / 스냅샷 저장 용도).
- 덱 도구 모음 — ".json 다운로드" — 덱을
<seriesTitle>.json으로 저장 (파일명 자동 정리, 최대 60자 +.json). - 덱 도구 모음 — "마크다운으로 복사" — 전체 덱을 마크다운으로 포맷 (H1 = seriesTitle, H2 = 각 카드, 내레이션은 인용문). Notion/블로그 편집기/飞书 문서에 붙여넣기.
포매터는 lib/stage-core/deck-format.js에 있으며 (formatCardAsText, formatDeckAsMarkdown, suggestDeckFilename) 단위 테스트는 tests/deck-format.test.js에 있습니다. 이들의 소스는 Function.prototype.toString()을 통해 제공되는 HTML에 문자열화되어 브라우저가 테스트가 커버하는 동일한 코드를 실행합니다 — 단일 진실 공급원, 이중 유지보수 없음.
小红书 / 微博 / 公众号 头图용 이미지/MP4 캐러셀 내보내기는 Phase 1.4 텍스트 전용에 포함되지 않습니다. 이는 renderStill 카드별 썸네일이 제공되는 향후 Phase에 추가됩니다 (현재 존재하지 않는 백엔드 Remotion 엔드포인트가 필요).
Stage가 아닌 것:
- 아직 완전한 Remotion 프리뷰가 아닙니다. MVP는 덱 구조(카드 + JSON)를 보여줍니다. 클라우드 렌더링된 테마 썸네일은
renderStill을 통해 Phase 1.3에 도입됩니다. - 전체 렌더링의 픽셀을 대체하지 않습니다 — 테마는 서버 측 구성입니다. Stage는 덱 텍스트를 미리보며, 최종 비디오 프레임이 아닙니다.
AI와 함께 편집하는 루프 (실제 반복 워크플로우)
Stage는 Cursor처럼 작동하려 하지 않습니다 — 사용자가 이미 열어 둔 AI 도구(Claude Code, Cursor, ChatGPT 등)에 프롬프트를 전달하는 시각적 피드백 종결자입니다. 두 가지 기능이 전체 편집 루프를 처리합니다:
| 의도 | UX | 출력 |
|---|---|---|
| 전체 카드 재작성 ("이 카드만 재생성하고 나머지는 유지") | 카드에 마우스 오버 → 모서리 버튼 AI로 편집 | 프롬프트가 포함된 모달: 파일 경로 + cards[N] JSON 스니펫 + <사용자 지시> 입력란 |
| 로컬 구문 재작성 ("이 구문만 어색함") | 카드 내 텍스트 선택 → 플로팅 선택 항목 AI로 편집 버튼 표시 | 프롬프트가 포함된 모달: 파일 경로 + 선택한 정확한 하위 문자열 인용 + 컨텍스트를 위한 전체 카드 JSON |
사용자가 지시를 입력하면(예: "12자로 줄이고, 더 감성적으로"), 프롬프트 복사 버튼을 클릭하여 자신의 AI에 붙여넣습니다. AI는 자체 파일 편집 도구(Claude Code의 Edit, Cursor의 Apply 등)를 사용하여 파일을 다시 씁니다. Stage의 SSE 감시자는 약 150ms 내에 프리뷰를 핫 리로드합니다. 만족할 때까지 반복합니다.
이 디자인이 임베디드 채팅/MCP 서버 대신 사용된 이유는 #3330에서 확인할 수 있습니다 (범용 복사-붙여넣기 대 Claude Code 전용 MCP, 비용 대 커버리지 트레이드오프, 사용량 텔레메트리에 따른 향후 MCP 업그레이드 경로).
CLI 근사 경로 (전체 MP4 대체)
사용자가 CLI만으로 MP4를 반드시 가져와야 하는 경우(웹 앱 없음, 기여자 Remotion 액세스 없음), voxflow present 또는 voxflow picstory로 대체하세요 — 이들은 동일한 글-비디오 변환 형태를 사용하지만 자체 시각적 구성표를 가지며, 정확한 13개 Slice 테마는 아닙니다.
voxflow present --text "글 또는 요약을 붙여넣기" --style editorial --output slice-approx.mp4
voxflow picstory --topic "주제" --style sketchnote --scenes 4 --output slice-sketch.mp4
Slice 테마별 가장 가까운 CLI 구성표:
| Slice 테마 | 가장 가까운 CLI 경로 |
|---|---|
| paper-slide | voxflow picstory --style sketchnote |
| editorial-mag | voxflow present --style editorial |
| bold-poster | voxflow present --style brutalist (가장 가까운 무게감) |
| notion-card | voxflow present --style minimal |
| brutalist | voxflow present --style brutalist |
| glass-dark | voxflow present --style noir 또는 --style aurora |
| editorial-stencil | voxflow present --style editorial (레터박스/듀얼톤 동등 없음) |
| broadsheet | voxflow present --style editorial (FT 연어 팔레트 없음) |
| blueprint | voxflow picstory --style chalkboard (가장 가까운 그리드/다이어그램 느낌) |
| daisy-pastel | voxflow picstory --style sketchnote (파스텔 일러스트 동등 없음) |
| showa-catalog | voxflow picstory --style vintage_newspaper (시티팝 동등 없음) |
| photo-feature | voxflow picstory --style photo (photo-feature는 카드별 imageUrl 필요 — deck-schema 참조) |
| atmospheric | voxflow present --style noir |
항상 사용자에게 알리세요: "이것은 Slice와 유사한 초안입니다. 정확한 13개 테마 렌더러는 voxflow.studio/apps/slice에 있습니다."
로컬 Remotion 경로 (기여자 전용)
체크아웃에 video-present/src/compositions/PaperSlide가 없다면 건너뛰세요 — 비공개 코드이며 npm/스킬 사용자는 가지고 있지 않습니다.
기여자 체크아웃 루트에서:
cd video-present
node scripts/paper-slide-experiments.mjs
하위 집합 렌더링:
cd video-present
PAPER_SLIDE_EXPERIMENT_FILTER=research-reading node scripts/paper-slide-experiments.mjs
출력 확인:
ffprobe -v error -select_streams v:0 \
-show_entries stream=width,height,duration \
-of default=nw=1 out/paper-slide-experiments/research-reading.mp4
ffmpeg -y -hide_banner -loglevel error -ss 9 \
-i out/paper-slide-experiments/research-reading.mp4 \
-frames:v 1 -q:v 2 out/paper-slide-experiments/research-reading-body.jpg
예상: 1080×1920, 20-35초, 검은색 플래시 없음, 캡션 오버플로우 없음, 그림 잘림 없음.
덱 작성 규칙 (13개 테마 모두에 적용)
- 제목 카드: 후크, 대비, 또는 약속. "Introduction"과 같은 추상적인 레이블은 피하세요.
- 본문 카드: 하나의 아이디어만. 캡션은 보통 중국어 16자 또는 영어 7단어 미만.
- 내레이션: 대화체, 본문 카드당 중국어 25~60자.
- 씬 키워드 (적합할 때 선호):
problem-framing,evidence-board,customer-pain,timeline-review,owner-deadline,risk-guardrail,cashflow-ledger,team-alignment,before-after,learning-loop,decision-fork,growth-system. - 도형 / 아이콘 키워드 (시각적 강조):
thinking,running,climbing,stuck,celebrating,briefcase,users,target,clock.