데모데이은(는) 무엇을 하나요?
리포지토리(GitHub 또는 로컬 폴더)와 라이브 웹 앱 또는 네이티브 macOS 앱을 입력으로 받아 마치 앱 자체 디자이너가 만든 듯한 45~75초 1080p 데모 비디오를 생성합니다. 이 도구는 이 스킬과 함께 제공되는 Node/TS CLI입니다. 당신이 감독입니다. 당신이 스토리보드(plan.json)를 작성하면 도구가 녹화하고 렌더링합니다. API 키가 필요 없습니다.
0. 도구 찾기 및 설정 (TOOL)
TOOL은 이 스킬의 기본 디렉토리입니다. (일반 설치인 경우 package.json이 포함된 전체 리포지토리가 ~/.claude/skills/demoday에 클론됩니다.) 그렇지 않으면 ~/demoday입니다. 둘 다 존재하지 않으면 중단하고 사용자를 README의 설치 단계로 안내하십시오.
머신에서 처음 실행 시 (TOOL/node_modules가 없는 경우):
node --version을 확인하십시오 (≥ 20 필요). 없으면 Node.js를 설치하도록 사용자에게 안내하고 중단하십시오 (brew install node또는 nodejs.org).TOOL에서npm install && npx playwright install chromium을 실행하십시오. 약 300MB를 다운로드하므로 시작 전에 사용자에게 알리십시오.- Mac 앱의 경우
xcrun swiftc --version도 확인하십시오. 없으면 사용자에게xcode-select --install을 실행하도록 요청하십시오. 헬퍼는 첫 사용 시 스스로 컴파일됩니다.
아래 모든 명령은 TOOL에서 실행됩니다. OUT = out/<소유자>__<리포지토리> (도구가 출력). 비디오는 TOOL/out/ 안에 남아 있으므로 사용자에게 전체 경로를 알려주십시오.
1. 수집
npx tsx src/cli.ts <소유자/리포지토리 또는 github url> [--url <라이브 앱 url>] --prepare
라이브 웹 URL이 필요합니다 (--url, 또는 리포지토리의 홈페이지). 또는 네이티브 macOS 앱의 경우 아래 "네이티브 Mac 앱"을 참조하십시오. 이 명령은 리포지토리를 읽고 앱을 프로브하여 OUT에 다음 파일들을 씁니다:
prompt.md (감독 규칙 + README + 매니페스트 + 파일 트리 + 접근성 스냅샷), probe.png (첫 화면 스크린샷), probe.aria.yml.
prompt.md를 읽고 probe.png를 살펴보십시오. src/schema.ts를 읽으십시오. 이것이 plan.json의 정확한 형태이며, 필드 설명이 규칙입니다 (단어 제한, 각 비트가 해야 할 일).
2. 글을 쓰기 전에 스토리 찾기
비디오의 성패는 두 가지에 달려 있습니다: 현 상태가 왜 나쁜지와 이 제품의 특별한 점이 무엇인지.
- 현 상태: 대상 사용자가 이 제품 없이 오늘날 수행하는 구체적인 작업 흐름. 각 단계의 정직한 시간 비용을 포함하십시오. 경쟁사에 대한 공정한 주장만 하십시오.
- 특별한 점: 이것을 가능하게 하는 메커니즘 (README/코드에서 파악). 형용사가 아닙니다. "오직 X만 …".
- README가 과소평가한 기능을 위해 코드를 읽으십시오: 항상 존재하는 데스크톱이나 메뉴 막대 아이콘, 글로벌 핫키, 오프라인/로컬 저장소, 마스코트. 이것들이 종종 실제 차별화 요소입니다. 비디오에 넣기 전에 주장하는 모든 기능을 코드에서 확인하십시오.
- 사용자가 자신의 포지셔닝, 경쟁사 또는 차별화 요소를 알려줬다면 그들의 것을 사용하십시오. 무엇이 다르게 만드는지 드러나는 것이 없으면 계획을 작성하기 전에 짧은 질문 하나를 하십시오.
3. 앱 스타일 일치 (필수)
비디오는 앱의 일부처럼 보여야 합니다: 동일한 색상, 동일한 글꼴, 동일한 마스코트 또는 아이콘, 동일한 어조. 아늑한 파스텔 앱에 일반적인 어두운 런칭 템플릿(또는 그 반대)은 브랜드에서 벗어난 것으로 읽힙니다. 사용자가 즉시 알아차립니다.
- 코드에서 앱의 디자인 토큰 추출:
- SwiftUI/AppKit:
Theme.swift스타일 파일,Assets.xcassets/*.colorset,Color(hex:)호출. - 웹: CSS 커스텀 속성,
tailwind.config.*, 테마 파일,<meta name="theme-color">. - 수집: 배경, 텍스트, 카드/패널, 강조, 표시/본문 글꼴.
- 글꼴: 리포지토리에 번들된 글꼴 파일 선호 (
Resources/Fonts/*.ttf,public/fonts,@font-face소스,next/font/local). - 마스코트/아이콘: 스프라이트, 앱 아이콘 (
AppIcon.icns→sips -s format png … --out icon.png), 또는 로고 SVG/파비콘.
- SwiftUI/AppKit:
- 앱의 UI에서 분위기를 선택하십시오. 카테고리가 아닙니다. UI가 밝고 따뜻하며 장난기 있거나 미니멀하면
mood: "soft"를 사용하십시오. 앱 자체가 어둡고 기술적이거나 대비가 높으면bold(기본 어두운 런칭 느낌)를 사용하십시오. plan.look채우기:"look": { "mood": "soft", "paper": "<앱 배경>", "ink": "<앱 텍스트>", "surface": "<앱 카드>", "fontFile": "<리포지토리 글꼴 파일>", "bodyFontFile": "<선택 사항>", "motifImage": "<앱 아이콘/마스코트 png/svg>" }product.accent를 앱의 강조색으로 설정하되paper에서 읽을 수 있는 색조로 설정하십시오. 라이트 모드 강조색이 일반적으로 소프트에 적합합니다.- 흐릿한 텍스트와 선은
paper/ink에서 자동으로 파생됩니다. - 글꼴 파일이 없으면
display(Inter Tight, Pixelify Sans, Fredoka, Nunito)를 사용하십시오. 다른 Google 글꼴을 지원하려면remotion/lib.ts와 스키마 열거형의DISPLAY에 추가하십시오. motif: "loaf"는 내장된 픽셀 로프 스프라이트입니다 (베이커리 앱 전용). 그렇지 않으면motifImage를 사용하십시오.- CLI는 이 파일들을
OUT/brand/에 복사합니다. 경로는 절대 경로이거나 로컬 리포지토리에 상대적일 수 있습니다.
- 어조를 일치시키십시오: 캡션과 헤드라인에 앱 자체의 마이크로카피와 은유를 차용하십시오 (예: 베이커리 앱의 "반죽 / 부풀리기 / 구움").
- 기본적으로 미니멀:
- 카피 예산: 후크 ≤ 8단어, 기존 방식 약 3단계, 비교 행 3개, 캡션 2~5단어, 필수적인 것 외에는 레이블이나 통계 없음.
- 너무 많은 단어와 시끄러운 빨간색 경고 스타일링이 최고 불만 사항이었습니다. 소프트 룩은 이미 카운터, 고통 레이블, 흔들림 및 도장을 제거합니다.
4. OUT/plan.json 작성
prompt.md 상단의 감독 규칙을 따르십시오. 녹화 규칙 (newWay.actions):
- 전체 핵심 루프를 다루십시오. 단 하나의 결과로 가는 최단 경로만이 아닙니다. 사용자는 헤드라인 기능이 누락되면 알아차립니다. 10~20개 동작을 목표로 하고 (최대 20개), 각 기능은 자체 캡션 비트를 가지며, 기존 방식과 동일한 작업을 수행하고 성과로 끝나야 합니다. 웹: 첫 번째 동작은 라이브 URL로
goto입니다. - 거의 모든 동작에 캡션을 추가하십시오. 캡션이 없는 비트는 음소거된 시청자에게 침묵으로 읽힙니다.
- 카메라: 각 동작의 대상 상자에 푸시인됩니다. 대상이 지정되지 않은
fill/press동작은 포커스가 있는 필드를 조준합니다. 녹화기는 키가 전송된 후 위치를 기록하며, 타이핑 샷은 텍스트 시작 부분에서 2배로 확대됩니다. 캡션은 창 아래 자체 대역에 있으며 앱을 절대 가리지 않습니다. 샷이 잘못된 것을 프레이밍하면 대상을 수정하십시오. 상자를 수동으로 편집하지 마십시오. - 선택자는 스냅샷에서 가져옵니다.
{role, name}을 있는 그대로 복사하여 사용하는 것을 선호하십시오 (macOS:id, 그다음placeholder, 그다음role+name). 코드 편집기 내부의 숨겨진 입력은 괜찮습니다. 녹화기가 표시된 컨테이너를 클릭합니다. - 스크립트 깊은 화면은 실제 스냅샷에서 작성하십시오. 추측하지 마십시오:
- 해당 화면으로 이동하고 존재하지 않는
id를 클릭하여 끝나는 임시 스크립트를 작성하십시오. - 실행:
mac/.build/macdriver run --app X.app --out <임시> --script s.json -- --demo <임시>/data. 파일은{"actions":[...]}입니다. 웹:--from plan실행. <임시>/events.json에서failures[].aria를 읽으십시오.
- 해당 화면으로 이동하고 존재하지 않는
- 타이핑: 80자를 초과하는
fill값은 붙여넣기되고, 더 짧은 것은 눈에 보이게 입력됩니다. "test"가 아닌 현실적인 데이터를 사용하십시오. 새 필드를 클릭한 직후 키 입력이 누락되면 (잘린 제목, 빈 필드, 텍스트를 찾을 수 없는 이후 클릭) 분할하십시오: 필드를click하고,wait500 후 대상이 없는fill을 하십시오. - 성과: 정확히 하나의 동작에
emphasis: true가 있습니다. 이를 트리거하는 클릭 직후, 클릭 자체가 아닌 캡션이 있는 최종wait(~2000ms)에 넣으십시오. 카메라는 전체 결과를 보여주기 위해 뒤로 당겨지고, 강조 대기는 실시간으로 재생됩니다. 다른 긴 대기는 빨리 감기됩니다. - 런처 비트: 앱이 항상 존재하는 아이콘(데스크톱, 메뉴 막대)이나 글로벌 핫키 뒤에 있으면
plan.launcher를 설정하십시오 (captions, 선택적hint(예: 핫키), 선택적badge).- 그러면 비디오는 워크스루 전에 비트를 얻습니다: 아이콘이 흐릿한 창들 사이의 평온한 데스크톱에 앉아 있고, 커서가 그것을 클릭하면 실제 창이 그로부터 성장하여 워크스루가 시작되는 정확한 위치에 착지합니다.
- Remotion에서 합성되며 (녹화기는 앱 창만 캡처)
motifImage/motif를 아이콘으로 사용합니다. 코드가 동작을 확인할 때만 사용하십시오.
5. 녹화 + 렌더링
npx tsx src/cli.ts <리포지토리> --plan OUT/plan.json --from plan
로그를 확인하십시오: 동작당 ✓, 실패 시 오류와 함께 ✗. 실패 시 OUT/events.json → failures[]를 읽고 (각각 실패한 순간의 접근성 스냅샷 포함), 대상을 수정한 후 다시 실행하십시오. 실패한 동작은 건너뛰며 치명적이지 않습니다. 성과가 실패한 비디오를 제공하지 마십시오. 초기 동작이 실패하면 이후의 모든 것이 일반적으로 잘못된 화면에서 실행됩니다: 전체 녹화를 불량으로 취급하고 raw.mp4 프레임을 보고 실제로 무슨 일이 일어났는지 확인하십시오.
저렴하게 재실행:
- 복사, 룩,
launcher, 사운드 또는 장면 코드 변경:--from render, 재녹화 불필요. - 동작 캡션은 녹화 시간에
events.json에 포함됩니다.plan.json에서 (index로) 거기서 패치하고,npx tsx -e 'import {editRecording} from "./src/edit.ts"; editRecording("OUT")'로 타임라인을 재구축한 다음--from render를 실행하십시오. - 단계 변경:
--from plan(재녹화).
6. 보고 전 검토
렌더링된 MP4를 검토하십시오. 스틸 사진만 검토하지 마십시오. 콘택트 시트를 만들고 모든 프레임을 확인하십시오:
ffmpeg -v error -y -i OUT/demo.mp4 -vf "fps=1/2,scale=640:-1,tile=4x8" -frames:v 1 <임시>/sheet.jpg
확인:
- 스타일 일치:
probe.png를 스틸 사진 옆에 놓으십시오. 동일한 배경 계열, 글꼴, 강조색 및 마스코트? 비디오가 다른 브랜드처럼 보이면 다른 것보다 먼저look을 수정하십시오. - 모든
fill값이 입력된 그대로 화면에 나타납니다. ✓는 동작이 실행되었음을 의미할 뿐 텍스트가 도착했음을 의미하지 않습니다. - 카메라는 중요한 것(입력 중인 텍스트, 클릭 중인 컨트롤)에 푸시인되어 있으며, 넓게 또는 빈 캔버스에 있지 않습니다.
- 캡션은 읽을 수 있고 앱을 절대 가리지 않습니다. 텍스트가 맞습니다. 넘치는 것이 없습니다.
- 아하 프레임은 성과(로딩 상태나 잘린 버튼이 아님)를 보여줍니다.
- 비교 비트의 "X → Y"가 믿을 만합니다. 비율이 터무니없으면 기존 방식의
seconds가 부풀려진 것입니다. - 오디오가 존재하고 0dB 아래에서 피크:
ffmpeg -i OUT/demo.mp4 -af volumedetect -vn -f null -. 동기화를 확인하려면 타이핑 구간의showwavespic을 그리고 프레임과 비교하십시오.
7. 보고
사용자에게 다음을 제공하십시오:
OUT/demo.mp4의 경로와 길이- 후크, 기존 방식, 오직 우리 라인 (각각 한 줄)
- 룩을 어떻게 일치시켰는지 (어떤 색상, 글꼴 및 마스코트가 앱에서 왔는지)
- 작동시키지 못한 것, 또는 녹화되지 않고 합성된 것 (예: 런처 비트)
- 앱에서 발견한 버그 (예: 키 입력 누락)
도구가 라이브 조정을 위해 출력하는 npx remotion studio … 명령어와 --music <file> 사운드트랙 옵션을 언급하십시오.
음향 효과
기본 켜짐; --no-sfx는 끕니다. scripts/make-sfx.py는 모든 것을 합성하고 (샘플 없음, 라이선스 없음) assets/sfx/에 저장하며, remotion/Sfx.tsx는 녹화된 이벤트에서 각 사운드의 타이밍을 맞춥니다:
- 타이핑: 문자당 하나의 촉각 기계식 스위치 사운드 (범프 클릭, 바닥-아웃, 놓기), 녹화기의 실제 타이핑 속도로. 공백은 더 깊은 안정화된 소리, Enter는 더 무거운 소리를 가집니다.
- 클릭: 녹화된 커서가 클릭한 곳마다 마우스 클릭 (런처 클릭 포함).
- 전환: 각 장면 변경 시 휘파람.
- 기존 방식: 단계당 카드 착지 소리 (소프트에서 팝, 볼드에서 둔탁) 및 평결 소리 (소프트 팝, 볼드에서 도장).
- 성과: 차임.
- 비교: 행당 팝, 시간 결과에 차임 (소프트) 또는 도장 (볼드).
--music와 함께 음악은 효과 아래에서 낮춰집니다. Sfx.tsx에서 볼륨을 변경하고 --from render를 다시 실행하십시오. 편집 후 스크립트를 다시 실행하여 WAV를 재생성하십시오.
네이티브 Mac 앱
동일한 흐름, 다른 녹화기 (mac/macdriver.swift: Accessibility API로 컨트롤 찾기, 실제 마우스/키보드 이벤트, ScreenCaptureKit은 앱 창만 녹화). --app을 추가하고 -- 뒤에 시작 인수를 전달하십시오:
npx tsx src/cli.ts <리포지토리 또는 ./로컬/디렉토리> --app 경로/대상.app [--app-seed demo/items.json] --prepare -- --demo {data}
{data}는 실행마다 새로운 임시 폴더가 되고--app-seed가 그 안에 복사됩니다. 사용자의 실제 데이터에 대해 절대 녹화하지 마십시오. 앱에 데모/데이터 디렉토리 시작 플래그가 없으면 녹화 전에 추가하거나 (사용자에게 요청) 하십시오. 먼저 사용자의 커밋되지 않은 변경 사항이 있으면 앱을 다시 빌드하십시오.- 먼저
mac/.build/macdriver check --open을 실행하십시오. 터미널을 호스팅하는 앱에 대해 접근성 및 화면 및 시스템 오디오 녹화 권한이 필요합니다. 둘 중 하나라도 없으면 정확한 시스템 설정 창을 열고 활성화할 앱의 이름을 알려줍니다 (종료 코드 3). 사용자는 권한을 부여한 후 해당 앱을 다시 시작해야 하며, 이 세션이 종료되므로 재시도하지 말고 나중에 다시 오라고 알리십시오. 화면 녹화가 없으면--prepare는 여전히 작동하지만 녹화는 작동하지 않습니다. 그동안 스토리보드를 작성하여 준비하십시오. - 녹화는 사용자의 실제 마우스와 키보드를 제어합니다 (
2060초, 3초 카운트다운). 모든 실행 전에 사용자에게 알리십시오 (짧은 프로브 실행 포함). 사용자가 입력 중일 때 시작하지 마십시오. 사용자의 입력이 포커스를 빼앗고 테이크를 망칩니다. - 대상:
id, 그다음placeholder, 그다음role+name.goto없음. 대상이 없는fill은 포커스된 필드에 입력합니다. Enter/Tab/Meta+N에press를 사용하십시오. - 레이블이 없는 아이콘 버튼은 자동화에 보이지 않습니다. 주요 컨트롤에 이름이 없고 코드를 소유하고 있다면
.accessibilityLabel/.accessibilityIdentifier를 추가하십시오. - 키가 입력되는 동안 Accessibility 트리를 쿼리하지 마십시오. SwiftUI 앱에서 AX 쿼리는 텍스트 필드를 오래된 텍스트로 재설정하는 리렌더링을 트리거하여 키 입력을 떨어뜨릴 수 있습니다. 드라이버는 타이핑 후에만 포커스된 요소를 읽습니다. 드라이버를 변경하는 경우 그 상태를 유지하십시오. 키 입력이 여전히 사라지면 앱에 이 버그(
NSViewRepresentable텍스트 뷰의updateNSView가 오래된 바인딩으로 문자열을 덮어쓰는)가 있을 가능성이 높습니다. 사용자에게 알리십시오.
제한 사항
로그인 뒤의 웹 페이지는 공개 페이지 또는 사전 인증된 URL에서 흐름을 시작해야 합니다. 네이티브 녹화는 macOS 전용이며 단일 앱 창을 녹화합니다. 그 외부의 모든 것 (데스크톱, 메뉴 막대, 다른 앱)은 Remotion에서 합성되며 녹화되지 않으므로 보고서에 명시하십시오.