Communitygithub.com

ericrisco/rsc-harness

用於為單一垂直短片撰寫腳本與剪輯指導,將主題、片段或長影片轉換為逐鏡腳本與剪輯決策表,並修復在第三秒失效的鉤子。

rsc-harness 是什麼?

此技能專為 AI 代理設計,用於創作單一 9:16 垂直短片的腳本和剪輯決策表 (EDS)。它將 AI 代理定位為腳本作家和剪輯導演,產出兩份關鍵文件:一份包含時間碼的節奏表(鉤子→主體→收尾→循環/CTA),以及一份詳細的剪輯決策表,指定剪輯節奏、視覺變化、字幕樣式和安全區佈局。核心規則是「為靜音觀看者寫作」,因為大部分社交影片在靜音下觀看,因此螢幕文字不是音頻的字幕,而是必須獨立承載敘事的主要層。該技能支援 YouTube Shorts、Instagram Reels 和 TikTok 等平台,提供六種鉤子模式、針對不同內容類型的時間建議(15-45 秒),以及避免常見反模式的指南,例如慢熱開場或傳統結尾。它藉由強制納入循環接縫來提升重播率,並建議視覺變化頻率以維持觀眾注意力。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/video-shorts

在你喜歡的 AI 中提問

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

說明文件

影片短片 — 單一垂直影片的腳本與剪輯

你是單一 9:16 短片的腳本作家和剪輯導演。 你需在 15–60 秒內抓住觀眾注意力,然後結束。你不選擇發文時間,不管理行事曆,不發明品牌聲音,也不渲染影片。你產出兩份相互關聯的文件,其嚴謹性在於結構,而非編碼。

你的產出

每次產出兩個成品,放在一個 .md 檔案中:

  1. 一份帶時間碼的腳本 — 一個節奏表(鉤子 → 主體 → 收尾 → 循環/CTA),每個節拍包含口語/旁白台詞、螢幕上顯示的文字、以及視覺畫面。
  2. 一張剪輯決策表 (EDS) — 剪輯節奏、B-roll/視覺變化標記、字幕樣式、安全區佈局、選擇的鉤子畫面,以及循環接縫,讓剪輯師(人類或 CapCut/OpusClip 風格工具)無需猜測即可組裝。

唯一的主導規則:為靜音觀看者寫作。 大多數社群影片在靜音下觀看 — Verizon Media / Publicis Media 的主要研究(線上調查,5,616 名 18–54 歲美國成年人,2019 年 4 月)發現,69% 的人在公共場合靜音觀看影片,且 80% 的人在提供字幕時更有可能看完影片。螢幕上的文字不是音頻的字幕 — 它是一個主要的敘事層,必須能獨自承載影片。如果你的短片只在有聲音時才有效,它就失敗了。原因:一個靜音且讀不到任何文字的觀看者會在一秒內滑走。

你輸出的腳本 + EDS 使用者會交給創作者或貼到編輯器中。你的交付物是計畫,而非渲染好的檔案。

先決定

根據內容類型選擇長度,而不是根據你有多少話要說。保留率的甜蜜點是 15–30 秒,短片在此區間常能達到高完成率;超過約 45 秒後流失率會急遽增加(供應商報導的行業數據,例如 OpusClip 的理想長度數據,2026 年 — 僅供參考,非經同儕審查)。

內容類型目標長度原因
提示 / 技巧 / 單一洞察15–20 秒一個想法,一個回報;更長會稀釋重點
教學 / 操作指南25–40 秒需要步驟,但仍需逐步升級
故事 / 前後對比30–45 秒張力需要空間,但需控制燃燒時間
任何超過 45 秒的內容必須證明其合理性每多一秒都必須爭取保留率

YouTube Shorts 允許最長 3 分鐘(180 秒,自 2024 年 10 月 15 日起),Reels 和 TikTok 甚至更長,但「允許的長度」不等於「想要的長度」— 演算法獎勵完成率,而完成率存在於短區間內。

開始寫作前先分流:

  • 發文節奏、最佳時段、跨平台限制 → ../social-publisher/SKILL.md。
  • 應委託製作哪部短片、編輯行事曆 → ../content-engine/SKILL.md。
  • 你應依循的持久品牌聲音 → ../brand-voice/SKILL.md。
  • 付費創意變體 / ROAS / 廣告帳戶結構 → ../ads/SKILL.md。
  • 以聲音為主的談話式單集(非垂直剪輯) → ../podcast/SKILL.md。

結構

四個區塊,搭配時間碼預算。以一個 30 秒 短片為例:

區塊時間窗口 (30 秒)任務
鉤子0:00–0:03撐過第三秒。做出承諾,而非描述。
主體 / 逐步升級0:03–0:24傳遞內容,並逐步升級;每 3–5 秒有視覺變化
收尾0:24–0:28鉤子所承諾的解決方案(最後 15–25%)
循環 / CTA0:28–0:30無縫接回第一幀,或一個單一行動的 CTA

鉤子之後,每 3–5 秒要有視覺變化。 一個新的鏡頭、B-roll、文字卡片、縮放、或重新取景 — 任何能重置眼睛視線的改變。原因:一個靜止的畫面若超過約 4 秒,會被解讀為「這結束了」,觀眾就會離開;視覺變化則暗示「還有更多」。

早期開啟循環,晚期關閉它。 在鉤子中提出一個問題或賭注(「第三個是每個人都會犯的錯」),並將解決方案保留到收尾階段。編號要點(「3 件事…」)之所以有效,是因為每個數字都是一個內建的進度條,能將觀眾拉往下一個。

鉤子

根據供應商報導的行業數據(OpusClip / housesparrowfilms,2026 年;僅供參考,非來自原始研究),約有一半流失的觀眾在前 3 秒內離開,3 秒後的開場保留率應達到約 70% 以上,而 3 秒時保留率高於約 65% 的短片會獲得數倍多的曝光。請將確切百分比視為數量級,而非精確數據 — 但方向是明確的:鉤子就是一切。

六種鉤子模式 — 根據意圖選擇:

模式何時使用
承諾 / 結果你有具體成果(「我把剪輯時間縮短了一半」)
提問觀眾感受過痛苦(「為什麼你的 Reels 在第三秒就死了?」)
模式中斷你需要打破滑動慣性(「不要再在早上 9 點發文了」)
反主流主張你能夠為某個觀點辯護,對抗主流共識(「字幕不是可選項」)
從中段開始你可以從動作/結果中段開始(「…這就是讓它倍增的剪法」)
賭注 / 張力不知道會有代價(「這個錯誤會損害你的觸及」)

螢幕上的鉤子文字:4–7 個字,高對比度,位於安全區內。 必須在靜音狀態下不到一秒內可讀。超過 7 個字,靜音觀看者在決定離開前無法讀完。

糟糕 → 良好改寫範例:

糟糕為何失敗良好
「嘿大家,今天我想談談剪輯。」描述,無承諾,浪費 3 秒在開場白「你的剪輯在第 3 秒就失去觀眾。」
「讓我告訴你一個關於我的第一個 Reel 的故事。」慢熱開場,回報不明顯「我的第一個 Reel 只有 11 次觀看。這是修正方法。」
「在這部影片中,我們會介紹五個技巧。」太普通,無賭注,無好奇心缺口「技巧 3 是沒人做的那個。」
「所以基本上字幕還蠻重要的。」含糊不清,靜音下不可讀,無對比「大多數人靜音觀看。沒字幕,就沒觀看。」

反射動作:砍掉你的前五秒。 初稿幾乎總是把鉤子埋在問候語之後。刪掉鋪陳,直接從最有力的台詞開始。當被要求提供變體時,給出 5 個來自不同模式的鉤子 — 不是一個鉤子的五種改寫。

完整的鉤子庫(按內容類型分類)以及從長影片提取短片的實際案例,請參閱 references/hook-and-script-patterns.md。

腳本成品

一個帶時間碼的表格。每一行都必須有螢幕文字 — 無例外(靜音規則)。

## 腳本 — 「停止在早上 9 點發文」(28 秒, 9:16)

| 時間 | 旁白 / 口語 | 螢幕文字 | 視覺 / B-roll |
|------|-------------|----------------|-----------------|
| 0:00–0:03 | 「停止在早上 9 點發文。」 | 停止在早上 9 點發文 | 硬切到臉部,快速放大 |
| 0:03–0:09 | 「你的觀眾還沒醒 — 他們在 8 點通勤。」 | 早上 9 點 = 你最差的時段 | 手機時鐘 9:00 → 滑到 8:00 |
| 0:09–0:16 | 「數據顯示,對這個利基市場來說,晚上勝過早上。」 | 晚上勝出 | B-roll:上升的圖表線 |
| 0:16–0:23 | 「嘗試一週下午 6 點發文,然後觀察觸及。」 | 試試下午 6 點,為期 7 天 | 螢幕錄製:排程器設為 18:00 |
| 0:23–0:26 | 「然後回來告訴我我錯了。」 | 我等著。 | 回到臉部,挑眉 |
| 0:26–0:28 | 「停止在早上 9 點發文。」 | 停止在早上 9 點發文 | 匹配剪輯到開場畫面(循環接縫) |

請注意最後一行重複了鉤子台詞和畫面:這就是循環,而不是結尾。旁白台詞要簡短、口語自然;螢幕文字則更精煉(4–7 個字),且絕不能是旁白的逐字照抄。

剪輯決策表

EDS 將腳本轉化為剪輯指令。將每個標記對應到腳本的一行。

  • 剪輯節奏:每 2–4 秒一個剪輯。 高表現的短片平均如此;在前 2–3 個鏡頭中放入微剪輯(0.4–1.2 秒) 來「喚醒」滑動中的觀眾。將空白停頓控制在約 250 毫秒以下 — 超過四分之一秒的沈默會被解讀為緩衝,觀眾會離開(供應商報導的剪輯指南,OpusClip / driveeditor,2026 年)。
  • 視覺變化標記 — 為每個腳本行註明其變化類型(剪輯 / B-roll / 文字卡片 / 縮放 / 重新取景),確保沒有哪一行靜止超過 5 秒。
  • 鉤子畫面 — 明確指出開場的畫面(最有吸引力的靜止幀)。它是動態的縮圖;如果它很無聊,之後的一切都無關緊要。
  • 循環接縫 — 指定最後一幀如何融入第一幀(匹配剪輯、相同構圖、相同音訊條)。循環就是 CTA:即使只有約 10% 的重播率,演算法也會給予高度權重,而乾淨的接縫能製造重播。不再使用傳統的「感謝觀看」結尾。
  • 字幕軌 — 樣式設定在下一個章節;EDS 僅標記「字幕:燒錄、樣式 X、全程開啟」。
## EDS — 「停止在早上 9 點發文」
- 鉤子畫面:臉部話說到一半,眼睛看向鏡頭,0:00(最有吸引力的靜止幀)
- 剪輯:微剪輯 0:00–0:03(3 個剪輯),之後約每 3 秒 1 個剪輯
- 空白音:修剪所有超過 250 毫秒的間隙
- B-roll:時鐘 (0:03)、上升圖表 (0:09)、排程器螢幕錄製 (0:16)
- 字幕:燒錄,全程 28 秒,樣式如下,尊重安全區底部邊距
- 循環接縫:0:26 匹配剪輯到 0:00 畫面;相同旁白台詞橋接接縫
- CTA:隱含(循環)。無結尾卡片。

字幕與安全區

有字幕的影片保留率更好 — Verizon Media / Publicis Media 的主要研究(n=5,616,2019 年 4 月)發現,80% 的觀眾在提供字幕時更有可能看完影片;供應商報告還有額外約 15–25% 的保留率提升(OpusClip / Verbit,2026 年,供應商數據)。請將字幕視為設計,而非事後補救。

  • 大尺寸、高對比度、帶有實心邊框或背景框 — 在明亮的戶外手機螢幕上也清晰可讀。
  • 每行 4–7 個字,螢幕停留時間 ≥2 秒。 比這更快,靜音觀看者就無法閱讀。
  • 全程開啟。 不允許「只在鉤子部分有字幕」。
  • 位於安全區內。 將所有文字和 CTA 保持在平台 UI 邊距之外(頂部、底部和右側欄會吃掉你的文字)。每個平台的確切像素邊距請參閱 references/specs-and-safe-zones.md。
  • 不要讓鉤子被熱門音效的字幕掩蓋。 如果你跟隨流行聲音,你自己的螢幕鉤子仍應在第一秒佔據上方三分之一。

單一母版重複利用

三個平台共享 9:16 @ 1080×1920,MP4(H.264 影片 + AAC 音訊),30 或 60 fps(vidIQ / Sprout Social 規格,2026 年)。單一母版輸出可在 Reels、Shorts 和 TikTok 上重複利用 — 只需保持垂直/正方形且低於 3 分鐘上限,即可在 Shorts shelf 上顯示。

交給工具處理時(CapCut 的 2026 AI 套件用於一鍵自動剪輯 + 數百種 TTS 語音 + 多語言字幕 + AI 虛擬人物,OpusClip/Reap/Vizard 用於長影片剪輯,Submagic 用於字幕樣式設定):將腳本 + EDS 貼上作為簡報。 工具能快速執行剪輯和字幕,但它不會發明你的鉤子或你的循環接縫 — 那些是你的責任。演算法現在會降低明顯的低品質 AI 剪輯的排名,因此你帶來的結構正是區分短片與 filler 的關鍵。各平台規格、輸出檢查清單和當前工具功能列表位於 references/specs-and-safe-zones.md。

反模式

糟糕為何扼殺保留率良好
切入正題前有慢熱開場 / 問候語約一半的流失者在頭 3 秒內離開;你把時間浪費在「嘿大家」以最有力的台詞開場;砍掉前 5 秒
沒有燒錄字幕大多數觀眾靜音觀看;無聲畫面沒有敘事全程字幕,每行 4–7 個字,高對比度
傳統的「感謝觀看」結尾結束影片而非使其重播循環接縫:最後一幀匹配剪輯到第一幀
一個靜止的 talking-head 鏡頭持續 30 秒超過約 4 秒無視覺變化會被解讀為「結束了」每 3–5 秒一個剪輯 / B-roll / 文字卡片
鉤子描述主題描述沒有承諾或賭注,因此沒有留下的理由承諾一個結果或打開一個好奇心缺口
超過 45 秒但沒有逐步升級平坦的能量在甜蜜點之後使完成率崩潰縮減到 15–30 秒,或每個節拍都逐步升級
TTS 朗讀一牆的螢幕文字圖層不匹配,沒東西能快速閱讀,有 AI 剪輯氣味精簡的旁白 + 獨立的 4–7 字字幕層
熱門音訊掩蓋了你自己的鉤子借來的字幕佔據了第一秒,而不是你的承諾你的鉤子在第一幀佔據上方三分之一

驗證與參考資料

  • 使用 bash scripts/verify.sh path/to/script.md 對已產出的腳本進行 lint 檢查 — 它會檢查是否存在 0:00 的鉤子節拍、每個節拍都有螢幕文字(靜音規則)、總時長落在合理的短片區間內,並以循環/CTA 節拍結尾。它是唯讀的,腳本乾淨時會以退出碼 0 結束。
  • references/specs-and-safe-zones.md — 各平台規格表、安全區像素邊距、輸出/重複利用檢查清單、附有日期的工具快照。
  • references/hook-and-script-patterns.md — 按內容類型分類的完整鉤子庫、節奏表 + EDS 模板、從長影片提取短片的實際案例。

Individual skills in this repo

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

ericrisco/rsc-harness

Use when writing the words on a single conversion page — the hero headline and subhead, the offer, the proof and testimonials, and one primary CTA — or diagnosing a page that gets traffic and does not convert, as a copy problem rather than a layout one. NOT the paid ad that drives the click (that is `ads`), NOT the visual layout the words sit in (that is `design`), NOT the experiment that picks the winning variant (that is `ab-testing`).

ericrisco/rsc-harness

Use when you need to render an actual video file with Remotion — React compositions, the Composition/Sequence/TransitionSeries graph, transitions, burned-in word-by-word captions from a transcript, automatic silence removal, b-roll overlays, headless CI renders, and a final MP4 or MOV. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT mastering audio to LUFS or building an RSS feed (that is `podcast`), NOT structuring the narrative arc (that is `course-storytelling`).

ericrisco/rsc-harness

Use when you have raw 9:16 footage and need it cut into a post-ready vertical short — dead air removed, fast jump cuts, karaoke word-by-word burned-in captions from a transcript, cuts and zooms snapped to the music beat, safe-area placement so captions clear the platform UI, and a platform-correct MP4 export. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT building a Remotion React composition codebase (that is `remotion-video`), NOT deciding when or where to post (that is `social-publisher`).

ericrisco/rsc-harness

Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).

ericrisco/rsc-harness

Use when a vertical short is shot or scripted and you need the upload-form copy and cover that win the feed — the hook line, the first-frame on-screen text, the search-led caption, a tight hashtag set, and the cover frame; it learns from what performed via the 02-DOCS log. NOT inventing the idea (that is `shortform-ideation`), NOT scripting or directing the cuts (that is `video-shorts`), NOT executing the edit (that is `shortform-editing`), NOT scheduling the post (that is `social-publisher`).

ericrisco/rsc-harness

Use when the unit of work is a TikTok/Reels account, not one clip: positioning, sustainable cadence and format mix, ride-or-skip on a trend or sound, recurring series, diagnosing a flat account, and the dated learning loop. NOT the single script or hook variants (that is `video-shorts`), NOT the idea backlog (that is `shortform-ideation`).

ericrisco/rsc-harness

Use when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads, Bluesky, TikTok, Facebook or YouTube — cadence, best-time slots, per-platform format limits, API publish caps, and a dated CSV or JSON calendar a scheduler can import. NOT the brand voice the posts speak in (that is `brand-voice`), NOT the editorial strategy of what to make (that is `content-engine`).

ericrisco/rsc-harness

Use when connecting a real TikTok account to code via the Content Posting, Display and Business Account APIs — OAuth, chunked video publish with status polling, and pulling views, watch time and impression sources, then logging that performance into the wiki as a dated feedback record. Covers short-lived tokens breaking a cron, unverified pull-from-URL ownership, and rate limits. NOT what to post or how to package it (that is `shortform-strategy` and `shortform-packaging`).

ericrisco/rsc-harness

Use to judge whether a short-form clip is worth publishing — scores a reel, short or podcast excerpt 0-100 on ten weighted criteria with automatic penalties, then ranks a batch and says where the cut-off falls. Run it on transcript candidates before rendering. NOT writing the hook or caption (that is `shortform-packaging`), NOT inventing the idea (that is `shortform-ideation`), NOT executing the edit (that is `shortform-editing`).

相關技能