Communitygithub.com

remotion-chinese-psychology-video

중국어 심리학 및 사고 설명용 숏비디오 Remotion 프로젝트를 큐 기반 대본으로부터 구축합니다. 독창적인 첫 장면 연출, 결정론적 큐 타이밍, 동기화된 음향 효과, 엄격한 가독성, 대본 수정, 검증 및 ZIP 제공을 포함합니다. 중국어 심리학 또는 아이디어 영상에 사용하며, 관련 없는 동영상 편집이나 단순 Remotion 스니펫에는 사용하지 마십시오.

remotion-chinese-psychology-video란 무엇인가요?

이 스킬은 사용자가 제공한 중국어 심리학 또는 사고 설명용 대본을 바탕으로 완전히 실행 가능한 Remotion v4 프로젝트를 생성하고 ZIP으로 배포합니다. Claude Code 환경에서 사용되며, 먼저 큐 타임라인(`cue-timing.md`)과 창의적 방향(`creative-direction.md`) 참조 문서를 읽고, 각 비디오의 시각적 주축과 첫 장면 연출을 결정한 후 코딩을 시작합니다. 첫 장면은 한 번의 연속적인 카메라 움직임으로 제작되며, 훅, 전개, 주제 제시로 구성되어 10~20초를 목표로 합니다. 각 큐는 고유한 `cueId`를 가지며, `max(minDuration, baseHold + visibleCharacterCount / charsPerSecond + pause)` 공식으로 지속 시간을 계산하고 30fps로 정수 프레임으로 변환합니다. 중문 가독성을 위해 본문은 44px 이상, 자막은 66~68px 이상, 시안 안전 여백을 유지하며, 반투명 '유령 글자'는 사용하지 않습니다. 음향 효과는 `tools/make_audio.py` 파이썬 스크립트로 NumPy를 사용해 PCM WAV를 생성하며, `public/soundtrack.wav`로 내보냅니다. 대본 수정 시 변경되지 않은 큐의 시각적 요소를 유지하고 시간 축만 재계산하며, `scripts/audit_project.py`로 정적 검증을 수행합니다. 이 스킬은 Cursor, Codex 등 다른 AI 에이전트 플랫폼에서도 활용 가능하며, 완성된 프로젝트는 README와 함께 ZIP으로 압축되어 제공됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Lsous456/remotion-chinese-psychology-video-skill/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Remotion 중국어 심리 숏비디오

Claude Code 사용법

이 스킬은 주로 Claude Code를 위해 설계되었습니다. 다음 위치 중 한 곳에 설치한 후 사용하세요:

  • 개인 스킬: ~/.claude/skills/remotion-chinese-psychology-video/

  • 프로젝트 스킬: .claude/skills/remotion-chinese-psychology-video/

  • 직접 /remotion-chinese-psychology-video를 입력하여 호출할 수 있습니다.

  • 자연어로 중국어 심리 또는 사고 설명형 숏비디오 요청을 하면, Claude가 description을 보고 자동으로 로드합니다.

  • 작업이 필요할 때만 해당 references/ 파일을 읽고, 한 번에 모든 설명을 로드하지 마세요.

  • Claude Code의 현재 도구 권한과 세션 디렉터리를 따릅니다. 이 스킬은 스스로 권한을 확장하지 않습니다.

전달 목표

사용자가 제공한 중국어 대본을 실행 가능하고 수정 가능하며 내보낼 수 있는 Remotion v4 프로젝트로 만들어 ZIP으로 전달합니다.

사용자가 명시적으로 덮어쓰지 않는 한, 프로젝트는 다음 조건을 충족해야 합니다:

  • Node.js 18+, Remotion v4, TypeScript.
  • 1920×1080, 30fps.
  • 중문 폰트는 'NotoSerifSC' (Source Han Serif)를 사용합니다.
  • npm install && npm run dev로 미리보기, npm run build로 내보내기가 가능해야 합니다.
  • 프로젝트 내에 tools/make_audio.py를 제공하며, Python + NumPy를 사용해 대본 타임라인에 따라 주요 음향 효과를 합성하여 public/soundtrack.wav를 출력합니다.
  • 프로젝트에는 README가 포함되어야 하며, 프로젝트 구조, 대본 수정 방법, 음향 효과 재생성 방법을 설명합니다.
  • 배경음악이나 녹음된 음성은 포함하지 않으며, 키 프레임 이벤트와 정확히 동기화된 음향 효과만 포함합니다.
  • ZIP 파일에는 node_modules, 미리보기 캐시 또는 관련 없는 임시 파일이 포함되지 않습니다.

사용자가 이미 확정한 대본, 저자 이름, 시각적 방향 및 기타 명시적 선택 사항은 고정된 내용으로 간주합니다. 사용자가 명시적으로 요청할 때만 수정합니다. 수정되지 않은 큐의 기존 시각적 디자인, 소품, 색상 팔레트 및 로컬 애니메이션을 유지합니다.

먼저 요구사항 확정

제작을 시작하기 전에 다음 사항을 독립적으로 확인하세요:

  1. 대본에 훅, 질문, 주제명 및 설명 단락이 포함되어 있는지 확인합니다.
  2. 저자, 고정 길이, 문장별 dur / pause, 색상 또는 특정 장면이 제공되었는지 확인합니다.
  3. 사용자가 직접 내보내기를 요청하고 프레임별 검증을 원하지 않는지 확인합니다. 그렇다면 필요한 타입 검사와 프로젝트 무결성 검사는 완료해야 합니다.
  4. 대본 수정으로 인해 변경되지 않은 큐의 절대 시작점이 변경되는지 확인합니다. 변경될 경우, 해당 큐의 시각적 요소와 로컬 애니메이션은 유지하되 전역 타임라인과 음향 효과는 다시 계산합니다.
  5. 동시에 충족할 수 없는 제약 조건이 있는지 확인합니다. 충돌이 발견되면 먼저 지적하고 가장 합리적인 실행 가능한 해석을 채택하며, 이미 확정된 내용을 은밀히 위반하지 마세요.

기본적으로 배경 음악, 녹음된 음성, 워터마크, 브랜드, 저자(대본 또는 사용자가 제공하지 않는 한) 또는 요청되지 않은 스토리 요소를 추가하지 않습니다.

큐 타임라인 구축

먼저 references/cue-timing.md를 읽고 단일 타임라인 데이터 소스를 구축합니다.

  • 각각 독립적인 장면이 될 수 있는 문장은 안정적인 cueId를 가집니다.

  • 먼저 장면 경계를 결정한 후 지속 시간을 계산합니다. React 컴포넌트가 각자 추정하는 시작점을 사용하지 마세요.

  • 일반 큐의 초 수는 사용자 매개변수에 따라 계산됩니다:

    seconds = max(minDuration, baseHold + visibleCharacterCount / charsPerSecond + pause)

  • pause는 선택적 추가 지연 시간입니다. dur는 고정 초 오버라이드 항목으로, 존재할 경우 공식과 pause를 무시합니다.

  • 30fps에서 지속 시간을 정수 프레임으로 변환하고, 다음 큐의 시작점을 이전 큐의 종료 프레임과 같게 설정합니다.

  • 총 지속 시간은 모든 큐의 프레임 수를 더한 값입니다. 엔딩에 추가 유지 시간이 필요한 경우 별도로 tailFrames를 설정합니다.

  • 매개변수, 큐, 장면 및 음향 효과 이벤트를 감사 가능한 소수의 설정 파일에 배치합니다. README는 사용자에게 수정 위치를 알려야 합니다.

중문 가시 문자 수, 구두점 포함 여부, 기본 유지 시간, 초당 문자 수 및 최소 지속 시간은 프로젝트 내에서 명확하게 구성되어야 하며, 장면 컴포넌트에 분산되어 있으면 안 됩니다. 사용자가 매개변수를 제공하지 않은 경우, 합리적인 기본값을 적용하고 전달 설명에 명시합니다.

먼저 연출, 그 다음 코딩

현재 비디오의 시각적 주축과 장면 목록을 만듭니다. 먼저 references/creative-direction.md를 읽고 다음 결정을 내린 후 컴포넌트를 작성하세요:

  • 전체 비디오의 일관된 스틱 피겨 스타일, 선 두께, 비율, 관절 및 식별 색상.
  • 주제와 관련된 텍스처, 조명, 공간 및 색상 시스템.
  • 각 큐의 독립적인 소품, 동작 및 시각적 은유.
  • 첫 장면의 연속적인 카메라 경로, 주제 강조 동작 및 제목 공개 메커니즘.
  • 어떤 자막 키워드가 강조되어야 하는지, 어떤 숫자나 UI 요소가 독립적으로 배치되어야 하는지.

각 비디오의 오프닝은 다시 디자인되어야 합니다. 이전 장면 경로, 구성 또는 제목 애니메이션을 재사용하지 마세요. 각 장면은 고유한 소품과 이벤트를 가져야 하며, 스틱 피겨가 자막 옆에 서 있는 것으로 퇴화되어서는 안 됩니다.

첫 장면 하드 요구사항

첫 장면은 훅, 전개, 주제 제시로 구성되며, 목표는 약 10~20초입니다.

  • 가능하면 한 번의 연속적인 카메라 움직임을 사용합니다. 연속적인 2D, 2.5D 또는 3D 카메라 움직임을 사용합니다.
  • 평면적이고 횡적인 PPT 슬라이드 방식은 사용하지 마세요.
  • 훅은 먼저 문제, 손실, 모순 또는 시각적 이상함을 만든 후, 주제에 이름을 붙입니다.
  • 타이틀의 등장은 독특하게 디자인되어야 하며, 주제의 의미를 '연기'해야 합니다. 단순한 푸시/풀, 문자별 등장 또는 확대/축소가 아닙니다.
  • 저자가 있을 경우, 타이틀 아래에 한 줄의 명확한 작은 글씨로 서명합니다. 작은 글씨는 화면의 가독성 최소 기준을 넘어야 합니다.
  • 훅 자체가 대본 큐인 경우, 연기와 첫 문장 자막이 동기화되어야 하며, 연기를 먼저 하고 자막을 나중에 추가하는 방식은 안 됩니다.

Remotion 프로젝트 구현

중앙 집중식 구성을 사용하여 Composition을 구동합니다:

  • calculateMetadata 또는 동등한 위치에서 큐 데이터를 기반으로 composition의 durationInFrames를 계산합니다.
  • 통합된 Sequence 또는 절대 프레임 매핑을 사용하여 여러 독립적인 타이머의 드리프트를 방지합니다.
  • delayRender / continueRender 또는 안정적인 폰트 로딩 프로세스에서 NotoSerifSC를 기다립니다. 첫 프레임에서 폴백 폰트가 보이는 것을 방지합니다.
  • 각 큐에 명확한 컴포넌트 매핑을 만듭니다. 컴포넌트는 자신의 큐와 로컬 매개변수만 받습니다.
  • 로컬 애니메이션은 큐 내 상대 프레임을 사용합니다. 전역 음향 효과 이벤트는 큐 ID + 큐 내 초로 기록한 후 절대 프레임으로 매핑합니다.
  • 카메라 움직임에는 안정적인 앵커 포인트와 가역 변환을 사용합니다. 인터페이스가 명확해야 하는 경우, 카메라 움직임은 읽을 수 있는 자세에서 멈춥니다.
  • 유지 관리 가능한 컴포넌트 이름 지정과 구성 경계를 유지합니다. 모든 장면을 하나의 큰 파일에 집어넣지 마세요.

가독성 하드 임계값

  • 본문은 44px 미만이어서는 안 됩니다. 중요 단어는 일반적으로 60–200px입니다.
  • 자막은 약 66–68px이며, 진한 그라데이션 배경 또는 크림색 종이와 같은 단단한 배경을 사용하여 대비를 높입니다.
  • 밝은 글자에는 진한 테두리를 사용하고, 어두운 글자는 충분히 밝은 배경 위에 배치합니다.
  • 반투명 '유령 글자'는 가독 가능한 정보로 사용하지 않습니다.
  • 화면 네 면에 안전 여백을 유지하고, 하단 약 200px은 자막을 위해 비워둡니다. 중요 소품, 숫자, 버튼 및 제목은 자막, 마스크, 아이리시, 파티클 또는 카메라 컷에 의해 가려지지 않아야 합니다.
  • 휴대폰 전체 화면, 편집기, 중요한 인터페이스 또는 중요 숫자를 확대할 때는 정보가 완전히 보이도록 해야 합니다.
  • 확대 후 주 인터페이스 텍스트가 여전히 작은 경우, 중요 숫자나 결론을 별도의 큰 글자로 양쪽에 배치하되, 주 인터페이스의 일부인 것처럼 위장하지 마세요.
  • 대표 프레임에서 텍스트 경계, 테두리, 대비, 가림 및 최소 글꼴 크기를 확인합니다. 코드만으로 '분명히 선명할 것이다'라고 판단하지 마세요.

사운드

먼저 references/audio-synthesis.md를 읽고 tools/make_audio.py를 작성하세요.

  • 이벤트 테이블을 만들어 클릭, 스와이프, 심장 박동, 깨짐, 버블, 가위, 발소리 등을 큐 ID와 큐 내 시간에 바인딩합니다.
  • 음향 효과는 장면 이벤트와 동일한 이벤트 소스 또는 동일한 시간 매핑을 공유해야 합니다. 두 개의 근사 시간 집합을 유지하지 마세요.
  • 주제 강조 지점에서는 매우 짧은 리듬형 음향 효과를 사용할 수 있지만, 지속적인 배경 음악을 형성해서는 안 됩니다.
  • NumPy와 Python 표준 라이브러리를 사용하여 결정론적 PCM WAV를 생성합니다. 기본값은 48kHz, 16-bit, 모노 또는 스테레오입니다.
  • 스크립트를 다시 실행하면 public/soundtrack.wav를 덮어써야 하며, 결과는 이벤트 테이블과 일치해야 합니다.
  • README에 의존성, 명령어, 이벤트 테이블 및 출력 경로를 명시합니다.

대본 수정

사용자가 새 대본을 제공하면 다음 규칙에 따라 병합합니다:

  1. 기존 대본 전체가 새 대본으로 대체됩니다.
  2. 안정적인 cue ID와 정규화된 텍스트를 사용하여 어떤 큐 텍스트가 변경되지 않았는지 판단합니다.
  3. 변경되지 않은 큐는 기존 장면 컴포넌트, 시각적 디자인, 소품, 색상 및 로컬 애니메이션을 유지합니다.
  4. 새로 추가되거나 수정된 큐는 해당 장면과 자막을 새로 디자인합니다. 구조 변경이 주제 축을 파괴하는 경우, 영향을 받는 연속된 구간을 다시 연출할 수 있습니다.
  5. 각 큐의 지속 시간, 전역 시작점 및 composition의 총 프레임 수를 다시 계산합니다.
  6. 이전 지속 시간 변경으로 인해 변경되지 않은 큐의 절대 시작점이 변경될 수 있습니다. 이는 시각적 내용 변경과 동일하지 않습니다. 모든 후속 Sequence, 음향 효과 이벤트 및 카메라 키프레임을 동기적으로 이동해야 합니다.
  7. WAV를 다시 생성하고 모든 음향 효과가 여전히 로컬 이벤트 포인트와 정렬되는지 확인합니다.
  8. 한 번의 대본 수정으로 저자, 폰트, 해상도, 시각적 시스템 또는 영향을 받지 않은 장면을 변경하지 않습니다.

사용자가 '다른 장면을 전혀 수정하지 않음'을 요청하면서 대본 길이가 변경되는 경우, 절대 시간 위치를 동시에 유지할 수 없음을 설명합니다. 시각적 내용을 유지하는 것을 우선시하고 타임라인을 다시 계산합니다.

검증 및 패키징

프로젝트 완료 후 scripts/audit_project.py를 실행하여 정적 전달 검사를 수행하고, 프로젝트 자체의 타입 검사를 실행합니다. 사용자가 정상적인 검증을 요청한 경우, 대표 프레임을 렌더링하고 수동으로 확인합니다:

  • 첫 장면의 주제 강조 프레임, 타이틀 프레임 및 저자 행.
  • 각 큐의 중간 및 종료 전 상태.
  • 가장 긴 자막 문장, 최대 카메라 확대, 가장 복잡한 인터페이스.
  • 휴대폰 전체 화면, 중요 숫자, 밑줄 및 중요 단어의 완전한 가시성.
  • 최소한 사운드 이벤트 테이블과 해당 큐의 프레임 매핑을 확인합니다. 재생 환경이 가능하면 주요 이벤트를 스폿 체크하고, 불가능하면 명시적으로 설명합니다.

사용자가 '바로 ZIP으로 내보내기, 검증 불필요'라고 말하는 경우 프레임별 미리보기를 수행하지 않지만, 타입 검사와 패키징 가능성 검사는 완료해야 합니다.

references/delivery-checklist.md를 사용하여 최종 검사를 수행합니다. ZIP 루트 디렉터리는 실행 가능한 프로젝트 파일을 직접 포함해야 하며, 의미 없는 추가 디렉터리 계층을 만들지 않습니다. README는 프로젝트 루트 디렉터리에 있어야 합니다.

전달 응답에는 간단히 설명합니다:

  • 무엇을 했는지.
  • 첫 장면과 타이틀의 독창적인 디자인.
  • 후속 장면들.
  • 음향 효과 이벤트 및 생성 방법.
  • 어떤 부분이 검증되었고, 어떤 부분이 검증되지 않았는지.

관련 스킬