Ctrl K

Tóm tắt nhanh / Lệnh

Bộ Engineer

/ak:html-video

Pipeline MP4 local từ HTML

Tạo MP4 local từ template HTML/CSS/JS bằng nexu-io/html-video: chẩn đoán setup, tìm template, tạo project, tùy chỉnh asset, preview, render và kiểm bằng ffprobe.

Định tuyến loại video

Chẩn đoán setup

Khóa brief

Tìm template

Nguyên tắc 01

Chạy diagnostics html_video trước workflow; phần tạo vẫn bắt đầu bằng brief đã chốt, không render ngay.

Nguyên tắc 02

Inspect template trước khi chọn; schema biến rỗng cần Studio hoặc sửa project.

Nguyên tắc 03

Không commit MP4 lớn sinh ra trừ khi user muốn version artifact đó.

Bản đồ thực thi

Các nhánh chính từ đầu vào đến kết quả, bám theo cách command chạy khi dùng thật.

Khởi động

Đầu vào, phạm vi, route

1 Định tuyến loại video Dùng html-video cho video HTML theo template; chuyển React/Remotion, encode-only, preview tĩnh, QA browser hoặc việc cần Chrome profile sang skill thay thế đã ghi.
2 Chẩn đoán setup Ưu tiên binary html-video sẵn có; nếu không có thì dùng source checkout mà không vendor upstream vào project user, rồi chạy html_video doctor và list-engines trước workflow.

Xử lý

Agent / skill thực thi

3 Khóa brief Trước khi tạo, chốt audience, goal, duration, aspect ratio, asset hoặc URL, template mong muốn, output path và mức draft hay polished.
4 Tìm template Tìm template theo intent và aspect, inspect template được chọn và kiểm tra có biến để set hay không.

Kiểm chứng

Gate, review, xác thực

5 Tạo project Tạo hoặc tìm project với name, intent và aspect, rồi kiểm project-list/project-show khi cần.
6 Tùy chỉnh asset Set template, thêm inline text và file, và chỉ dùng project-set-var hoặc project-set-vars khi inspect-template cho thấy có biến.

Đóng

Báo cáo, bàn giao, artifact

7 Preview hoặc Studio Chạy project-preview và mở html_path trả về; dùng Studio ở port 3071 cho chỉnh sửa tương tác hoặc template không có schema biến.
8 Render và kiểm chứng Render với output path rõ ràng và stream progress, rồi dùng ffprobe xác nhận duration khác 0 và kích thước video đúng.

Cú pháp, đối số, subcommand

Cách gọi skill: cú pháp, đối số vị trí, option dùng chung, rồi từng subcommand với cú pháp và kết quả riêng.

Cú pháp

/ak:html-video [video brief, source URL, repo, template id, or project id]

Đối số

[video brief, source URL, repo, template id, or project id] Bắt buộc

Yêu cầu video hoặc nguồn

Brief bằng ngôn ngữ tự nhiên, URL nguồn, repository, template ID hoặc project ID/path hiện có. Nêu audience, goal, duration, aspect ratio, asset, template preference, output path và kết quả là draft proof hay polished export.

/ak:html-video "Create a 12-second 16:9 draft product promo from ./assets/cli-screenshot.png and the headline 'Ship with evidence'; use a discovered template, preview before rendering, write ./artifacts/ship-with-evidence.mp4, make no network asset requests, and do not commit or publish the video"

Prompt mẫu

Ví dụ gọi command theo từng flag, subcommand, mode hoặc route dùng được trong workflow thực tế.

Promo sản phẩm bằng template Khuyến nghị

/ak:html-video short product promo for a developer tool, 16:9, draft proof to ./assets/videos/agentkit-promo.mp4

Dùng khi:: Dùng khi sản phẩm hoặc tính năng cần MP4 local từ template HTML/CSS/JS thay vì composition Remotion.
Kết quả:: Chạy diagnostics html_video, chốt brief, tìm và inspect template, tạo project, preview html_path, render ra MP4 đã yêu cầu, rồi kiểm duration và dimensions bằng ffprobe.

Explainer từ URL

/ak:html-video create a 30 second explainer from https://example.com/article using a clean social clip template

Dùng khi:: Dùng khi một URL nguồn cần thành explainer hoặc social clip HTML-first local được render qua Chromium và ffmpeg.
Kết quả:: Xem URL là tư liệu nguồn, chọn và inspect template phù hợp, tổ chức path scratch/output, preview HTML, render MP4 và kiểm proof ffprobe.

Tùy chỉnh bằng Studio

/ak:html-video customize an existing project in Studio for a square launch teaser and export the finished MP4

Dùng khi:: Dùng khi template không có biến hoặc layout/copy cần tinh chỉnh tương tác trong Studio trước khi render.
Kết quả:: Mở preview hoặc Studio, dùng Studio để chỉnh rewrite và layout, export hoặc render project hoàn tất, rồi báo path MP4 đã kiểm cùng duration và dimensions từ ffprobe.

Render project sẵn có

/ak:html-video render project prj_123 to ./plans/launch/visuals/launch-proof.mp4 with stream progress

Dùng khi:: Dùng khi project html-video đã tồn tại và nhiệm vụ là render với output path rõ ràng.
Kết quả:: Hiển thị hoặc xác nhận project và template, chạy project-render với stream progress và output path đã yêu cầu, rồi dùng duration và dimensions đúng từ ffprobe làm proof hoàn tất.

Phạm vi xử lý

Tìm template
Project video HTML/CSS/JS
Tùy chỉnh bằng Studio
Render qua Chromium/ffmpeg
Kiểm chứng bằng ffprobe

Artifact tạo ra

Bằng chứng video đã render

Mẫu đường dẫn

Project id/path, template, preview html_path, path MP4 output, duration và dimensions từ ffprobe.

Path MP4 đã kiểm chứng là deliverable; trạng thái preview tạm không phải proof cuối.