Communitygithub.com

Akira-TL/akira-video-skills

將小說、章節、故事梗概、品牌簡報或其他上游內容轉換成當前影片自己的腳本層;在需要編寫或修訂 SCRIPT.md、影片人物表演定義、場景定義、對白或鏡頭總表時使用。

akira-video-skills 是什麼?

此技能專為影片腳本製作而設計,幫助 AI 代理(如 Claude Code、Cursor 等)從上游來源(小說、章節、品牌簡報等)中提取關鍵資訊,並建立最小且獨立的影片腳本層。它強調避免重複儲存上游內容,僅保留當前影片所需的表演、場景和鏡頭定義。支援的輸出文件包括 SCRIPT.md、CHARACTERS.md、SCENES.md 和 SHOTS.md,並可根據項目需求靈活創建,避免不必要的空文件。此外,技能內建了對劇情連貫性、角色表演、對白時長和整體片長預算的檢查規則,確保腳本生成後可直接用於後續的鏡頭製作,而無需人工修補。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-script

在你喜歡的 AI 中提問

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

說明文件

Video Script

本 Skill 只擁有 video/script/ 中的影片化製作定義。上游小說、世界觀、章節、完整人物檔案、客戶資料或其他來源繼續歸原權威來源;這裡只保存當前影片為了表演、場景和鏡頭製作做出的轉換與選擇。

1. 讀取上游來源與 VIDEO.md

先讀取 VIDEO.md 和用戶指定的上游來源。來源是小說、章節或其他長文本敘事時,先讀取 references/ADAPTATION.md。只提取當前影片真正需要的事實、人物關係、情節、場景、產品或限制;保留 pointer,不把完整上游內容複製到影片腳本層。

若來源之間存在衝突或關鍵事實缺失,先明確缺口;不要為了讓影片腳本完整而自行補造上游事實。

2. 建立最小影片腳本層

四個常用腳本檔案的職責按 references/SCRIPT-FILES.md 保持分離,避免把視覺設計、攝影和生成參數複製回腳本層;真正落檔案時可按 references/SCRIPT-TEMPLATES.md 的最小模板寫,只創建當前項目需要的檔案。

只創建當前項目需要的檔案:

  • SCRIPT.md:當前影片的故事、結構、場次、動作和對白;
  • CHARACTERS.md:當前影片中角色的表演、造型、對白和聲音要求;
  • SCENES.md:當前影片使用的場景、空間、世界表現和連續性重點;
  • SHOTS.md:整片鏡頭總覽。

簡單產品鏡頭、無人物影片或已有完整腳本的項目可以缺少其中任意檔案。不要為了模板完整創建空檔案。

3. 劇情與人物

當前影片包含完整劇情、人物弧光、對白或喜劇包袱時,先讀取 references/NARRATIVE.md。人物情緒變化、重要反應或關係衝突需要真正落到鏡頭表演時,再讀取 references/PERFORMANCE.md,把情緒詞轉換成可觀察的身體、視線、動作與行為節拍。下面只保留所有劇情項目都需要的最小規則。

有劇情時優先保證因果鏈和人物行為成立,再追求視覺奇觀:

  • 事件由既有條件、人物選擇或前一事件推動;
  • 角色只基於當前已知資訊行動和說話;
  • 重要轉折來自人物選擇或已經建立的規則;
  • 結尾需要回收的動作、資訊或視覺元素應在前文真實建立;
  • 產品或道具不能憑空解決此前沒有出現的問題。

人物定義不只寫性格標籤。當前影片真正需要時記錄目標、擔憂、典型行動方式、緊張時的反應、對白節奏、聲音特徵、允許的情緒範圍和本片變化。角色需要跨鏡頭保持聲音身份時,把詳細音色與聲音參考交給 video-audio,不在腳本層複製第二套聲音規範。

4. 對白

鏡頭包含可見說話人物、長對白、多角色對話或同步口型時,讀取 references/DIALOGUE-TIMING.md,先確認台詞能在目標時長內自然說完,再進入鏡頭生成。

對白服務角色當下行為,不負責替作者解釋世界觀。旁白 / 畫外音同樣屬於腳本內容,但只有真正需要敘述視角、時間壓縮或畫面難以自然表達的資訊時才使用;聲音製作按需交給 video-audio,不把旁白當修補不清楚劇情的萬能解釋層。優先讓上一句、上一動作或新資訊自然引出下一句;能用動作表達的資訊不要重複用對白說明。

完成對白後按連續時間順序快速複核整段對話,檢查突然換話題、重複解釋、情緒無過渡、所有角色同一種句式等問題。自然對白不等於強行加入網路俚語。

VIDEO.md 有明確總時長 / 嚴格上限時,讀取 references/DURATION-BUDGET.md,先按故事段落與 SHOTS.md 做粗時長預算,避免生成完成後才發現整片長度失控。

5. 場景與鏡頭總覽

SCENES.md 只記錄當前影片需要的空間、視覺和世界規則。複雜機械、陌生裝置或關鍵空間關係可以把詳細說明放到對應複用素材旁的說明檔案,不把所有低頻規則堆進 SCENES.md。

SHOTS.md 用於從頭到尾快速閱讀整片鏡頭安排。每條至少包含鏡頭 ID、目標時長、畫面/動作和鏡頭目的;詳細生產要求交給 video-shot 的 SHOT.md。

長項目只有在現有鏡頭表已經難以閱讀時才增加章節或更高一級組織,不預設電影級層級。

完成標準

影片腳本層足以讓下一步明確知道:這支影片講什麼、當前角色如何表演、場景怎樣呈現、需要哪些鏡頭;同時沒有把上游來源複製成第二份事實庫。

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

相關技能