Communitygithub.com

story-to-storyboard

繪本分鏡生成技能。接收用戶提供的繪本主題,或主題缺失時按預留來源提供候選主題供用戶選定,輸出結構化繪本分鏡圖文包。

story-to-storyboard 是什麼?

此技能為繪本分鏡生成助手,專為低幼繪本與兒童英語啟蒙類短視頻設計。它接收用戶提供的繪本主題(如情節主題或簡單主題),或在使用者授權下從預設來源推薦候選主題。輸出為結構化的 Markdown 檔案,每組分鏡固定六行:英文短句、中文翻譯、蠟筆彩鉛風格的繪圖提示詞(含固定負面詞串)、圖生影片提示詞(含固定負面詞串)、四項關鍵詞(色彩/大小/動作/地點),以及符合火山引擎 seed-audio-1.0 格式的配音提示詞。預設不生成實際圖像與音訊,專注於分鏡規劃與參數生產。支援 Claude Code、Cursor、Codex 等 AI 代理平台,透過嚴格的執行順序(故事→繪圖提示詞→影片提示詞→配音提示詞)與驗證腳本確保格式一致性。它不適用於純文字寫作、寫實攝影或既有影片剪輯,且當主題缺失且無候選結果時會終止執行,不會自行杜撰主題。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LuckClover445/VideoSkills/tree/HEAD/story-to-storyboard

在你喜歡的 AI 中提問

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

說明文件

繪本分鏡生成

本文件僅規定編排層:入口、交付結構、執行順序與校驗。故事創作、繪圖提示詞、影片提示詞各自的具體規則與模板原文,全部位於下列文件,本文件不承載其內容,亦不複述。

檔案負責內容
references/story.md故事環節的全部規則與執行步驟,由該文件自行規定
references/creativity-path.md可選創意路徑(預設關閉):接口契約與可替換的取值來源
references/drawing-prompt.md繪圖提示詞環節的規則,含模板原文與繪圖負面串(全技能唯一副本)
references/video-prompt.md影片提示詞環節的規則,含影片負面串與成品句式(全技能唯一副本)
references/voice-prompt.md配音提示詞環節的規則,含配音負面串、成品句式與三平台欄位映射(全技能唯一副本)
references/mcp-setup.md繪圖提示詞最佳化的 MCP 配置指引,當前停用、不參與執行,僅在啟用該能力時讀取
references/example.md成品格式對照範例,供腳本回歸
scripts/pick_direction.py創意路徑所需的取值來源(可選)
scripts/check_storyboard_md.py以兩份模板原文逐字比對成品

前置條件

繪本主題由用戶提供,可為簡單主題(僅主體與場景)或情節主題(已含訴求與阻礙)。主題缺失時按 references/story.md 處理候選來源並由用戶選定;來源無結果時終止並索取主題,不得自行擬定,不得先行產出範例。

對外入口

觸發輸入交付內容
一個繪本主題(如「月亮與小星星」)一組繪本分鏡包,每組 6 行;組數預設值由 references/story.md 規定
未給出主題,且授權由技能選題若干條候選主題(主題名、一句話方向、主體、環境),不直接產出分鏡;選定後再按上一行交付

使用者單獨索要影片提示詞或圖生影片提示詞時,以單句說明該內容屬技能內部環節、不單獨交付,並請使用者提供繪本主題;主題提供後,影片提示詞寫入每組「→ 繪圖提示詞:」的下一行。不得為滿足此類請求反向推導分鏡。

交付結構(強制,不可改動)

每組嚴格 6 行,順序固定:

【第 X 鏡】
英文短句
→ 中文翻譯
→ 繪圖提示詞:<按 references/drawing-prompt.md 的模板原文逐字填充>。負面:<同文件的繪圖負面串>
→ 影片提示詞:<按 references/video-prompt.md 的成品句式,末尾自帶負面串>
→ 關鍵詞:【color / size / action verb / place】
→ 配音提示詞:<按 references/voice-prompt.md 的成品句式,末尾自帶配音負面串>

五項強制約束:

  • 英文短句獨佔第一行,不使用引號、括號註釋或鏡頭說明。
  • 繪圖負面串置於繪圖提示詞同一行末尾,以「負面:」引出;不換行,不在套末彙總。
  • 影片提示詞緊隨繪圖提示詞的下一行,壓縮為一段,不帶 ①②③ 標籤,不單獨成節。
  • 關鍵詞固定為第 5 行,四項順序不變,每項對應本鏡具體內容。
  • 配音提示詞固定為第 6 行即本組末行,朗讀文字須與第 1 行英文短句逐字一致,參數寫成可錄入音訊模型的欄位。

文件級註記一條:在第一個「【第 X 鏡】」之前寫一行朗讀預算(各組的影片秒數與預算秒數),供獨立的語音模型對齊;該行屬文件級註記,不插入任何組內,不改變每組的 6 行。

執行順序

  1. 按 references/story.md 完成故事環節,產出各組的英文短句與中文對譯。
  2. 按 references/drawing-prompt.md 完成繪圖提示詞環節,產出各組的繪圖提示詞行與關鍵詞行。繪圖最佳化當前關閉(見「外部能力:繪圖提示詞最佳化」),直接產出,不檢測、不呼叫。
  3. 按 references/video-prompt.md 完成影片提示詞環節,產出各組的影片提示詞行。
  4. 按 references/voice-prompt.md 完成配音提示詞環節,產出各組的配音提示詞行。
  5. 執行 python scripts/check_storyboard_md.py <成品.md> --theme "<主題>" 校驗,錯誤須修正至通過。配音由獨立語音模型後處理,不隨影片直出;若已取得實測朗讀秒數,以 --voice-seconds "1:3.8,2:4.2" 回填複校,超預算者先改短該句,不延長影片。

銜接要求:後一步以前一步的產物為依據;後續步驟與前一環節衝突時,回改前一環節,不得在後續步驟內強行自洽。腳本僅校驗格式與模板一致性,語義是否緊扣英文短句由各 reference 的內容自檢承擔。

外部能力:繪圖提示詞最佳化(可選)

目前狀態:停用。 prompt-optimizer 尚未完善,預設運行中不檢測、不詢問、不配置、不呼叫,也不讀取 references/mcp-setup.md;繪圖提示詞按 references/drawing-prompt.md 直接產出。以下各小節作為啟用時待用的規則保留,除用戶在對話中明確提出「啟用繪圖提示詞最佳化」,一律不執行。

啟用後,繪圖提示詞寫完後可交由該 MCP 對已填好四個槽位的成品文字做一次措辭級最佳化。該 MCP 是後處理環節,不承擔提示詞生成:先理解句意、白話定畫面、填槽位、拼模板、接負面串的既有邏輯原樣執行,MCP 只在其後改寫槽位內的文字。無論啟用與否,繪圖環節的產出方式不變,缺少它只是少一次潤色,不是少一條生成路徑。

該能力非必需,缺失或不可用時不阻斷交付,也不得為了使用它而拖延或放棄產出。啟用後,MCP 配置由當前 agent 在用戶確認後執行:定位配置檔案、備份、合併條目、校驗寫回,全部按 references/mcp-setup.md「由當前 agent 執行的配置步驟」進行。

呼叫契約(停用備查)

MCP 的輸入只有一樣東西:該組已經生成的繪圖提示詞。除此之外不攜帶任何上下文。

  • 輸入:該組繪圖提示詞的完整文字,從模板起點「【畫面比例】」起,到負面串結尾止。不加「→ 繪圖提示詞:」這類標籤,不加組號,不加任何前後綴說明。
  • 輸出:只採納三個槽位內的文字。模板固定句與負面串仍以本技能原文為準,不採納 MCP 回傳的版本。
  • 禁止攜帶:繪本主題、英文短句與中文對譯、關鍵詞行、影片與配音行、其他組的內容、故事卡、風格要求、對話歷史、技能規則。不得在提示詞前後附加「請先理解這個故事」「這是兒童繪本」之類的背景說明,也不得把多組提示詞合併成一次請求。
  • 一次一組:呼叫只處理當前這一組;上一組的回傳文字不得拼入下一組的輸入,避免跨組串味。
  • 必填欄位:若工具 schema 另有必填欄位,只填與「最佳化這段提示詞」直接相關的中性值(如語言、任務類型),不得藉該欄位補傳主題或故事內容。
  • 不做往返:一次呼叫一次採納,不追加追問、不做多輪澄清;返回不可用即按「最佳化結果約束」回退。

執行前檢測(停用備查,啟用後於流程開始前執行一次)

檢測在第 1 步之前完成,整輪只做一次,組內不再重複詢問。

取得 MCP 列表:讀取當前會話掛載的 MCP 服務與可用工具列表,確認是否存在 prompt-optimizer(http://47.251.140.61:8081/mcp)及其提供的工具。列表不可直接讀取時,以 prompt optimizer 為關鍵字檢索工具。判定以「服務存在且其工具可被呼叫」為準,不以對話裡出現過 URL 為準,不得憑猜測虛構工具名。

檢測結果處置
已掛載不詢問、不提示安裝,但須向用戶明示本輪將呼叫該 MCP 最佳化繪圖提示詞(一行狀態說明,不彈框),隨後直接按「呼叫契約」使用
未掛載以確認彈框詢問是否需要安裝,文案說明這是可選的繪圖提示詞二次最佳化能力、不安裝不影響分鏡產出。選項兩檔:立即配置、暫不配置
選擇立即配置讀 references/mcp-setup.md,由當前 agent 按其「由當前 agent 執行的配置步驟」完成配置:確認客戶端與設定檔位置、備份、合併條目、校驗 JSON;隨後重新讀取 MCP 列表複檢。複檢通過即向用戶明示「配置成功,後續將呼叫 prompt-optimizer 最佳化繪圖提示詞」,然後繼續第 1 步,並在第 2 步啟用最佳化
選擇暫不配置本輪不再提示,全程跳過最佳化,按原提示詞交付
  • 當前 agent 無寫權限、找不到設定檔,或客戶端要求重啟才能辨識:把該檔案的配置提示詞整段發給用戶,說明需其執行或重啟;本會話按未掛載繼續,不等待、不阻塞,交付說明中註明。
  • 拒絕只在本次會話內記憶,不寫入長期偏好、不改動技能檔案;下一輪執行時仍按本節重新檢測、重新詢問一次。
  • 彈框能力不可用時以一條短問句替代,問題與兩個選項不變。
  • 使用者選擇立即配置但直到第 2 步仍未生效(未裝成或未重啟),不二次彈框,按未掛載繼續,在交付說明中註明。

組內呼叫(停用備查,啟用後在每個繪圖行寫成後執行)

  • 每組繪圖行寫成後呼叫一次,傳參按「呼叫契約」。
  • 呼叫須可見:不得靜默呼叫。呼叫前輸出一行狀態,說明呼叫的對象與該組,例如「呼叫 prompt-optimizer MCP 最佳化第 3 組繪圖提示詞」;呼叫後輸出一行結果,說明是否採納(已採納 / 已回退,附一句原因)。
  • 呼叫成功:只提取三個槽位內的文字,按「最佳化結果約束」複核後寫回該組繪圖行;模板固定句與負面串仍以本技能原文為準。
  • 呼叫失敗、超時或傳回空:最多重試一次;仍失敗則跳過該組,標註「未最佳化(連線失敗)」,流程繼續。
  • 組內不再詢問用戶,不重複確認配置,也不因單組失敗回頭重跑前一組。

最佳化結果約束

  1. 只最佳化措辭,不重定畫面。 主體是誰、數量、姿態、朝向、互動關係、場景與光線均不得改變;允許的改動限於措辭、可見細節的精確度與語序。不得把槽位寫空、不得精簡掉已有資訊、不得擴寫成第二件事。
  2. 模板固定句逐字不變。 從「,兒童繪本插畫風格」至「柔和光影,無生硬陰影,低幼友好,畫面不帶內置文字、浮水印、簽名」的原文不得增刪改;僅三個槽位(畫面主體、主體互動關係、環境場景)內的文字允許被改寫。
  3. 負面串不變。 最佳化文字不包含「負面:」及其後內容,負面串仍由本技能在行末追加。
  4. 事實約束不變。 不得新增英文短句中不存在的角色、道具、場景;改寫後仍須能被該句反推。
  5. 腳本為準。 最佳化後的該組須重新通過 check_storyboard_md.py;不通過即回退為該組最佳化前原文,並記錄回退原因。
  6. 下游以定稿為準。 第 3 步影片提示詞、第 4 步配音提示詞均讀最佳化後的繪圖行;若最佳化改動了姿態或場景,須回頭重寫該組影片行,不得沿用最佳化前版本。

交付標註

停用時不作任何最佳化標註。啟用後,交付說明寫明哪些組經 MCP 最佳化、哪些組跳過及其原因(未配置、使用者拒絕、連線失敗)。兩種情況成品行內都不寫標記,不改動 6 行結構。

產物與載入約定

本技能的上下文開銷主要由兩件事決定:是否把整份 reference 反覆讀入,以及中間結果是否只存在於對話裡。兩條都須約束。

1. 產物約定

一個成品 Markdown 是貫穿全流程的唯一累積載體,各步驟只寫自己那一段,下游只讀產物,不複述上游內容。

步驟產物載體
1 故事故事卡:主體清單、環境、訴求、阻礙、解決、結局;每組一句英文與中文對譯成品檔案的組標題與前三行
2 繪圖每組繪圖提示詞行(含負面串)、關鍵詞行同一檔案,逐組追加
3 影片每組影片提示詞行(含負面串);文件頭的朗讀預算行同一檔案,插入該組繪圖行之後;預算行只在第 1 組之前寫一次
4 配音每組配音提示詞行(含負面串)同一檔案,追加於該組關鍵詞行之後
5 校驗腳本輸出命令回顯,不落盤
  • 逐組推進:完成一組再進入下一組,不得先把六組句子全部寫出再回頭補提示詞。
  • 中間內容寫入產物檔案或對話中的分組塊後,不再重述;回改時只改該段,不整份重寫。
  • 產物檔案預設置於與技能目錄同級的 output 目錄,即 <技能目錄>/../output/;命名為《主題》-分鏡與提示詞.md。目錄不存在時建立;使用者明確指定輸出路徑時,以使用者指定為準。

2. 載入約定

按步驟讀取所需片段,不整份載入;已讀內容不重複讀,模板原文只在書寫時引用,不在回覆中複述。

步驟必讀按需讀不讀
1 故事story.md 第二、五、六、七、八、九節第一節創意原則、第三節三問(自檢時);啟用創意路徑時改讀 creativity-path.md第十節刪除記錄;未啟用時的 creativity-path.md
2 繪圖drawing-prompt.md 的模板原文、繪圖負面串、槽位對照、拼行規則出圖順序(僅使用者要求出圖時);崩壞修法(僅返工時)來源說明段;mcp-setup.md(最佳化停用時不讀)
3 影片video-prompt.md 的成品型態、語言時長與畫面餘量、兩步理解、五維細則動作詞表(只讀與主體類型匹配的一段);自檢表(首次使用或不合格時)範例 A/B(格式已掌握後)
4 配音voice-prompt.md 的成品型態、參數口徑、四要素寫法平台欄位映射(換平台時);自檢表(首次使用或不合格時)範例(格式已掌握後)
5 校驗校驗命令example.md(僅格式回歸時,且只對照句式)其餘全部
  • example.md 預設不讀;格式已由本文件的交付結構定義,無需藉範例確認排版。
  • 六組共用一個模板與一套負面串,只需讀取一次;寫第 2 至 6 組時不得再次載入同一檔案。
  • 若上下文不足以容納全部產物,以產物檔案為準,按其內容續寫,不重新生成已完成的組。

引用紀律

  • 模板原文、繪圖負面串、影片負面串、配音負面串各僅有單一副本,位於對應 reference 檔案;出現於其他檔案時視為錯誤。
  • 填充時整段複製後取代槽位,不得重組句式,不得省略分號分隔的任何固定短句。
  • 模板固定句與既定口徑衝突時,以模板為準;需調整口徑時修改模板檔案本身,並同步執行校驗。
  • 配音的音色、音高、音量在六組間保持一致,僅情緒與重音隨句變化;換用其他音訊平台時按 voice-prompt.md 的映射表折算,不改變欄位語義。

交付方式

  • 於對話中直接輸出完整內容(組數按 references/story.md,每組 6 行),不提供摘要替代。
  • 使用者要求檔案時,預設將 Markdown 寫入與技能目錄同級的 output 目錄,命名為《主題》-分鏡與提示詞.md,並執行校驗腳本;使用者明確指定路徑時除外。

相關技能