01시작 전 확인
Claude Code·Codex에 입력튜터 요청
현재 장을 시작하거나 다시 이어갈 때
먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.
17장 시작해.올리기 전에 AI가 영상을 검사합니다
검사 Skill이 정상 원본과 명백한 손상 사본을 구별함을 확인합니다.
이어갈 프로젝트 · ai-shorts-maker
16장의 최종 MP4와 제작 기록이 있습니다.
이번 장의 준비와 서비스
필요한 도구 · Python · FFmpeg · video-upload-review
이미 준비한 계정과 기능은 그대로 이어갑니다.
손상 사본을 자동 수정하거나 어느 영상도 자동 게시하지 않습니다.
순서대로 입력하는 커맨드
현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.
022. 검사 Skill을 만듭니다
Claude Code·Codex에 입력실습
업로드 전 검사 Skill 구현
먼저 확인 · 16장 완성 MP4와 이번 검사 기준 확인.
완성한 YouTube Shorts를 업로드 전에 반복 검사하는 Skill을 만들어줘.
이름은 정확히 `video-upload-review`로 해.
프로그램으로 다음 항목을 검사해.
- 파일 존재와 전체 재생 오류
- 40~90초 길이
- 1080×1920, 세로 9:16
- 영상과 소리의 존재, 실제 음성 신호
- 1.5초 이상 이어지는 뜻밖의 검은 화면
영상에서 5초마다 대표 화면을 뽑아 한 장에 모으고, 그 이미지를 보고 다음 항목을
각각 통과 또는 실패로 판단해.
- 한글 자막이 있고 읽을 수 있는가
- 중심 대상이 심하게 잘리지 않았는가
- 화면이 깨지거나 눈에 띄게 망가지지 않았는가
프로그램 검사와 화면 검사가 모두 통과할 때만 `UPLOAD READY`로 판정해.
하나라도 실패하거나 확인하지 못하면 `NOT READY`로 판정하고 근거를 보여줘.
영상을 자동으로 고치거나 업로드하지 마.
검사 기준은 프로젝트의 `prototypes/youtube-shorts/chapter-17/review-policy.json`에
저장하고, 대표 화면, 화면 판단과 최종 결과도 다음 검사에서 확인할 수 있게 기록해.
만든 Skill이 정상 영상은 통과시키고
명백한 불량 영상은 막는지도 검사해.
프로젝트의 `.claude/skills/video-upload-review/SKILL.md`에 저장하고,
파일 맨 위의 이름도 `video-upload-review`인지 확인해. 저장한 뒤 `/` 명령 목록에
나타나는지도 확인해줘.033. 정상 영상을 검사합니다
Claude Code·Codex에 입력실습
정상 원본 검사
먼저 확인 · 16장에서 완성한 실제 최종 MP4 경로를 확인. 출력 예시의 파일명을 실제 파일명으로 가정하지 않으며 손상 사본으로 대체하지 않음.
/video-upload-review <최종 MP4 경로>에 있는 16장의 최종 영상을 검사해줘.
검사 근거와 최종 판정을 보여주고, 영상을 고치거나 YouTube에 올리지는 마.043. 정상 영상을 검사합니다
Claude Code·Codex에 입력실습
정상 판정 후 전체 재생 대기
먼저 확인 · 현재 원본의 UPLOAD READY 결과 확인.
검사 결과가 UPLOAD READY인 것을 확인했어.
내가 전체 영상을 소리와 함께 재생해 자막과 내레이션, 장면 전환까지 확인할 동안
기다려. 아직 업로드하지 마.054. 불량 사본도 같은 Skill로 검사합니다
Claude Code·Codex에 입력실습
전체 재생 확인 뒤 손상 사본 생성
먼저 확인 · 독자가 원본을 끝까지 재생하고 이상 없음을 확인했는지 확인.
전체 영상을 처음부터 끝까지 확인했고 이상이 없었어.
이제 검사 Skill이 실패도 잡는지 확인할 사본을 만들어줘. 16장의 완성 원본은 바꾸지 마.
사본에는 다음 결함만 넣어.
- 첫 3초를 완전한 검은 화면으로 바꾸기
- 화면 중앙 절반만 남도록 잘라 크게 확대하기
- 모든 소리 지우기
손상된 사본은 원본과 다른 이름으로 저장하고, 아직 검사하지 마.
완성한 파일과 원본이 그대로 보존됐는지 보여줘.064. 불량 사본도 같은 Skill로 검사합니다
Claude Code·Codex에 입력실습
손상 사본 검사
먼저 확인 · 분리된 손상 사본과 원본에 사용한 기준 확인.
/video-upload-review 방금 만든 손상 사본을 정상 영상과 똑같은 기준으로 검사해줘.
첫 실패에서 멈추지 말고 프로그램 검사와 화면 검사를 끝까지 수행해 모든 실패 항목을
보여줘. 영상을 고치거나 업로드하지 마.074. 불량 사본도 같은 Skill로 검사합니다
Claude Code·Codex에 입력실습
손상 거부 뒤 정상 원본 재검사
먼저 확인 · 손상본 결과 확인. 앞선 원본 검사와 별도의 필수 재검사임.
/video-upload-review <최종 MP4 경로>에 있는 원본을 같은 기준으로 다시
검사해줘. 앞에서 검사한 손상 사본과 결과를 섞지 말고 새 결과를 보여줘.8. 이번 장에서 완성한 것 선택·문제 발생 시
Claude Code·Codex에 입력선택·문제 발생 시
이후 다른 Shorts 검사 요청 때만
먼저 확인 · 새로 검사할 실제 파일과 Skill 확인. 이번 장 자동 반복 단계 아님.
/video-upload-review 이 Shorts를 업로드 전에 검사해줘.09이 장을 마쳤는지 확인합니다
Claude Code·Codex에 입력튜터 요청
이번 장 완료 조건을 확인할 때
먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.
장 완료 확인해줘.이 장에서 막혔을 때
디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작명령어를 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.
1. 디버깅 — 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.
지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.이 장에서 특히 자주 막히는 자리는 정상 영상인데 검사에서 실패하는 경우입니다. 기준을 풀기 전에 어느 항목이 걸렸는지부터 봅니다.
정상 영상인데 검사에서 실패했어.
어느 항목이 어떤 값 때문에 실패했는지 항목별로 그대로 보여줘.
원인을 확인하기 전에 검사 기준을 느슨하게 바꾸거나 항목을 빼지는 마.2. 내 정상 기록으로 복구 — 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.
현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.3. 장별 Source로 재시작 — 그래도 이어갈 수 없을 때 사용합니다. PART 5 실습을 마친 것으로 보고 다음으로 넘어가게 되므로 마지막 수단입니다.
내 현재 작업을 먼저 안전하게 보존해줘.
아래 16장과 17장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch16/source/ai-shorts-maker
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch17/source/ai-shorts-maker
내가 직접 넣어야 하는 설정과 인증정보가 무엇인지 알려줘.방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.
손상 사본이 NOT READY
1단계 — 방향
현재 검사 대상이 원본인지 사본인지 봅니다.
2단계 — 범위
검은 화면·무음·잘림을 의도적으로 넣었는지 확인합니다.
3단계 — 위치·원인 후보
실패 항목이 실제 넣은 결함을 가리키는지 대조합니다.
정답을 요청했을 때
예상 결함을 정확히 검출하면 해당 목표는 성공입니다. 영상을 고치지 말고 원본을 같은 기준으로 다시 검사합니다.
검증 주의
이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.
검사는 PASS인데 사람이 보니 이상
1단계 — 방향
자동 검사 범위를 먼저 확인합니다.
2단계 — 범위
대표 화면과 전체 재생은 다른 확인입니다.
3단계 — 위치·원인 후보
자막 가독성·대상 잘림·연속 동작은 어디서 확인했는지 봅니다.
정답을 요청했을 때
자동·화면·사람 전체 재생 결과를 구분해 남깁니다. 하나라도 확인 못 했으면 업로드 준비 완료로 확대하지 않습니다.
검증 주의
이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.
이번 장의 완료 체크리스트
- 검사 기준길이·비율·음성·검은 화면·자막 기준 정의
- Skill 준비검사 전용 video-upload-review 확인
- 정상 검사정상 원본 UPLOAD READY와 근거 확인
- 사본 분리원본 보존 후 의도적 손상 사본 생성
- 불량 검출사본 NOT READY와 실패 근거 확인
- 원본 재검사같은 기준으로 원본 다시 UPLOAD READY
장 완료 확인해줘.실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.
장별 소스와 저자 검증 기록
저자는 정상 영상과 일부러 망가뜨린 사본을 같은 기준으로 검사해, 정상은 통과하고 손상본은 소리 없음과 앞부분 검은 화면까지 실패로 잡히는 것을 확인했습니다. 근거는 verification/chapter-17/에 있습니다.
장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.
자료 판본 1c784213이 장의 개발 용어
- Skill
- 반복할 일을 수행하는 안내와 자료의 묶음. 별도 보안 정책을 대신하지 않습니다.