Communitygithub.com

捲動敘事

用於當網站、登陸頁面、產品頁面、作品集或案例研究應透過滾動講述故事,而非列出區塊——適用於滾動敘事、說故事頁面、「敘事」或「電影感」網站、基於章節的頁面、時間軸、旅程、前後對比,或當頁面感覺像是無聊的區塊目錄時。

捲動敘事 是什麼?

此技能引導開發者將網站或頁面轉化為沉浸式的滾動敘事體驗。它提供了一套完整的框架,從前期故事構思(英雄、慾望、障礙、轉折、結局)和選擇敘事裝置(時間軸、路徑、縮放等),到撰寫節拍表(beats.md)和遵循特定的節奏規則。該技能強調每個滾動區塊只傳達一個想法、一個視覺和一個動作,並透過釘選場景和進度儀表來控制敘事節奏,確保文字與其所描述的時刻同步出現。此外,它要求內容在無JavaScript和減少動畫模式下仍能正常閱讀,並對行動端進行了專門優化(較短的釘選、堆疊舞台、較大字體)。最後,它依賴於 `storymotion.css` 和 `storymotion.js` 等特定工具來實現釘選場景、字幕顯示和進度條等功能,並提供了一個詳細的完成檢查清單。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

在你喜歡的 AI 中提問

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

說明文件

捲動敘事 是做什麼的?

並非每個網站都需要一個故事。 先決定:一個完整的敘事(品牌、小型企業、旅遊、地點、工藝、能展現具體成果的服務)、一個單一故事場景(SaaS、應用程式:通常是「運作方式」)、或不需要(商店、文件、儀表板、表單:僅在回饋時使用動畫,請使用 web-motion)。對於部分敘事,僅對該場景應用此技能。

一個敘事型網站是訪客透過滾輪走過的故事。 事實被編織進情節中,而不是堆疊成功能區塊。動畫(參見 web-motion 技能)是這個故事中時間流逝的方式。

1. 在任何程式碼之前先找到故事

用一行回答每個問題:

  • 英雄 — 我們跟隨誰或什麼(訪客、產品、地方、菜餚、一天)。
  • 慾望 — 他們想要什麼或他們去哪裡。
  • 障礙 — 阻礙前進的是什麼(產品解決的問題)。
  • 轉折 — 事情改變的時刻(產品、頂點、第一口)。
  • 結局 — 轉折後的世界,以及訪客現在採取的一個行動。

然後選擇一個敘事裝置來構建整個滾動:

裝置滾動意味著適合用於
時間軸黎明 → 夜晚、1920 → 今天、第1天 → 第30天餐廳、活動、歷史、日常
路徑沿著路線或地圖移動旅遊、物流、探險、房地產
縮放城市 → 街道 → 房間 → 細節建築、產品、工藝
轉變原料 → 成品、之前 → 之後服務、翻新、SaaS、健身
倒數朝向發布或巔峰時刻節慶、限量發售、產品發布
角色跟隨一個人的一天應用程式、B2C服務

2. 撰寫節拍表

在開始建構之前,儲存為 beats.md。每個節拍一行:

#節拍標題(≤ 8 字)內文(≤ 40 字)編織進的事實視覺動畫滾動長度

標準弧線(6–9 個節拍):

  1. 鉤子 — 第一個畫面。在 3 秒內:這是什麼、關鍵數字、主要動作。不要只寫「向下滾動發現」而沒有其他內容。
  2. 鋪陳 — 轉折前的世界;英雄和慾望。
  3. 旅程(2–4 個節拍)— 透過裝置前進;每個節拍攜帶一個事實作為情節點(「到了早上6點,麵包已經出爐——140 條」)。
  4. 轉折 — 最大的場景:通常是一個釘選舞台(200–300 vh),透過滾動來控制。
  5. 證明 — 數字、面孔、評論,作為故事的結果來呈現。
  6. 結局 + 行動呼籲 — 故事的落點,以及一個明確的行動。重複鉤子的動作。

3. 節奏規則

  • 每個節拍一個想法、一個視覺、一個動畫。
  • 交錯安排密集和稀疏的內容:在釘選場景之後,安排一個寧靜的全版照片或一個句子。
  • 每頁最多約 3 個釘選場景;每個釘選必須配得上它的滾動長度。
  • 總頁面長度:桌面版 6–12 個視窗高度。只有在每個畫面仍有新資訊時才更長。
  • 文字與其所描述的時刻同時出現,絕不提前。
  • 訪客始終知道他們在哪裡:章節標籤 + 進度儀表。
  • 滾動本身講述故事:進度儀表使用其敘事裝置作為隱喻(小時、公里、比例尺、年份、章節編號),並採用網站的色板和字體;章節標記在上面,懸停時顯示名稱。

4. 內容與工藝

  • 照片是主角:僅使用高解析度,在 100% 裁剪下清晰銳利;使用響應式 srcset。
  • 像人一樣寫作,用簡單的詞彙;不要使用「釋放」、「提升」、「無縫」。
  • 數字是情節點,而不是統計網格——除非該網格是高潮。
  • 每個節拍必須在減少動畫和無 JS 的情況下也能存活:它仍然作為一個好的長頁面被閱讀。
  • 行動版不是桌面版的縮小版:較短的釘選(150–200 vh)、堆疊舞台、較大字體。

5. 建構

  1. 基於 storymotion.css + storymotion.js(位於 web-motion/assets/;包含釘選場景 --p、步驟標題、揭示、計數動畫、章節標籤、可拖曳滾動儀表、載入器、語言、減少動畫)以及 web-motion/references/recipes.md 中的配方來建構。
  2. 將每個節拍映射到一個區段;釘選的節拍變成帶有 [data-step] 標題的 .scene > .stage;自訂的逐幀邏輯監聽場景的 progress 事件。
  3. 按照 web-motion 添加動畫;在 375 px 和 1440 px 下驗證,並分別開啟和關閉減少動畫模式。

完成前檢查清單:

  • 鉤子通過 3 秒測試。
  • 每個節拍只有一個任務和一個事實。
  • 故事在禁用 JS 時能按順序閱讀。
  • 章節標籤和儀表符合節拍表。
  • 結尾的行動呼籲重複鉤子的動作。

相關技能