Communitygithub.com

Hownameee/short-videos

製作經批准的短影片,或修正現有影片的背景音效、情感、字幕、混音或匯出。僅產生變更的旁白、渲染並審視目前預覽、執行技術與編輯品管檢查,然後匯出。排除僅腳本與一般音訊建議請求。

short-videos 是什麼?

此技能旨在自動化短影片的生產與修正流程,確保輸出符合批准的腳本與品質標準。它專注於處理已批准的影片請求,避免重新發掘或要求已取得的批准,並透過明確的修訂流程處理音樂、旁白、視覺設計等變更。技能支援使用 npm 指令進行預覽與最終渲染,並在渲染前執行強制性預檢(preflight),驗證資產路徑、語音時序與音樂訊號等。最後,它會自動執行技術與編輯品管檢查,產生 QC 報告,並僅在所有檢查通過後才原子性地替換最終輸出,確保交付物的完整性與可追溯性。此技能適用於任何需要基於腳本與批准的短影片生產平台(如 Remotion),並提供詳細的文件引用,以處理不同類型的修正需求。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-production

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

短影片生產

檢查目標 state.json、已批准的 video.json、script.md 及現有生產筆記。 閱讀 預設值 一次。 使用已安裝的執行環境與 現有指令。

需要匹配的腳本批准與明確的生產請求。修正現有影片的請求授權範圍內的修訂與替換交付物。不要重新開始探索或要求已給予的批准。 空運行(dry-run)僅檢查與規劃,不建立媒體或索取測量值。

修訂

對於音樂、增益、淡入淡出、音效或字幕模式,執行 npm run video -- revise --project projects/NNN-topic,然後編輯 production.json。保留已批准的旁白與視覺效果。此疊加層保留舊的 批准雜湊。在 PRODUCTION.md 或疊加層中記錄聲音意圖。

對於已變更的旁白、場景內容、語音設定或設計資料,編輯腳本/設定,執行 script --draft,取得批准(除非已明確給予),然後執行 script --approve。草稿現在可在生產後運作,並保留先前的交付物。如果存在疊加層,重新批准後執行 revise。 切勿手動重寫批准雜湊。在撰寫疊加層或變更結構化欄位時,請諮詢 合約。 主題渲染器未實作分鏡表覆寫,且會被拒絕而非忽略。

專注閱讀

需要的工作閱讀
聲音選擇、情緒或混音聲音品管;相關的背景指南章節
產生/變更旁白Kokoro
變更美術指導、版面、場景動作或字幕 UI視覺設計
變更 Remotion 程式碼Remotion 實務,然後僅參考相關的 API/規則

對於純增益修正,不要載入語音設定、視覺設計、藍圖或所有 Remotion 套件。 當需要 API 指引時,使用匯入的專注套件,並針對不確定的版本詳細資訊驗證官方文件。 在工作報告中列出實際使用的指引。

生產與檢查

  1. 保留已批准的承諾、主張證據、回報與情境化 Call to Action。 為新場景記錄視覺論點與動作/提示/穩定。 新主題需要自己的渲染器;切勿將 Kubernetes 圖表偽裝成通用輸出。
  2. 當需要更新旁白時,使用共享語音產生器。它會驗證並 重複使用未變更的 WAV 與時間;變更會重新產生受影響的場景。測量 持續時間,保留提供者預測的字詞時間戳記,並審查發音。
  3. 解析資產並記錄來源/授權。實作有目的的聲音弧線: 鉤子 → 解釋 → 揭露 → 結尾;先混合語音,其次可聽的音樂, 最後選擇性音效。套用聲音品管,包括在可用時進行渲染聆聽。
  4. 在渲染前執行 video preflight --project …。它會驗證支援的 設定、資產路徑/校驗和、語音順序/時間、音樂訊號與持續時間。 解決失敗;不要繞過它們或捏造測量值。
  5. 渲染 --preview。檢查聯絡表(開頭、每個場景、結尾) 是否有焦點、可讀的行動文字、安全區域、資產品質與連貫的 視覺風格。檢查每個主要動作節拍的播放/連續幀。 靜態幀無法建立有意義的動畫。
  6. 檢查至少三個連續的單字 highlight 與後續場景/區塊; 記錄幀時間與時間來源。檢查遺失/重複/錯誤發音的 單字、語音清晰度、音樂弧線、淡入淡出、循環與手機/單聲道播放。 將編輯證據儲存在 output/qc.json 中,並連結到資產/輸出校驗和。 修正已證明的缺陷並重新產生受影響的工作與預覽。
  7. 從當前預覽渲染 --final。CLI 會檢查指紋、 時間軸持續時間、尺寸/FPS、H.264/AAC、完整解碼、響度與真實 峰值。它會另外將 output/automated-qc.json 與編輯 QC 分開寫入。
  8. 交付實際的最終檔、報告與快照。CLI 會原子性地取代 final/report/snapshot/state,並僅在檢查完成後存檔精確的共用 renderer/src/; 失敗則保留先前的最終檔。如果要建立一個命名的複本,請驗證其 是否與最終校驗和相符。

輸出中不得有黑色/遺失幀、模糊的回報、機密或內部提示。 保留資產權利記錄;購買或發布是單獨的授權。 背景資產存在或最終響度本身無法證明可聽的情緒契合。 如果無法聆聽,請完成授權的測量匯出,將其標記為 not-performed, 並揭露限制。不要捏造通過。

空運行回應:一個預檢表格、有序計畫、QC 清單與工件清單。 對尚未進行的測量使用 <measured> 佔位符。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

相關技能