Communitygithub.com

Hownameee/short-videos

生成、修訂或排解本地 Kokoro 旁白、發音與場景詞彙時序問題。重複使用已驗證且未修改的片段;在進行設定變更前先檢查 Python 環境。排除研究、視覺效果、音樂創作與發佈流程。

short-videos 是什麼?

此技能旨在協助開發者與 AI 代理使用者,透過本地 Kokoro TTS 引擎高效管理旁白生成流程。其核心價值在於確保旁白、發音與場景內詞彙時序的高度一致性,並透過嚴謹的版本比對機制,僅重新合成有變更的場景片段,藉此大幅節省運算資源與時間。此技能支援美式/英式英語的 24 kHz 音訊生成,並明確規範了安裝、依賴管理與語言變更的流程。它整合了全面的驗證步驟,從生成前的前置檢查到生成後的音訊品質審查,確保最終輸出的旁白符合專業影片製作預設規範。此技能適用於 Claude Code、Cursor 等支援指令執行的開發平台,特別適合需要批次處理大量影片旁白、追求高效率迭代與穩定輸出的專案。

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

在你喜歡的 AI 中提問

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

說明文件

Kokoro 旁白

使用已批准的文本與共享生成器;請勿複製專案專屬的 TTS 腳本,或將預測的時間戳記取代為估算的句子時序。

.venv-kokoro/bin/python tools/kokoro/generate_audio.py --project projects/NNN-topic

此輔助程式支援比對美式/英式英語語音,取樣率為 24 kHz。僅在需要安裝、處理依賴失敗或變更語言時,才閱讀設定與語言參考;請先檢查 interpreter/pyvenv.cfg。在新增依賴項前先詢問。其他語言需要受支援的提供者或進行試聽;切勿保證透過英語音系學能產生原生的越南語。

修訂與重複使用

保持穩定的唯一場景 ID。生成器會檢查文本/發音、模型、語音、語言、速度、取樣率、套件、生成器/字幕程式碼版本、WAV 雜湊/持續時間以及單詞/字幕覆蓋率。僅有無效的場景會被合成;未變更的 WAV 與時間戳記會以位元為單位完整保留。舊的已驗證清單可採用一次。完全未變更的執行流程亦會使清單保持不變。生成階段會先處理所有結果,再切換語音目錄;若失敗則保留前一組設定。請勿對同一個專案同時執行寫入器。

使用 --force 刻意重新生成所有片段,包括在相同模型識別碼下變更本機快取的模型權重之後(權重位元組不屬於快取鍵的一部分)。新的模型/語音/速度會使每個受影響的片段失效。純音樂修訂不會呼叫 TTS。

使用腳本的發音對應表來標準化縮寫、數字與 URL。保留 sourceText 與實際口說文本的差異;字幕遵循口說文本,除非另外對齊。每個預期表達的短語只說一次。標點符號並非時序保證。

在場景幀之前測量實際 WAV 持續時間。在提高速度前,先縮短、擴展或拆分密集的場景;切勿為了符合猜測的持續時間而裁剪語音。若有需要,保留原始音訊並建立單獨的填補/重新取樣衍生檔案。

驗證

在生成後執行工作流程前置檢查。要求完整的、有序的、在範圍內的單詞、短語邊界、正確的取樣率、非空的、可解碼的音訊以及測量到的持續時間。時間標記包含實際前一段落的長度,並附加標點符號。審查遺失/重複/裁剪的單詞、發音、停頓、峰值與結尾空間。盡可能聆聽;預測的對齊並非獨立的轉錄。檢查三個連續的醒目提示片段與後續的一個場景/區塊,遵循預設值。記錄未執行的聆聽。

Individual skills in this repo

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

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

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

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.

相關技能