비디오 교육: 먼저 스토리보드, 그 다음 실제 앱 화면
여기서 교육 비디오는 일련의 전화기 모양 카드 세트입니다. 각 카드에는 제목, 한 줄의 도움말, 실제 앱의 주요 프레임(콜아웃 포함), 그리고 한 줄의 나레이션이 있습니다. 일부 카드는 스틸 이미지 대신 앱의 짧은 클립을 재생합니다. 동일한 카드가 슬라이드와 PDF로도 제공됩니다.
모든 것을 제어하는 하나의 파일(storyboard.json)이 있습니다. Dave는 디자인 캔버스를 통해 이 파일을 편집합니다. 모든 빌드 스크립트는 이 파일을 읽습니다.
사용 시기
다음과 같은 경우에 사용하세요:
- 앱을 보여주는 교육, 시작, 빠른 시작 또는 방법 비디오
- 기술자, 어드바이저 또는 부서 직원을 위한 주석이 달린 스크린샷 또는 슬라이드 가이드
- 이 스킬로 만든 비디오의 수정(새로운 문구, 새 카드, 새 클립)
다음과 같은 경우에는 사용하지 마세요:
- 마케팅 또는 프로모션 비디오(분위기와 규칙이 다름, Dave에게 문의)
- 제품 내부에서 녹화된 고객 검사 비디오
- 아직 존재하지 않는 화면의 목업(
/visual사용)
원칙
- 프로덕션 전에 스토리보드 먼저. Dave가 스토리보드 캔버스를 편집하고 완료했다고 말할 때까지 아무것도 나레이션하거나 조립하지 않습니다.
- 실제 앱으로 실제 작업을 보여주세요. 실제 스캔, 실제 받아쓰기, 실제 생성된 스토리. 가짜 화면이나 입력된 결과를 사용하지 마십시오.
- Dave는 캔버스에서 규칙을 정하고 채팅에서 하지 않습니다. 캔버스를 다시 읽고 차이점을 비교하세요. 대화에서 그의 방향을 재구성하지 마십시오.
- 승인된 테이크는 유지됩니다. 단어가 변경된 라인에 대해서만 나레이션이 다시 생성됩니다. Dave가 검토한 버전을 덮어쓰지 말고
-v2,-v3를 제공하세요. - Claude는 듣거나 볼 수 없습니다. 모든 인계 시 이 점을 언급하세요. 전사(transcription)를 통해 단어를 증명하고 샘플 프레임을 통해 그림을 증명하며, 확인되지 않은 사항을 명시하세요.
- 스토어를 발견한 그대로 두세요. 모드가 복원되고 확인되었으며, 재촬영 수리 주문이 종료되었습니다.
먼저 읽기
/Users/davidsonders/ro-bot/shared/product-facts.md및shared/brand.md: 이름, 개수, 금지어. 대시(em dash)나 이모지 사용 금지, "TenthGear"는 한 단어로 표기. 시청자가 보거나 듣는 모든 것에서 "싱글 플레이어" 또는 "멀티 플레이어"라고 말하지 마십시오.- 이 폴더의
reference.md: 기술적 함정(각각 한 번씩 이미 비용을 지불한 것들). - 디자인 캔버스에 대한 메모리 노트:
reference_design_canvas_mechanics,reference_design_canvas_roundtrip,reference_design_canvas_entity_crash.
파일 위치
| 항목 | 위치 |
|---|---|
| 비디오 프로젝트 폴더 | /Users/davidsonders/ro-bot/training-videos/<slug>/ (세션과 함께 사라지는 세션 스크래치패드는 사용 금지) |
| 유일한 진실 공급원 | <project>/storyboard.json |
| 키 프레임, 클립, 나레이션 | <project>/frames/, footage/, narration/ |
| 빌드 결과물 | <project>/out/ |
| Dave가 받는 위치 | ~/Desktop/<Title>/ |
| 작업 예시 | training-videos/story-writer-getting-started/ 및 여기의 examples/story-writer/ |
스크립트는 여기의 scripts/에 있습니다. 첫 번째 인자로 프로젝트 폴더를 받습니다.
워크플로우
이 단계에 대한 할 일 목록을 만들고 순서대로 진행하세요.
0단계: 브리핑 확정
요청에서 다음 사항을 찾으세요. 누락된 항목에 대해서만 질문하고, 권장 사항을 먼저 제시하세요.
| 결정 사항 | 기본값 |
|---|---|
| 시청자와 역할 | 기술자 |
| 전화기 또는 데스크톱 | 전화기, 390 x 844 |
| 어떤 플로우, 처음부터 끝까지 | Dave의 개요 |
| 스토어 및 워크플로우 모드 | Dave에게 문의. 2단계 참조. |
| 스틸 이미지만 또는 스틸 이미지와 클립 | 화면이 움직이는 곳마다 클립: 녹화, 로딩, 열기 및 닫기 |
| 길이 | 2분 30초 미만 |
1단계: 디자인 캔버스에 스토리보드 작성
이것이 Dave가 가장 먼저 보게 되는 것이며, 그가 스크립트와 콜아웃을 편집하는 곳입니다.
-
프로젝트 폴더를 생성하고 필요한 소품을 렌더링합니다(
props/render-paper.mjs가 샘플 종이 수리 주문서를 만듭니다). -
키 프레임을 위해 플로우를 스카우트합니다. 키 프레임은 실제 앱에서 가져오므로 이 단계에는 캡처 실행(2단계 및 3단계, 스틸 이미지만)이 필요합니다.
examples/story-writer/capture-stills.mjs를 프로젝트에 복사하고 플로우를 다시 작성하세요. 진행하기 전에 모든 프레임을 살펴보세요. -
storyboard.json을 초안으로 작성합니다. 시청자가 수행하는 작업당 하나의 카드입니다. 형식:{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "[[스토리 작성]] 탭", "body": "AI 작성기가 귀하의 메모를 검토하고 3C를 자동으로 생성합니다.", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "클립이 보여주는 내용" }, "narration": "준비가 되면 스토리 작성을 탭하세요." }boxes와arrow는 전화기 픽셀 단위입니다. 캡처는 각 컨트롤의 박스를 프레임 옆에 기록합니다.[[레이블]]은 버튼 칩을 그립니다. 첫 번째 초안부터 아래 스타일 규칙을 따르세요. -
캔버스를 생성합니다. 아티팩트 도구:
intent가design인quickstart를 사용한 다음, 반환된type_url과 제목으로 게시합니다. url을<project>/storyboard/artifact.json에 저장합니다. -
키 프레임을 캔버스에 업로드합니다 (JPEG, 1688px 높이, 한 번의 호출로 업로드되도록 스크래치패드에 준비). 반환된 각
/_blob/...url을 프레임 이름을 키로 하여artifact.json의assets아래에 기록합니다. -
생성 및 게시합니다.
node scripts/storyboard-canvas.mjs <project>가storyboard/project/를 작성합니다. 해당 폴더를 스크래치패드에 복사하고 게시합니다:canvas.json은file_path로, 모든.dc.html은files로. -
Dave에게 링크를 전달하고 중단합니다. 그에게 알리세요: 카드의 단어를 다시 입력하고, 각 카드 아래의 파란색 메모는 음성 트랙이며, 노란색 콜아웃을 드래그하고, 메모에 다른 내용을 작성하세요. 프로덕션을 시작하지 마십시오.
-
그의 편집 내용을 수집합니다.
paths(인덱스 및 모든 아트보드)와out_dir로 아티팩트read를 실행한 다음,node scripts/storyboard-harvest.mjs <project> <out_dir>을 실행합니다. 보고서를 평문으로 그에게 읽어주고, 그가 추가한 메모에 대해 조치를 취한 다음--write로 다시 실행합니다. -
또 다른 라운드가 필요합니까?
project/canvas.json을 다시 읽고,--live <that file>로 다시 생성한 다음 다시 게시합니다. 라이브 인덱스에서 시작하지 않는 게시는 거부됩니다.
2단계: 스토어 빌리기
앱은 비디오가 보여주는 모드에 있어야 합니다. 테스트 스토어만 사용할 수 있습니다.
| 스토어 | ID | 일반 모드 | 참고 |
|---|---|---|---|
| Summit Auto Group (데모) | demo-dealership | 팀 워크플로우 | Dave의 잠재 고객 데모. 로그인 [email protected] (기술자), marcus@ (어드바이저), priya@ (부서). 첫 번째 비디오에 사용됨. |
| 테스트 딜러십 1 | mlTaPo12wbpUtJB9GXJM | 팀 워크플로우 | 빌드 세션과 공유됨. 자주 사용 중. |
ListAgents를 실행한 다음 각 피어에게SendMessage로 메시지를 보내세요: 스토어를 사용 중인지, 모드가 필요한지 확인합니다. 답변을 기다리세요. 피어가 필요로 하는 경우 다른 스토어를 사용하거나 Dave에게 문의하세요.- 먼저 모드를 읽습니다: 앱 폴더에서
NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>실행. - 캡처가 실행되는 몇 분 동안만 변경하고, 캡처 명령 체인과 복원 명령 체인에서 함께 실행합니다. 그런 다음 모드를 다시 읽고 확인합니다.
- 고객 스토어는 절대 건드리지 마세요. 테스트 계정의 환경설정을 변경하지 마세요.
3단계: 캡처
- 스틸 이미지:
dpr: 3. 카드당 한 프레임, 화면이 안정된 후에 촬영합니다. - 클립:
dpr: 2와vt.recorder사용. 각 클립은 정적인 상태의 비트로 시작하고, 손가락 마커를 표시한 다음, 작업을 수행합니다.marks.json을 읽어footage.runs를 선택하세요. - 받아쓰기는 실제여야 합니다.
vt.dictation은 음성 클립을 가짜 마이크로 재생합니다. 앱이 이를 기록하고 전사합니다. 모든 전사본을 출력하고 읽으세요: 전사기는 숫자와 브랜드 이름을 다시 씁니다. - 재촬영에는 새로운 수리 주문이 필요합니다. 위쪽으로 번호를 매기고 각 id를
created-ros.txt에 나열하세요.
4단계: 슬라이드
node scripts/build-slides.mjs <project>는 out/slides/*.png, PDF, 그리고 비디오에 필요한 레이어를 생성합니다. 모든 카드의 연락처 시트(contact sheet)를 확인하세요. 콜아웃이 가리키는 대상을 덮고 있지 않은지 확인하세요.
5단계: 나레이션
cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>
음성 ash, 모델 gpt-audio-1.5 (gpt-4o-mini-tts에서 이동, OpenAI가 2027-01-06에 종료 예정). 전사가 카드의 단어와 일치하지 않는 테이크는 재시도된 후 거부됩니다. Dave는 이 음성을 승인했으며 Mac의 내장 음성을 로봇 같다고 거부했습니다. 앱의 OpenAI 키를 사용하며 빌드당 몇 센트의 비용이 듭니다: 새 비디오에 대한 브리핑에 이 내용을 포함하여 비용이 예상치 못한 일이 발생하지 않도록 하세요. DRY=1은 재생성될 항목을 나열합니다.
귀를 위한 나레이션을 작성하세요: "R O", "three Cs", "tenthgear dot A I". 각 부분이 포함된 첫 번째 카드에서 해당 부분을 알리세요.
6단계: 비디오
node scripts/build-video.mjs <project>. 속도는 1.25(QuickTime의 "빠르게")이며, Dave가 승인한 속도입니다. 클립이 있는 카드는 나레이션과 클립 중 더 긴 시간 동안 재생됩니다.
7단계: 확인 및 미확인 사항 명시
check-audio.mjs는 비디오를 전사하고 각 카드의 점수를 매깁니다. 모든LOOK라인을 읽으세요.- 클립이나 화살표가 있는 각 카드에서 한 프레임을 가져와서 확인하세요.
- 인계 시에 명확히 밝히세요: 끝까지 듣지 않았고, 끝까지 보지 않았습니다.
8단계: 전달
비디오, PDF 및 out/slides/를 ~/Desktop/<Title>/에 복사하세요. 이전 버전은 유지하세요. 길이, 변경된 사항, Dave가 알아차릴 수 있는 모든 것(클립의 다른 수리 주문 번호, 영상 위에 떨어진 콜아웃 등)을 알려주세요.
9단계: 정리
- 스토어 모드가 복원된 후 다시 읽고 확인합니다.
node scripts/close-ros.mjs <project> <email> <org-id>는 재촬영을 종료합니다. 수리 주문 삭제는 Dave의 결정에 따릅니다.- 메시지를 보낸 모든 피어에게 스토어가 사용 가능하다고 알리세요.
스타일 규칙 (Dave, 2026-09-29)
| 규칙 | 예시 |
|---|---|
| 시청자가 탭하는 버튼은 버튼처럼 그려짐 | [[새 RO]] 탭 |
| 파트 헤더는 "3부 중" 없이 짧게 | 파트 2: 보증 스토리 |
| 커버에는 단계 수가 없음 | |
| 단계당 하나의 카드. 하나의 결정을 보여주는 카드는 병합 | 검토 및 저장은 하나의 카드 |
| 자명한 포인트의 카드는 삭제 | 원인 및 수정 사항 읽기 |
| 누가 어떤 동작을 하는지 명시 | "메모 추가"가 아닌 "음성 메모 추가" |
| 화면에서 두 가지가 의미될 수 있는 경우, 하나를 가리킴 | 녹색 버튼에 화살표 |
| 앱에서 움직이는 모든 것은 비디오에서도 움직여야 함 | 파형, 스피너, 카드 열림 |
| 현장 용어 | RO, 라인, 스토리, 3Cs, CP |
Dave는 PDF 페이지 번호로 슬라이드 편집 내용을 제공합니다. 1페이지는 커버이므로 "pg 7"은 6단계입니다. 적용하기 전에 각 편집 내용을 단계 이름으로 다시 설명하세요.
성공 기준
- Dave가 스토리보드 캔버스를 편집했으며 그의 편집 내용이 추측이 아닌 수집된 것임
- 모든 프레임과 클립이 비디오가 다루는 모드의 실제 앱임
- 슬라이드, PDF 및 비디오가 모두 동일한
storyboard.json에서 생성됨 - 나레이션이 전사를 통해 확인되었으며, 불명확한 라인이 명명됨
- 인계 시 듣거나 보지 않은 부분이 명시됨
- 스토어 모드가 복원 및 확인되었으며, 재촬영 수리 주문이 종료됨
- 프로젝트 폴더가 스크래치패드 외부에 유지됨
관련 스킬
/visual: 아직 존재하지 않는 화면의 목업용/app-testing: 빌려오는 테스트 계정 및 라이브 패스 harness용/compound: 캡처 과정에서 제품 버그 또는 새로운 함정이 발견된 경우 그 이후에 사용