Communitygithub.com

視覺敘事

用於向他人展示複雜事物的視覺敘事:一個包含場景、攝影機與字幕的大型動畫解說影片;一個流程或系統的互動式地圖;一個附帶微動畫、轉場效果及靜態PDF的提案簡報;它們的手機版本、精確到幀的MP4匯出、發佈到子網域以及QR碼。當使用者要求動態解說、流程動畫導覽、「將我們的系統運作方式做成動畫」、可縮放互動系統地圖、含轉場與PDF的提案簡報、「將此動畫製作成影片」或「讓它在手機上運作」時使用——即使使用者沒有明確說出「動畫」或「簡報」。請勿用於沒有場景或攝影機的純投影片、單一靜態圖表、登陸頁面與銷售提案,或AI生成的影片。

視覺敘事 是什麼?

此技能「視覺敘事」專業於建立複雜流程、系統或故事的動態視覺說明與互動式展示,而非靜態裝飾。它提供了一套完整的工作流程,涵蓋多種格式:動畫解說影片(在一個大型畫布上使用場景、攝影機與字幕)、可瀏覽的互動式系統地圖,以及附帶精細動畫與轉場效果的提案簡報(同時可匯出PDF)。該技能整合了多個參考手冊,引導從腳本撰寫、試作製作、批次開發到最終品質保證的完整流程,並支援發佈到子網域、為手機與平板調整響應式設計、以及精確到幀的MP4匯出。此技能可與Claude Code、Cursor等AI編碼代理搭配使用,但由於其工作流程高度依賴視覺檢查與使用者回饋的迭代,在能夠生成圖形使用者介面(如自訂HTML/CSS畫布)或控制瀏覽器的環境中表現最佳。其核心方法論強調:先建立一個完整的試作來確定風格,然後以2–3個場景或投影片為一批次進行開發,並在每個批次結束時展示給使用者確認,以避免大規模重工。此技能專為需要向利害關係人、客戶或團隊清楚說明複雜邏輯或系統的開發者、設計師與產品經理設計。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/smixs/visual-story/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

視覺敘事 是做什麼的?

將複雜的事物以影像方式呈現:一幕接著一幕,大尺寸,用動畫來解釋而非裝飾。字幕說明正在發生的事;畫布則展示它。每一批工作結束時,都必須向使用者展示一個畫面,並獲得他們的「好」。

你正在製作什麼 → 打開哪本手冊

任務手冊
解說影片:同一畫布上的場景、攝影機、字幕、「全方案」地圖references/motion-film.md
節點之間可跳轉的流程或系統互動式地圖references/scheme.md
附有微動畫、轉場與PDF的提案簡報references/deck.md
沒有場景或攝影機的一般研討會演講使用一般投影片工作流程;借用 deck.md 的可讀性規則
將影片或地圖匯出為MP4references/video-export.md
手機與平板版本references/responsive.md
發佈、子網域、密碼、QR碼references/publish.md
用肉眼檢查:透過URL檢視畫面、聯絡表、檢查清單references/qa.md
品味規則:色彩、字體、動態、密度references/taste.md
可用來複製骨架的參考作品references/examples.md

在撰寫第一行程式碼之前,先開啟 taste.md、examples.md 和對應的手冊。在第一次展示之前,先開啟 qa.md。

是影片還是地圖?一部影片是一個隨著時間展開的故事,由一位講者帶領觀眾一幕一幕地前進。一個地圖是一張由觀眾自行探索的大圖。「為一場網路研討會將我們的流程做成動畫」是影片;「一個可以四處查看的系統地圖」是地圖。如果不確定,問一個問題。

每種類型的工作順序

  1. 以使用者的話語描述目標,然後提問。 一次問完,先提供推薦選項,且只問尚未回答的部分:要參考哪一份(「像上次一樣」)、展示方式(講者點擊 / 自動播放 / 影片 / PDF)、風格(產品的網站)、語言、資料(虛構或使用者的來源)、截止日期與螢幕尺寸。
  2. 將腳本做成表格 —— 場景或投影片:編號、標題、一行意義說明。等待「好」。
  3. 試作。 一個場景或一到兩張投影片,完整完成:影像、動畫、字幕。畫面 → 展示 → 等待「好」。原因:在試作中確立的風格會延續到所有後續內容;如果等到第十二個場景才發現風格問題,就必須重做十二個場景。
  4. 以 2–3 個場景或投影片為一批次;展示每一批並等待回覆。
  5. 組裝完整成品: 導航、完整方案地圖或總覽、手機版面配置、發佈、QR碼、PDF或影片——無論訂單要求什麼。

截止日期在一天內: 一個試作與一次「好」,其餘全部一次批次完成;僅在最終展示尺寸(廣播螢幕,以及如果觀眾會收到連結的話,加上手機尺寸)下檢查畫面。

在說「完成」之前

  • 已從 qa.md 中指定的展示尺寸拍攝並檢視畫面;缺陷已一次批次修正。
  • 如果已訂購發佈:線上網址已提供新版本(加上 ?v=NN),且 zbarimg 能讀取QR碼。
  • 如果已訂購PDF或影片:檔案已開啟並逐頁或逐幀檢視。
  • 使用者已看過最終結果並回覆。
  • 你自己的螢幕截圖、瀏覽器工作階段與伺服器程序已清理乾淨(透過程序pid停止伺服器)。

常見錯誤

  • 一次完成全部並在最後才展示 → 使用者改變風格,你必須重做全部。請分批進行。
  • 做得太小:在畫布上放了十個小標籤,而不是一個大概念。影像要大,程式碼要小。
  • 用文字來規避:在QR碼下方寫「請用手機掃描」、「持續成長中」、「你可以…」、手勢提示。凡是無需文字就能清楚表達的,就保持無文字。
  • 裝飾:卡片邊緣的彩色強調條、閃爍、「只是好看」。動畫要嘛解釋轉場,要嘛不存在。
  • 沒有名詞的數字和時間點(「8張卡片」)→ 觀眾不知道自己在看什麼。
  • 只「靠讀程式碼」檢查,沒有在正確尺寸下檢視畫面 → 在手機上一切會崩潰。

相關技能