Communitygithub.com

adunext/adu-motion-video

완전한 애니메이션 엔지니어링 패키지를 사용하여 새 내레이션, 대본 및 자체素材로 편집 가능한 모션 비디오와 60fps MP4를 제작합니다. 또한 경량 TPL, 손그림 연결, 자막 및 기존 영상 개편을 지원합니다. 로컬 파일 읽기/쓰기 및 명령 실행이 가능한 에이전트가 필요합니다.

adu-motion-video란 무엇인가요?

이 스킬은 AI 에이전트가 제공된 내레이션 비디오, 대본, 시간 코드 자막, 그리고 권한이 있는 자료(예: 화면 녹화, 작품 벽, 아바타, 로고, 배경 음악)를 기반으로 완전히 편집 가능한 모션 비디오와 60fps MP4를 생성할 수 있게 해줍니다. 주된 사용 사례는 '완전한 엔지니어링 패키지'를 사용하여 품질 높고 편집 가능한 비디오를 제작하는 것입니다. 이 패키지는 특정 장면을 새 대사와 길이에 맞게 조정하고, 생성된 프로젝트를 검증한 후 최종 MP4를 내보냅니다. 이 스킬은 또한 경량 TPL 템플릿(빠른 시작용), 손그림 애니메이션, 자막 추가, 기존 비디오 개편을 지원합니다. 사용자는 먼저 템플릿 카탈로그에서 템플릿을 선택하거나 스타일을 지정하고, 제공된 스크립트(pipeline.sh)를 사용하여 계획, 구축, 검사, 미리보기 등 다양한 단계를 수행해야 합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 로컬 파일 시스템에 접근하고 명령을 실행할 수 있는 에이전트를 위해 설계되었습니다. 주요 특징으로는 적응형 구성을 통한 새 대본 처리, 여러 버전의 패키지 관리, 자료 및 색상 검증, 그리고 비디오의 청각적, 시각적 요소에 대한 철저한 품질 검사가 포함됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add adunext/adu-motion-video

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

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

문서

adu-motion-video은(는) 무엇을 하나요?

사용자가 편집된 내레이션 비디오, 대본, 그리고 가능하면 새 내레이션의 시간 코드 자막을 제공합니다. 화면 녹화, 작품 벽, 아바타, 로고 또는 배경 음악이 포함된 장면을 선택할 때는 해당 회차에 사용할 권한이 있는素材도 제공해야 합니다. 당신은 완전한 장면 안무를 새 대사와 러닝 타임에 맞게 조정하여 편집 가능한 프로젝트를 생성하고, 검증한 후 새 MP4를 내보내야 합니다. 먼저 제작 규칙을 읽으십시오. SKILL_DIR은 이 파일의 디렉터리이며, PL="$SKILL_DIR/scripts/pipeline.sh"입니다. 제작 기록은 실제 Skill 경로, 버전 및 사용된 진입점을 저장합니다. 동일한 이름의 이전 설치, 저장소 버전 및 이미 생성된 프로젝트의 고정 실행 코드는 다를 수 있으므로 최신 버전 설명으로 이전 프로젝트를 검증할 수 없습니다.

진입점 선택

사용자가 템플릿 번호(예: 01-B)를 지정하거나 스타일을 선택하도록 요청하면 먼저 템플릿 및 스타일 디렉터리를 읽고, "1차 템플릿 → 2차 스타일" 매핑을 따라 명시적인 패키지 버전으로 연결합니다. 미출시 스타일은 출시된 패키지로 약속된 대로 제작할 수 없습니다. 보조 애니메이션 자료가 필요하면 공개 애니메이션 자료 API를 통해 검색하여 이번 회차 프로젝트에 다운로드한 후, 선택한 패키지의 미디어 및 렌더링 요구 사항을 확인하십시오.

사용자가 완성된 프로젝트를 추가하거나, 새 장면 그룹을 추출하거나, 템플릿 라이브러리를 업데이트할 때는 지속적 템플릿 수집을 읽으십시오. 먼저 출처와 실제 상태를 등록한 후 가치에 따라 추출합니다. 프로젝트를 받았다고 해서 바로 출시 가능한 템플릿이 있는 것은 아닙니다. bash "$PL" packs는 패키지의 의미 체계 및 버전 메타데이터만 나열하며, 작업에 따라 관련 매니페스트를 로드합니다. 동일한 ID에 여러 버전이 있는 경우 id@version을 명시적으로 선택하십시오.

사용자가 03 · 다크 3D / 03-A · 멀티 스크린 전시를 지정하면 다크 3D 템플릿을 읽고 [email protected]를 선택하십시오. 이 템플릿은 아홉 개의 작품 벽, 멀티 스크린 비교, 확대 보기 및 소프트웨어 창 안무를 유지하며, 1080×1920 네이티브 세로 레이아웃을 새로 추가했습니다. 1.1.1은 HDR 프레임 추출 및 SDR 내보내기 색상 검증을 보완했습니다. 이전 콜드 설치 기록은 1.1.0에 속하며, 현재도 작성자의 연속적인 시청각 확인을 기다리는 중입니다. 이번 회차 자료에 따라 완전한 장면을 선택하며, 열일곱 개의 안정 그룹에 포함되지 않습니다. 기존 1.0.0은 원본 바이트를 유지합니다.

  1. 기본적으로 bash "$PL" packs를 실행하고, 표현 목적에 따라 명시적 버전을 선택한 후 관련 패키지의 README.md와 manifest.json을 읽고, 전체 프로젝트 재사용 설명을 확인하십시오. [email protected]은 피크 분산, 인물 응답 및 안정화를 유지하며, 총 세 개의 검증된 그룹이 있습니다. [email protected]은 동일 객체 변형, 분해 및 폐쇄를 유지하며, 총 두 개의 검증된 그룹이 있습니다. [email protected]은 종이 평면 원근 연결 그룹입니다. 안정 범위는 검증된 macOS 1080p60으로 제한되며, 전체 소스 또는 모든 대본이 템플릿화되었음을 의미하지는 않습니다. 그룹별 경계는 능력 매트릭스를 참조하십시오. 이전 후보 버전은 유지되며, B의 계획 간섭 그룹은 여전히 후보 상태입니다. 기존 anim3/anim4는 각각 12/9개의 완전한 장면이 있으며, 여전히 experimental 상태입니다. 패키지 ID는 원본 영상 제목이나 브랜드와 관련이 없습니다. C/D/E의 [email protected], [email protected] 및 [email protected]은 각각 세 개의 안정 그룹이 있으며, 각각 앞뒤 레이어와 인물 양보, 분할 및 교차交接, 단어 전체와 개체 응답을 유지합니다. 각 경로는 추출에 참여하지 않은 실행자가 고정된 공개 패키지와 이번 회차 입력을 사용하여 독립적으로 99.5초짜리 새 영상을 제작했으며, 작성자가 확인했습니다. 이전 후보 원본 바이트는 유지됩니다. 이번 회차 브리지는 공개 안정 그룹으로 간주되지 않습니다.
  2. 경량 단편 영상이나 레이아웃 탐색만 필요한 경우, 9개의 기본 TPL을 사용하십시오. 이들은 quick-start이며, 전체 엔지니어링 패키지의 모든 동작을 포함하지 않습니다.
  3. 손그림 캐릭터, 추가 촬영 동일 샷 연결은 손그림 애니메이션 방법을 읽으십시오. 현재 해당하는 완전한 엔지니어링 패키지가 없으므로, 방법 문서를 자동 템플릿화되었다고 부르지 마십시오.

3.3.0에 02-B · 종이 집합 [email protected]이 추가되었습니다. 여섯 가지 자료를 네트워크로 집계하며, 일곱 단계 캘린더, 여섯 가지 능력, 세 가지 개봉 및 전달 카드 스택의 두 가지 안정 그룹이 있습니다. 소스/재생 대조 및 18.2667초 길이의 다른 콘텐츠 샘플은 작성자의 시청각 확인을 받았습니다. 이번 회차 실제 내레이션/대본이 필요하며, 고정 SHA의 제목 폰트를 명시적으로 제공해야 합니다. 자세한 내용은 패키지 설명을 참조하십시오. 이는 그룹 수준 증분이며, 새로운 전체 영상 경로가 아닙니다. 엄격한 그리드 문제는 review.json에 보관됩니다. 3.2.0의 열다섯 개 안정 그룹과 이전 후보 모두 원본 바이트를 유지하며, 현재 일곱 가지 스타일, 총 열일곱 개 안정 그룹이 있습니다.

전체 엔지니어링 패키지 프로세스

3.6.0에 현재 스토리보드의 로컬 재구성 및素材 버전 검사가 추가되었고, 일반 비디오 프레임 추출을 위한 공유 색상 처리가 도입되었습니다. 04-A · 계기대 시연의 현재 후보 [email protected]는 경계가 있는 텍스트 레이아웃을 추가했습니다. 원래 0.1.1의 세 그룹에 대한 동일 콘텐츠 기술 재생은 유지됩니다. 음소거 새 대본 검사는 새 내레이션의 완전한 시청각 또는 독립적 재사용 검증을 대체하지 않습니다. 자세한 내용은 템플릿 설명을 참조하십시오. 새 미리보기는 내보내기 증거와 버전 검사가 포함된 preview 명령을 통일적으로 사용합니다.

새 대본은 먼저 시스템 적응 메커니즘에 따라 brief.json을 생성하고, bash "$PL" macro-plan 패키지ID@버전 brief.json 새계획디렉터리를 실행합니다. 이 진입점은 의미 단계, 수량, 원래 속도 동작 창 및 전후 장면 종속성을 기준으로 필터링한 후, 합법적인 조합 내에서 효과 중복을 줄입니다. 8개의 스타일 패키지에 있는 26개의 완전한 그룹에 대해 코드로 확인된 적응 프로필이 있으며, 능력은 여전히 adaptation-experimental입니다. spec.json/report.json/report.md/profile.json을 출력합니다. 종료 코드 0은 바인딩 검사 통과, 2는 저장되었지만 보충 또는 차단된 초안, 1은 잘못된 입력입니다. 미디어 또는 실제 키워드 시간 코드가 누락된 경우 brief를 수정하고 다시 계획하며, 소스 데모 시간 코드를 채우지 마십시오. macro-spec은 기록/수동 레시피 진입점으로 유지되며, 이 계층의 의미 및 인접성 진단을 제공하지 않습니다. 새 제작은 adaptation이 포함된 계획을 우선적으로 사용하며, 빌드 시 재검증합니다.

기존 계획에 자료를 추가해야 하는 경우, 로컬 스토리보드 재구성에 따라 macro-rematch를 실행하고, 제안을 확인한 후 macro-apply-rematch를 통해 새 디렉터리에 저장합니다. 원래 세그먼트의 의미, 시간 및 기타 스토리보드를 고정하고, 미디어와 양측 이음새를 재검증합니다. 기준선이나 자료가 변경된 경우 적용을 거부합니다. 호환되는 새 그룹이 없으면 원래 그룹을 유지하고, 무작위로 효과를 바꾸거나 다른 템플릿의 대본 매핑을 추측하지 마십시오. 이 인터페이스는 제작 도구에서 호출하도록 설계되었으며, 아직 ADuDir 드래그 앤 드롭 인터페이스에 연결되지 않았습니다.

  1. bash "$PL" doctor를 실행하여 Node, Python, FFmpeg 및 Chrome을 확인합니다. 종속성이 누락되었고 설치가 허용되는 경우 bash "$PL" setup을 실행합니다. 소스 프로젝트와 원본 완성 영상은 읽기 전용으로 유지하고, 존재하지 않는 새 경로에 출력합니다.
  2. 먼저 사용자가 지정한 템플릿 소스를 고정합니다. 자료 디렉터리의 다른 anim, 새 프로젝트 또는 기존 완성 영상은 자동으로 애니메이션 초안이 되지 않습니다. 일부 템플릿 조각만 삽입했다고 해서 전체 영상이 지정된 템플릿을 사용했다고 말할 수 없습니다. 장면별로 소스 패키지와 장면 ID를 기록합니다. 전체 패키지 혼용은 소스 및 다중 패키지 편성을 참조하십시오. 새 내레이션과 대본을 정렬하고, 핵심 대사의 정확한 시간을 확보합니다. SRT에 전체 문장 시간만 있는 경우, 문장 내 특정 단어의 시간을 추측할 수 없습니다. 단어별 정렬 데이터나 수동 주석을 사용하십시오. 패키지의 role, cues, motionWindows, slots를 읽고, 의미에 따라 완전한 장면을 선택, 재정렬 또는 반복합니다. 먼저 스토리보드와 누락된 자료를 나열합니다.
  3. 새 내레이션에 따라 brief를 작성하고, bash "$PL" macro-plan 패키지ID@버전 /경로/이번회차brief.json /기존부모디렉터리/새계획디렉터리를 실행합니다. 보고서를 확인하고, 누락된 항목이 있으면 brief를 보완한 후 다시 계획합니다. 생성된 spec.json을 사용하여 빌드합니다. 렌더링 전에 재사용 콘텐츠 확인에 따라 단계와 실제 대사, 주요 이벤트 시점, 자료 정체성 및 전체 영상 내 반복을 확인합니다. 플래너는 선언된 구조를 확인하지만, 채워진 단계가 대사에 충실한지 판단하지 않습니다. 수동으로 기록 레시피를 유지할 때만 macro-spec을 사용하십시오. 이 진입점의 cue는 비어 있으며, 예제 텍스트와 원본 영상 길이는 인터페이스 이해를 위한 것일 뿐입니다. 반드시 이번 회차 콘텐츠와 실제 시간 코드를 입력해야 하며, 각 반복 그룹에 기계적으로 동일한 오프셋을 추가할 수 없습니다. brand에는 이번 회차 계정을 입력하십시오. 이번 회차 음악은 music:{mode:"track",path,offset}으로 지정할 수 있습니다. 지정하지 않으면 원래 편곡 구조에 따라 재합성됩니다. 인물 창은 기본적으로 macOS에서 Vision을 사용하여 새 내레이션의 얼굴을 추적합니다. 자동 추적이 불가능한 경우 검증된 faceTracking:{mode:"fixed",cx,cy,h}를 명시적으로 구성해야 합니다. 모든 소스 데모 데이터와 예제 텍스트는 교체하거나 명확하게 "예시"로 표시해야 합니다. 자료의 빈 경로는 누락을 의미합니다. 미디어 준비 및 용량 제한은 패키지 디렉터리의 README.md를 참조하십시오.
  4. bash "$PL" macro-build 패키지ID@버전 /경로/새계획디렉터리/spec.json /경로/편집된내레이션.mp4 /경로/새프로젝트 [--subs-js /경로/자막.js]를 실행합니다. 새 내레이션 길이는 계획된 총 프레임 수와 일치해야 합니다. 어댑터는 핵심 동작 창을 원래 속도로 잠그고, 긴 단락은 체류 가능 영역만 늘립니다. 시간이 충분하지 않으면 오류를 보고하고, 스토리보드나 세그먼트 길이를 변경하며, 전체 영상을 선형으로 늘리지 않습니다. 텍스트, 숫자, 미디어 또는 핵심 cue가 누락된 경우에도 오류가 보고됩니다.
  5. bash "$PL" stills /경로/새프로젝트 0,4,12,...를 실행하여 첫 프레임, 각 cue 전/중/후, 가장 긴 텍스트, 장면 이음새 및 엔딩을 샘플링합니다. 작은 원형 창은 양쪽 눈, 입 및 턱이 보여야 하며, fixed 매개변수는 이번 회차 자료에서 결정하고 고개 숙임, 들어올림 등 극단적인 자세를 확인해야 합니다. 그런 다음 모든 복잡한 움직임 구간을 재생하고 원래 프로젝트와 대조합니다. 글꼴, 미디어 비율/크롭, 실제 입 모양, 자막, SFX 및 음악을 확인합니다. 구성을 수정하거나 프로젝트를 변경하고 다시 검증합니다.
  6. bash "$PL" audio /경로/새프로젝트 → bash "$PL" mix /경로/새프로젝트 → bash "$PL" render /경로/새프로젝트 /경로/새영상_v1.mp4 → bash "$PL" check /경로/새영상_v1.mp4를 실행합니다. 최종 인코딩된 파일을 전체 시청 및 청취합니다. check의 프레임 수, 디코딩 및 음량은 시각적 및 콘텐츠 검수를 대체할 수 없습니다. 새 미리보기는 bash "$PL" preview /경로/새프로젝트 /경로/새영상_v1.mp4 /기존부모디렉터리/새미리보기디렉터리를 통해 통일적으로 게시하며, 실제 완성 영상 SHA를 바인딩하고, 재생 버전을 표시하며, 이전 탭 업데이트를 알립니다. HDR/DV, 소스 비트 깊이 및 메타데이터 위험은 素材 색상 및 미리보기에 따라 실제 비교 증거를 남겨야 하며, 단순히 태그만 확인해서는 안 됩니다.

기본 템플릿을 빠르게 체험하려면 bash "$PL" demo /존재하지않는새디렉터리를 사용하십시오. 실제 내레이션을 위해 처음부터 TPL을 조합할 때는 템플릿 디렉터리 및 자막 옵션에 따라 제작하며, 여전히 전체 검증이 필요합니다.

생략할 수 없는 검사

  • 내레이션 프레임 추출은 대상 출력 클록을 기준으로 합니다. 소스 장면 애니메이션은 매핑된 원래 안무 클록으로 실행됩니다. 원래 장면 클록이 실제 입 모양을 제어하게 하거나, 고정된 실제 인물 프레임으로 누락된 길이를 채울 수 없습니다.
  • 첫 프레임이 내레이션 시작이면 실제 인물과 주제가 보여야 합니다. 자막 흰색 테두리, 글꼴 크기 및 안전 영역을 확인하고, 템플릿 소스 비디오의 브랜드, 날짜, 숫자 또는 자리 표시자 텍스트가 새 영상에 남아 있지 않아야 합니다.
  • 각 동작 보호 창의 연속 세그먼트를 확인하고, 단일 이미지만 샘플링하지 마십시오. 화면 녹화, 9격자, 작품 벽은 이번 회차 실제 자료로 확인합니다. 음악과 음향 효과는 새 타임라인에 따라 재편집하며, 기존 완성 영상의 오디오 트랙을 단순히 속도 변경하지 마십시오.
  • 새 대본이 자동으로 무손실 적응을 보장하지 않습니다. 짧은 세그먼트가 동작을 수용할 수 없으면 거부, 분할 또는 장면 변경합니다. 긴 세그먼트는 체류가 허용된 위치에서만 연장합니다. 새 장면은 여전히 이번 회차 콘텐츠에 맞게 설계해야 하며, 문장을 거시 장면에 강제로 맞추지 마십시오.
  • 새 프로젝트와 새 버전의 완성 영상을 출력하며, 사용자의 원래 프로젝트를 덮어쓰지 않습니다. 실제 검사 범위를 보고합니다. anim3와 anim4는 완전한 새 대본의 프레임별 대조 및 완성 영상 시청각 검증 전까지 experimental 상태를 유지하며, 완전히 검증되었다고 말하지 마십시오.

더 많은 세부 사항: 전체 프로젝트 재사용 · 제작 규칙 · 자막 · 배경 음악 · 손그림 · 문제 해결.

관련 스킬