터미널 튜토리얼 비디오
경로:
${CLAUDE_PLUGIN_ROOT}는 이 플러그인의 루트입니다. 변수가 정의되지 않은 경우 루트는 이 스킬의 "Base directory"에서 두 폴더 위에 있습니다(<루트>/skills/<skill>). 스킬이~/.claude/skills로 복사되었다면,${CLAUDE_PLUGIN_ROOT}/skills대신~/.claude/skills를 사용하세요.
모델은 "Git과 GitHub 모범 사례" 비디오입니다: 14개 장면, 약 3분 37초. 전체 프로젝트는
${CLAUDE_PLUGIN_ROOT}/skills/video-dev/exemplos/git/에 있습니다(roteiro.json, cenas.py, pronuncia.json). 예제의
cenas.py를 먼저 연 다음 작성하세요.
video-dev 스킬을 아직 따르지 않았다면(질문, 준비, 폴더), 먼저 시작하세요.
작성 전: 명령어가 작동해야 합니다
시청자는 화면에 나타나는 내용을 직접 입력합니다. 튜토리얼의 명령어를 나열하고, 가능하면 실제로 실행하여 테스트 폴더에서 구문을 확인하고 실제 출력(또는 짧은 버전)을 복사하세요. 절대 가상의 플래그를 만들지 마세요. 계정, 네트워크 또는 파괴적 작업(push, deploy, rm)이 필요한 명령어는 실행하지 말고 공식 문서에서 확인하세요.
구조
| # | 블록 | 내용 |
|---|---|---|
| 1 | 도입 | 주제 + 따라 하는 방법: "1 · 비디오 일시정지 → 2 · 터미널에 입력 → 3 · 계속" |
| 2…n-1 | 단계 | passo(n, 제목, 색상) + 1~4개 명령어가 있는 Term + 팁 또는 경고 상자 하나 |
| 단계 사이 | 팁 | 번호 없는 장면, selo(0.1, "팁", 핑크) 사용, 모범 사례용(예: Conventional Commits) |
| n | 체크리스트 | 모든 단계가 포함된 번호 목록 + "저장하고 다음 프로젝트에서 사용" |
순서: 한 번만 하는 것(설정) → 항상 하는 것(일일 워크플로) → 고급(rebase, tags). 장면당 하나의 단계; 단계에 명령어가 4개를 초과하면 두 개의 장면으로 나눕니다.
대본
- 각 대사를 "단계 N:"으로 시작하고 명령어 전에 무엇을, 왜 하는지 말합니다.
- 명령어는 읽는 대로 말합니다: "git push, 대시 u, origin main"; "git switch 대시 c"; "feat 슬래시 login"; "dot gitignore". 화면에는 실제 명령어가 표시됩니다.
- 중요한 경고는 별도 문장으로 처리합니다: "비밀번호와 API 키는 절대 저장소에 넣지 마세요."
- 영어 용어: 발음 맵이 있는지 확인하세요(narracao-voz 참고). 주제에 특화된 용어가 있다면(docker compose, kubectl...),
프로젝트에
pronuncia.json을 생성하세요.
터미널 (Term)
Term(1.0, 700, [ # t: 시작 시간, y: 중앙 y좌표
(2.4, "$", 'git config --global user.name "이름"'), # (시간, 유형, 텍스트)
(5.4, "$", 'git config --global user.email "[email protected]"'),
(6.2, "o", "파란색 명령어 출력"),
(7.0, "#", "# 회색 주석"),
])
- 각 줄의 시간 = 대사가 명령어를 말하기 시작하는 시점입니다 (
--tempos N). - 초당 24자를 입력합니다 (
CPS엔진 설정). 40자 명령어는 약 1.7초가 걸립니다. 다음 줄은 이후에 시작해야 합니다. - 한 줄당 약 44자까지(size=32). 그 이상은
\로 줄바꿈하고">"줄에서 계속합니다. - 출력(
"o")은 짧고 현실적으로 만듭니다. 줄이세요: "Initialized empty Git repository". - 예제 데이터는 중립적으로 사용합니다: "이름", "[email protected]", "my-project", "you/my-project.git". 절대 사용자의 실제 데이터를 사용하지 마세요.
효과적인 보조 요소
| 아이디어 | 방법 |
|---|---|
| 경고("절대 하지 마세요") | 터미널 위나 아래에 Box(t, 540, y, "텍스트", RED, filled=True) |
| 알림 | Box(t, 540, ~1030, "GitHub 계정과 동일한 이메일", ORANGE) |
| 사이트에서 클릭할 위치 | PURPLE Box에 경로: "github.com: New repository\n(비어 있음, README 없음)" |
| 상태 흐름 | 3개의 Box 나란히(x 190/540/890, w=290) + 화살표가 있는 Line + 아래 mono Text (git add, git commit) |
| main에서 분기 | GREEN 수평 Line(main) + 3개의 PURPLE Line으로 분기선 + 레이블 |
| 좋음 vs 나쁨 | 좋은 예시가 있는 녹색 상자 + 나쁜 예시가 있는 RED mono Text("수정", "최종2") |
| 시맨틱 버전 | 큰 Text "v1.4.2" + major/minor/patch 설명이 있는 3개의 회색 상자 |
| 최종 체크리스트 | lista_vertical(...) 또는 w=860, 항목별 다른 색상의 Box |
속도
- 셀 + 제목: 0.1~0.2초. 터미널은 약 1초 후, 첫 번째 명령어 전에 나타납니다.
- 팁 또는 경고 상자는 그 부분을 설명할 때 나타나며, 보통 명령어 후에 나타납니다.
- 장면: 12~18초. 튜토리얼은 개념 비디오보다 약간 긴 장면을 허용합니다. 사용자가 입력하고 있기 때문입니다.
최종 렌더 전 체크리스트
- 화면의 모든 명령어를 테스트했거나 문서에서 확인했습니다.
- 터미널 줄이 경계를 넘지 않습니다(
--preview로 확인). - 대사의 단계 번호가 화면의 "단계 N" 셀과 일치합니다.
- 최종 체크리스트에는 모든 단계가 동일한 순서로 있습니다.
- 명령어에 실제 개인 데이터(이메일, 사용자명, 토큰)가 없습니다.