Tạo và kiểm định video chuyển động ngắn với Claude Code Skill Motion Video Production

Sản xuất Video Chuyển động là gì?

Motion Video Production là một kỹ năng Claude Code hướng dẫn quá trình tạo video và đồ họa chuyển động dài 30–90 giây, từ lập kế hoạch ban đầu đến hoàn thiện bản dựng cuối. Thay vì xem việc tạo video là một lời nhắc duy nhất, kỹ năng này chia quy trình sản xuất thành sáu giai đoạn và kiểm tra đầu ra của từng giai đoạn trước khi tiếp tục.

Kho lưu trữ bao gồm tập lệnh kiểm tra tại harness/gate.py. Mỗi bước kiểm tra đo lường các hiện vật liên quan và trả về mã thoát: 0 nghĩa là giai đoạn đã đạt, còn 1 nghĩa là kết quả bị chặn và cần được sửa. Dự án cũng ghi lại 29 vấn đề sản xuất thường gặp trong references/gotchas.md.

Tính năng chính

• Quy trình sản xuất sáu giai đoạn: lập kế hoạch câu chuyện, thiết kế nhân vật, khung hình chính, đoạn video, âm thanh và hoàn thiện bản dựng.
• Các bước kiểm tra chất lượng có thể đo lường: tập lệnh kiểm tra tệp, thời lượng, số lượng khung hình, tỷ lệ khung hình, thuộc tính âm thanh và các yêu cầu riêng của từng giai đoạn.
• Điểm kiểm tra đánh giá thủ công: các vấn đề hình ảnh không thể đánh giá đáng tin cậy bằng chỉ số số học phải được con người xem xét và ghi lại.
• Hướng dẫn duy trì tính nhất quán của nhân vật: bảy tiêu chí giúp giữ ổn định ngoại hình, giọng nói, đồng bộ khẩu hình, nhịp điệu âm nhạc và chất lượng tổng thể giữa các cảnh.
• Tạo dải khung hình: bước kiểm tra đoạn clip tạo các dải hình ảnh cho thấy những thay đổi của nhân vật xảy ra sau khung hình mở đầu.
• Tài liệu tham khảo về vấn đề đã biết: 29 mục gotcha mô tả triệu chứng, nguyên nhân, bước phòng ngừa và mã kiểm tra harness liên quan.
• Mẫu và tập lệnh có thể tái sử dụng: kho lưu trữ bao gồm các mẫu lập kế hoạch và tiện ích phát hiện trùng lặp, tạo lưới nhịp, bảng clip, trộn âm thanh, ghép kênh và xác minh.

Điều kiện tiên quyết

Bạn cần Claude Code, Python 3, ffmpeg và ffprobe

Mã composition Remotion không được bao gồm trong kho lưu trữ này. Hãy cài đặt Remotion riêng và tạo composition cần thiết cho dự án của bạn.

Các công cụ tạo nội dung tùy chọn được dự án đề cập gồm ChatGPT hoặc Grok Imagine để tạo hình ảnh và video, Suno để tạo nhạc, ElevenLabs hoặc Fish Audio cho giọng nói và Whisper để đánh giá dựa trên bản chép lời. README lưu ý rằng việc tích hợp Whisper trong verify.sh chưa được xác minh.

Cài đặt Kỹ năng Claude Code

Claude Code tìm các kỹ năng tại ~/.claude/skills/<skill-name>/SKILL.md. Hãy sao chép kho lưu trữ, tạo thư mục skills và chép toàn bộ thư mục kỹ năng vào đó:

git clone https://github.com/unclejobs-ai/motion-video-skill.git
mkdir -p ~/.claude/skills
cp -r motion-video-skill/skills/motion-video-production ~/.claude/skills/

Cần sao chép toàn bộ thư mục motion-video-production vì harness, tài liệu tham khảo, tập lệnh và mẫu của thư mục này hoạt động cùng nhau.

Cài đặt Chỉ cho Một Dự án

Nếu chỉ muốn sử dụng kỹ năng trong một dự án cụ thể, hãy chép cùng thư mục đó vào thư mục .claude/skills/ của dự án thay vì thư mục dùng chung.

mkdir -p your-video-project/.claude/skills
cp -r motion-video-skill/skills/motion-video-production \
  your-video-project/.claude/skills/

Hãy khởi động lại Claude Code sau khi chép kỹ năng để chương trình có thể tìm thấy SKILL.md mới.

Kiểm tra Harness

Từ kho lưu trữ đã sao chép, hãy chạy bài tự kiểm tra harness:

bash skills/motion-video-production/harness/selftest.sh

Mã thoát 0 xác nhận harness kiểm tra hoạt động trên máy tính hiện tại. Nếu bài kiểm tra thất bại, trước tiên hãy xác minh rằng Python 3, ffmpeg và ffprobe đã được cài đặt và có trong đường dẫn lệnh.

Bắt đầu Dự án Video

Mở Claude Code và mô tả video bạn muốn sản xuất. Ví dụ:

Tôi muốn tạo một video mở đầu dài 30 giây có một nhân vật.

Trước khi bắt đầu sản xuất, Claude sẽ hỏi về bốn điều kiện:

1. Cách video sẽ được xuất bản hoặc phân phối.
2. Thời lượng và tỷ lệ khung hình dự kiến.
3. Các công cụ có sẵn cho quá trình sản xuất.
4. Những yếu tố không được xuất hiện trong kết quả.

Sau khi trả lời các câu hỏi này, kỹ năng bắt đầu với STORY.md và lần lượt đi qua các giai đoạn.

Tìm hiểu Quy trình Sáu Giai đoạn

Quy trình tạo ra các hiện vật như STORY.md, character.txt, key/, clip/, voices.json và edit.json. Mỗi hiện vật trở thành đầu vào cho một giai đoạn sau, vì vậy không nên bỏ qua một giai đoạn chỉ vì đầu ra của nó thoạt nhìn có vẻ đạt yêu cầu.

1. Lập kế hoạch Câu chuyện và Cảnh

Bước kiểm tra story kiểm tra các trường chưa hoàn thiện, thông tin BPM, thời gian dạng số trong bảng đồng bộ âm nhạc và bảng cảnh. Chạy lệnh với thư mục dự án làm đối số thứ hai:

python3 harness/gate.py story /path/to/video-project

Hãy xử lý các lỗi lập kế hoạch trước khi tạo các tệp phương tiện tốn kém. Đặc biệt, hãy xác định nhịp điệu âm nhạc và cấu trúc cảnh đủ sớm để các đoạn cắt sau này có thể tuân theo lưới nhịp.

2. Bảng Nhân vật

Bước kiểm tra character xác nhận rằng character.txt là một đoạn văn bản thuần duy nhất, có mô tả màu sắc và đi kèm hình ảnh bảng nhân vật bắt buộc.

python3 harness/gate.py character /path/to/video-project

Mô tả ngoại hình cố định và bảng nhân vật cung cấp một tham chiếu hình ảnh chung cho các keyframe và clip sau này.

3. Keyframe

Cổng keyframes phát hiện các tệp trùng lặp và kiểm tra tỷ lệ khung hình mà các clip yêu cầu.

python3 harness/gate.py keyframes /path/to/video-project

Keyframe không chỉ là hình ảnh dùng để lập kế hoạch. Chúng còn được dùng làm khung hình bắt đầu kỳ vọng cho các clip video được tạo.

4. Clip video

Cổng clips kiểm tra thời lượng, số khung hình và việc clip có bắt đầu bằng keyframe kỳ vọng hay không. Cổng này cũng tạo các dải khung hình và yêu cầu ghi lại quyết định cho từng clip.

python3 harness/gate.py clips /path/to/video-project

Một clip có thể khớp với keyframe ở phần đầu nhưng vẫn thay đổi quần áo, kính, tóc hoặc khuôn mặt của nhân vật sau đó một hoặc hai giây. Vì lý do này, cổng tạo các tệp qa/strip-<clip>.png chứa keyframe và các khung hình tại 0, 1.0, 1.5, 2.0 và 3.0 giây.

Mở các dải khung hình, kiểm tra những khung hình về sau và ghi lại kết quả trong qa/clips-review.md. Các chỉ số tương đồng như SSIM không thể phân biệt đáng tin cậy chuyển động có chủ đích của nhân vật với biến dạng nhân vật ngoài ý muốn, vì vậy các khung hình về sau cần được đánh giá thủ công.

5. Nhạc và giọng nói

Cổng audio kiểm tra dự án có sử dụng một voice ID duy nhất và có các tệp hội thoại bắt buộc hay không.

python3 harness/gate.py audio /path/to/video-project

Đo thời lượng hội thoại trước khi chốt độ dài các đoạn cắt. Nếu không, một câu thoại có thể không vừa tự nhiên trong cảnh được phân công.

6. Dựng và đánh giá cuối

Giai đoạn cuối sử dụng cả cổng edit và final. Các kiểm tra này bao gồm lưới nhịp, kết nối giữa các đoạn cắt, các đoạn cắt lặp lại, thời lượng hội thoại, số khung hình, sự hiện diện của âm thanh, độ lớn âm thanh, đỉnh thực và bản ghi đánh giá bắt buộc.

python3 harness/gate.py edit /path/to/video-project
python3 harness/gate.py final /path/to/video-project

Kết quả đánh giá hình ảnh của sản phẩm hoàn chỉnh phải được ghi trong qa/review.md. Các phép đo tự động không thay thế cho việc đánh giá này.

Cách xử lý khi một cổng bị chặn

Sử dụng cùng một vòng lặp khắc phục ở mọi giai đoạn:

1. Chạy python3 harness/gate.py <stage> <project-directory>.
2. Kiểm tra mã thoát của tiến trình.
3. Nếu mã là 0, tiếp tục sang giai đoạn tiếp theo.
4. Nếu mã là 1, mở qa/gate-<stage>.txt.
5. Tìm các dòng được đánh dấu BLOCK.
6. Khắc phục tệp đầu ra tương ứng.
7. Chạy lại cùng cổng cho đến khi đạt.

Không ẩn lệnh phía sau một pipeline như python3 harness/gate.py clips project | tail. Pipeline có thể thay thế trạng thái thoát của cổng bằng trạng thái của lệnh cuối, khiến một cổng thất bại trông như đã thành công.

Mẹo sản xuất nâng cao

Giữ ổn định nhận diện nhân vật ở mọi điểm nối

Dự án định nghĩa bảy tiêu chí nhất quán: bảng nhân vật, mô tả ngoại hình cố định, hình ảnh keyframe bắt đầu, giọng nói cố định, hội thoại và chuyển động môi, căn chỉnh theo nhịp nhạc và đánh giá chất lượng. Tham khảo references/consistency-7.md để biết vị trí của từng tiêu chí trong quy trình sáu giai đoạn.

Xây dựng đoạn cắt từ nhịp, không phải số giây tùy ý

Chọn độ dài đoạn cắt là bội số của nhịp nhạc. Khi chuyển đổi thời gian tích lũy thành khung hình, hãy làm tròn khung hình bắt đầu một lần từ thời gian tích lũy thay vì liên tục làm tròn từng phân đoạn riêng lẻ. Cách này giảm sai lệch thời gian và tuân theo hướng dẫn liên quan đến các lỗi G11 và G12.

Đo lời thoại trước khi khóa bản dựng

Hãy tạo hoặc đo hội thoại trước khi quyết định thời lượng đoạn cắt cuối cùng. Thứ tự này ngăn lời thoại bị dồn vào một cảnh quá ngắn và giải quyết lỗi G13.

Sử dụng đầu ra ffprobe đáng tin cậy

Video chứa hồ sơ ICC có thể khiến ffprobe -of csv=p=0 in ra số khung hình như 30,. Dự án khuyến nghị đầu ra mặc định, không có wrapper hoặc key:

ffprobe -of default=nw=1:nk=1 ...

Giữ nguyên độ trễ âm thanh khi lọc

Khi sử dụng ffmpeg, áp dụng apad và atrim sau adelay có thể loại bỏ độ trễ dự kiến. Hướng dẫn về lỗi của dự án yêu cầu dùng asetpts=N/SR/TB trong trường hợp này.

Sử dụng các tài liệu tham khảo đi kèm trước khi khắc phục sự cố một cách mù quáng

Mở skills/motion-video-production/references/gotchas.md khi một giai đoạn liên tục thất bại hoặc nội dung đa phương tiện được tạo thay đổi ngoài dự kiến. Mỗi mục trong số 29 mục ghi lại triệu chứng, nguyên nhân có khả năng xảy ra, hành động phòng ngừa và ID kiểm tra harness liên quan.

Các thành phần kho mã cần biết

• SKILL.md chứa hướng dẫn kỹ năng Claude Code.
• harness/gate.py thực hiện các kiểm tra đạt hoặc chặn theo từng giai đoạn.
• harness/selftest.sh xác thực việc cài đặt harness.
• scripts/ bao gồm các tiện ích kiểm tra trùng lặp, tạo bảng clip, tạo key plate, tạo lưới nhịp, phối âm, ghép kênh và xác minh.
• templates/ bao gồm các mẫu cho câu chuyện, bảng nhân vật, prompt và kiểm tra cảnh.
• references/ chứa hướng dẫn về tính nhất quán, thông tin lưới nhịp, quy tắc chi phí, ghi chú công cụ, thông tin cấp phép và các lỗi trong quá trình sản xuất.
• NOTICE.md tóm tắt các lưu ý về công cụ bên ngoài.

Cấp phép và trách nhiệm

Bản thân kho lưu trữ sử dụng giấy phép MIT, nhưng các công cụ tạo nội dung bên ngoài có điều khoản riêng về giá, cách sử dụng và cấp phép thương mại. Hãy xem lại NOTICE.md và references/licensing.md, sau đó xác minh trực tiếp các điều khoản hiện hành trước khi đưa vào sản xuất, vì giá cả và chính sách có thể thay đổi. Trách nhiệm đối với các nội dung được tạo vẫn tuân theo những thông báo này và các điều khoản bên ngoài.

Kết luận

Motion Video Production biến việc tạo video ngắn thành một quy trình có thể lặp lại và kiểm thử. Giá trị chính của công cụ không nằm ở một công cụ tạo nội dung đơn lẻ, mà ở chuỗi quy trình chặt chẽ kết nối kế hoạch, tài liệu tham chiếu nhân vật, khung hình chính, đoạn video, âm thanh và bản dựng cuối cùng. Bằng cách xem lỗi kiểm tra là một nhiệm vụ cần khắc phục thay vì bỏ qua, đồng thời hoàn tất các bước đánh giá hình ảnh bắt buộc, bạn có thể phát hiện các vấn đề về tính liên tục, thời lượng và phân phối trước khi chúng xuất hiện trong video hoàn chỉnh.