Communitygithub.com

Hownameee/short-videos

執行共享短影音工作流程的第一階段:將原始主題或提示轉換為附有來源的研究包和 2–4 個不同的影片方向,每個方向皆包含可辯護的張力鉤子、承諾、回報、節奏、視覺方法、時長範圍與風險。

short-videos 是什麼?

此技能專注於短影音創作管線的第一階段(Phase 1),從使用者提供的原始主題或提示出發,產出一個經過驗證的研究包與多個具區辨性的影片方向,供後續腳本與製作階段參考。它強調事實查證與來源區分,要求使用當前可靠來源(如網路搜尋或使用者提供的資料包),而非依賴 LLM 記憶,以確保事實正確性與可歸責性。支援的平台包括任何需要短影音內容的工作流程(如 TikTok、Reels、Shorts),透過結構化的輸出(如 request.json、research.md、directions.json)與 artifact contracts 進行狀態管理。此階段會在使用者選擇方向後停止,不會自動進入腳本或生產階段,確保創作者保留決策權。最終輸出包含 2–4 個不同敘事邏輯的方向,每個方向都有詳細的鉤子、節奏、視覺方法與風險評估,並附有明確的推薦與權衡說明。

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

在你喜歡的 AI 中提問

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

說明文件

短影音探索

擁有第一階段。使用 artifact contracts 來持久化輸出。

輸入

當使用者開始新的影片工作流程或要求腦力激盪他們打算製作的影片時,首先掃描現有的 projects/<nnn>-* 資料夾,從 001 開始分配下一個補零的數字,推導出穩定的 slug,建立專案資料夾,並將 request.json 與 state.json 持久化為 request_created。若繼續進行,則重複使用已有的專案。對於純粹一般性、僅供閱讀且無意製作影片的討論,不要建立專案。

在詢問任何問題之前,先提取使用者已提供的資訊:

  • 主題與期望成果;
  • 目標受眾與假定的背景知識;
  • 平台與時長範圍;
  • 語言、語調、張力程度與 CTA 目標;
  • 允許或禁止的主張、來源、媒體與提供者。

對於次要細節,使用合理的預設值。僅在遺漏的回答會顯著改變研究範圍或安全性時,才提早詢問。將預設值記錄在 assumptions 中。

研究

針對可能改變或帶來重大後果的主張,使用當前主要或權威來源。區分:

  • 有直接來源的驗證事實;
  • 從引用事實推導出的推論;
  • 創意框架;
  • 未解決或遭駁斥的主張。

勿將 LLM 記憶視為網路研究。區域性的 LLM(例如 Ollama)可以組織證據並產生方向,但它需要搜尋適配器、擷取的 URL,或使用者提供的來源包來獲取當前證據。

建立一個包含 3–7 個有用主張的緊湊事實包。為每個主張記錄陳述、來源 URL、發布者、可用日期、信心等級以及它在影片中可以安全支持的內容。避免收集不會影響方向的無關事實。

產生方向

建立 2–4 個在敘事邏輯上有所區別(而非僅是措辭不同)的選項。有用的方向類型包括:

  • 痛苦或失敗的使用案例;
  • 對真實誤解的逆勢糾正;
  • 結果優先的示範;
  • 視覺類比;
  • 比較或前後對照;
  • 包含決定與後果的小故事。

每個方向需包含:

  1. 工作標題;
  2. 受眾問題;
  3. 張力鉤子;
  4. 承諾與回報;
  5. 兩到三個核心節奏;
  6. 可用的證據與任何薄弱的主張;
  7. 視覺方法與可能的素材來源;
  8. 音樂氛圍與節奏;
  9. 時長範圍;
  10. 製作複雜度與風險。

為鉤子評分 0–2 分,考量清晰度、真實性、受眾相關性與回報。若鉤子不符合真實性,即使聽起來吸引人也予以拒絕。不要將所有選項都誇大到相同完美分數;當分數相同時,解釋真正的權衡,並根據受眾契合度、證據強度與視覺回報來選擇。推薦一個方向,並用一兩句話解釋該權衡。

呈現決策點

使用一個不重複的比較表格,接著是建議與一個簡潔的提問。要求使用者選擇一個選項、合併指定的選項,或要求一個新的方向。僅在時長、張力與 CTA 仍具有重要意義且未解決時,才詢問相關問題。

第一輪於 directions_proposed 結束。在請求選擇後停止。不要產出完整旁白、呼叫 Kokoro、下載素材、建立 Remotion 程式碼或進行渲染。

持久化工件時,寫入:

  • 在研究開始前寫入 request.json 與 state.json;
  • 為人類閱讀而寫 research.md;
  • 為主張與來源出處而寫 research.json;
  • 為選擇而寫 directions.json;
  • 僅在使用者選擇後才寫入 direction.json,並將狀態移動至 direction_selected。

回報哪些事實仍然不確定,以及第二階段需要哪些選擇。

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

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.

相關技能