BÀI VIẾT
HyperFrames skills: chọn workflow và hoàn thiện video đầu tiên
Cài skill, chọn đúng workflow và bàn giao video đã kiểm tra với ranh giới bằng chứng rõ ràng.

Trong bài viết
Một video đầu tiên có ích bắt đầu từ vấn đề nhỏ của người xem, brief rõ và project có thể kiểm tra. Bài này giải thích vai trò thật của HyperFrames skills, cách cài đặt và hoàn thành một video, đồng thời phân biệt prompt cho agent với lệnh terminal.

Phân biệt agent viết project với bộ máy render
HyperFrames là framework dựng và render video bằng công nghệ web. Coding agent viết project; skills hướng dẫn agent lên kế hoạch, chọn workflow và tuân thủ cấu trúc composition. Renderer xuất video từ composition đó. Vai trò này khác với model sinh footage quang thực từ một câu mô tả. Có thể đưa footage AI vào video, nhưng footage chỉ là một loại đầu vào. Repository chính thức mô tả kiến trúc và các package của framework.
Sự khác biệt này rất hữu ích trong đời sống. Giáo viên có thể làm sơ đồ chuyển động, chủ cửa hàng giải thích sản phẩm từ ảnh thật, lập trình viên minh họa ứng dụng đang chạy. Chữ, bố cục và thời gian vẫn chỉnh sửa được. Tuy nhiên, không phải chủ đề nào cũng nên trở thành motion graphic: thao tác nấu ăn có thể cần đôi tay thật, còn câu chuyện cá nhân có thể phù hợp với một đoạn ghi hình chân thành. Hãy chọn bằng chứng cần thể hiện trước khi chọn hiệu ứng.
Chọn một kết quả nhỏ cho lần đầu
Dùng mục tiêu như “Sau khi xem, phụ huynh biết tìm trình sửa kịch bản song ngữ” thay vì “Giới thiệu tất cả tính năng”. Video 30 giây chỉ đủ cho một thay đổi nhỏ mà người xem hiểu được, không phải toàn bộ sách hướng dẫn. Xác định người xem, hành động cần hiểu và hình ảnh bắt buộc phải xuất hiện để hành động đó đáng tin. Sau đó chọn đầu ra: video nhúng website, clip dọc hay bài trình bày tương tác.
Bài tập đầu tiên đề xuất trong series là đếm ba quả táo rồi trả lời một câu hỏi. Kết quả mong muốn là nhận biết nhóm nhỏ, không phải phát triển kênh trẻ em. Viết đáp án và số đồ vật trước khi nhờ agent dựng hình. Nếu cảnh có sai số quả táo, chuyển động đẹp không thể sửa lỗi kiến thức đó.
Cài skills và kiểm tra môi trường
Quickstart chính thức hướng dẫn cài skills vào môi trường coding agent. Ngày 9/10/2026, chúng tôi kiểm tra CLI 0.8.143 và phần help; package này yêu cầu Node.js từ phiên bản 22. Các lệnh dưới đây là công thức có thể làm theo cho phiên bản đã kiểm tra, không phải tuyên bố đã render một bài học mới trong đợt nghiên cứu này. Lệnh shell chạy ở terminal; prompt có dấu gạch chéo được gửi trong chat với agent.
# Terminal: cài bộ skills từ repository chính thức
npx skills add heygen-com/hyperframes
# Terminal: xem phiên bản CLI và trạng thái skills
npx hyperframes --version
npx hyperframes skills check
# Terminal: cài hoặc cập nhật workflow muốn dùng
npx hyperframes skills update faceless-explainer
# Terminal: kiểm tra provider trước khi hứa có thuyết minh
npx hyperframes auth status
Nếu agent đã có plugin HyperFrames, ưu tiên launcher và hướng dẫn đi kèm plugin, tránh tạo thêm một bản cài cạnh tranh. Khởi động lại phiên làm việc nếu agent chưa thấy skills mới. Ghi lại phiên bản CLI và workflow sử dụng. Một lần cập nhật sau có thể thay đổi lệnh hoặc đầu ra; project đã pin phiên bản dễ điều tra hơn thư mục trộn nhiều phiên bản không có ghi chép.
Chọn workflow theo tài liệu đầu vào thật
| Tài liệu đang có | Workflow khởi đầu | Bằng chứng cần giữ |
|---|---|---|
| Chủ đề hoặc ghi chú bài học | faceless-explainer | Lời giải thích đã duyệt và nguồn kiến thức |
| Ứng dụng hoặc website sản phẩm | product-launch-video | Ảnh giao diện thật hoặc brief sản phẩm chính xác |
| Đoạn ghi hình người nói | embedded-captions hoặc talking-head-recut | Lời nói và footage gốc |
| Pull request thật | pr-to-video | Thay đổi được cung cấp và hành vi đã kiểm tra |
| Montage lấy nhạc làm nhịp chính | music-to-video | Track được phép dùng và tư liệu cá nhân phù hợp |
| Biên tập footage tùy biến | general-video | Đoạn nguồn được chọn và ý đồ biên tập |
| Deck có điều hướng | slideshow | Cấu trúc slide, không mặc định đầu ra là MP4 |
Prompt guide giải thích các nhánh sáng tạo này. Bắt đầu bằng /hyperframes khi chưa rõ đường đi. Chủ đề nhắc tên công ty không tự động trở thành quảng cáo sản phẩm. Ngược lại, yêu cầu trình diễn giao diện thật không nên bị chuyển âm thầm thành một explainer có hình vẽ gần giống giao diện.
Gửi brief đủ rõ để agent thực hiện
/hyperframes Tạo video ngang khoảng 30 giây cho phụ huynh giúp bé đếm
ba quả táo. Mục tiêu là đếm mỗi đồ vật đúng một lần. Dùng ba hình minh họa
đơn giản, hiện từng số theo lời đọc, rồi hỏi người xem chọn hai hay ba.
Chừa một khoảng suy nghĩ trước khi hiện đáp án. Thuyết minh tiếng Anh ấm áp,
phụ đề rõ, màu kem và xanh teal dịu. Không dùng ảnh trẻ em thật, không bịa
kết quả học tập, không thêm lời mời đăng ký kênh. Giữ project chỉnh sửa được.
Mở preview và ghi rõ phần nào còn cần phụ huynh kiểm tra.
Đây là bài tập đề xuất do tác giả soạn, chưa phải video mới đã render. Prompt cung cấp người xem, mục tiêu, độ dài gần đúng, định dạng, nội dung và giới hạn. Bố cục chi tiết được để workflow quyết định. Đừng đưa kịch bản năm phút vào yêu cầu 30 giây rồi mong agent giữ nguyên mọi ý. Khi giọng đọc dài hơn, rút gọn nội dung hoặc cho phép clip dài hơn. Thời gian phải phục vụ sự hiểu bài.
Duyệt kế hoạch trước khi duyệt hình ảnh
| Khoảng thời gian dự kiến | Người xem thấy | Điều cần kiểm tra |
|---|---|---|
| 0–5 giây | Một quả táo và lời mời đơn giản | Mục tiêu học tập rõ ngay từ đầu |
| 5–15 giây | Ba đồ vật được đếm một lần | Mỗi số đọc tương ứng một đồ vật |
| 15–24 giây | Câu hỏi và thời gian suy nghĩ | Đáp án chưa bị tiết lộ quá sớm |
| 24–30 giây | Đáp án đúng và nhắc lại | Củng cố đúng khái niệm ban đầu |
Storyboard giúp phát hiện trình tự sai trước khi mất công render. Xem người học cần chú ý điều gì trong từng cảnh rồi bỏ trang trí cạnh tranh với ý chính. “Khoảng 30 giây” chỉ là ước lượng cho đến khi có giọng thật. Nếu bé cần thêm thời gian trả lời, đừng tăng tốc quiz chỉ để tổng thời lượng tròn số.
Hoàn thành video trong thư mục project
Agent cần chỉ rõ thư mục project, brief và composition. Chạy các lệnh project trong thư mục đó, không phải một repository không liên quan. Chuỗi dưới đây được đối chiếu với help của CLI. Xem snapshots và preview trước bản render bàn giao; check tĩnh thành công chưa chứng minh ảnh, giọng đọc hoặc trình tự dạy học là đúng.
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at 5,15,25
npx hyperframes preview --background
# Sau khi duyệt preview đã lắp đầy đủ:
npx hyperframes render --quality delivery --output renders/count-three.mp4
Mở MP4 cuối bằng trình phát thông thường. Nghe đoạn đầu và cuối, thử phụ đề, xem ở kích thước khán giả thực sự dùng. Giữ source project, media cuối và một ghi chú kiểm tra ngắn. Nếu chỉ bàn giao MP4 mà không có project, lần sửa sau thường tốn công hơn cần thiết.
Học từ ví dụ đã chạy thật
Bài walkthrough Studio có ba clip HyperFrames hoàn thành từ ảnh UI local thật và dữ liệu fixture trong repository. Thời lượng gần đúng là 28,1; 27,3 và 33,4 giây. Release đó dùng HyperFrames 0.8.140, giọng Kokoro tiếng Anh và cue phụ đề được soạn theo câu. Track tiếng Việt là bản tóm tắt, không phải bản dịch đầy đủ được căn từng từ.
Chúng tôi đã đọc lại thao tác sửa tiêu đề song ngữ qua API local, kiểm tra phát video công khai và tải phụ đề. AI và YouTube được giả lập, không đăng lên kênh thật. Bằng chứng này cho thấy luồng được chụp và phần bàn giao hoạt động trong bài thử có giới hạn. Nó chưa chứng minh mọi job Studio hoặc mọi workflow HyperFrames sẽ chạy nguyên trạng trên máy của bạn.
Chẩn đoán các lỗi thường gặp lần đầu
Nếu agent không nhận slash command, kiểm tra cài skills và phiên chat trước khi sửa brief video. Nếu preview trống, đọc kết quả check và kiểm tra composition có được mount đúng không. Nếu không có giọng, phân biệt chưa sinh audio với audio được đặt sai trên timeline. Nếu bước phụ đề báo không có từ dùng được, chọn hướng transcription được hỗ trợ hoặc soạn cue rõ ràng; không tuyên bố đã căn tự động khi thực tế chưa có.
Bài tập cuối là hoàn thành một mục tiêu học tập, không phải tạo càng nhiều file càng tốt. Lưu biên bản chấp nhận ngắn: kiến thức đúng, tư liệu được phép dùng, giọng nghe rõ, phụ đề đúng với mục đích đã ghi, trình phát cuối hoạt động, hoạt động cho trẻ đã được người lớn duyệt. Bộ bằng chứng nhỏ này là nền tảng cho các ứng dụng lớn hơn trong series.



Thảo luận
Bình luận được duyệt trước khi công khai. Email của bạn được giữ riêng tư.