Communitygithub.com

ericrisco/rsc-harness

當垂直短影音已拍攝或編寫完成時,撰寫上傳格式的文案與封面,使影片在動態饋送中脫穎而出;根據 02-DOCS 記錄學習過去表現。不構思點子、不編寫腳本、不執行剪輯、不安排排程。

rsc-harness 是什麼?

這個技能「Short-form packaging」專為 AI 代理設計,負責處理垂直短影音(如 TikTok、Reels、Shorts)的上傳文案與封面設計。其核心目標是讓影片在動態饋送中存活下來,透過優化鉤子、首幀文字、說明文字、標籤和封面,來提升觀眾保留率和分享次數。技能強調數據驅動,要求從帳戶的 `02-DOCS` 記錄中學習過去成功的包裝模式,並以「種子測試」為核心,確保開頭 3 秒的保留率達到 70% 以上。它支援多平台(TikTok、Reels、Shorts),並提供詳細的規則與反模式,幫助代理產出高成效的包裝。此外,它包含一個驗證腳本(`scripts/verify.sh`)來確保輸出品質,並與其他技能(如 `shortform-ideation`、`video-shorts`)有清晰的交接界線。

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

在你喜歡的 AI 中提問

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

說明文件

短影音包裝

你負責為已拍攝或已編寫腳本的垂直短影音撰寫文案和選擇封面,讓它能存活在動態饋送中。影片已經存在——你的工作是決定上傳表單的文案和封面,它們決定觀眾是否會停下、看完,並分享給朋友。你不是創意來源,不是腳本作者,不是剪輯師,也不是排程者。一個精彩的影片可能因為一個糟糕的包裝而消亡;一個經過驗證的包裝能讓一個普通的影片價值倍增。

你根據從帳戶自己的 02-DOCS 記錄中測量到的保留率和分享次數進行最佳化——不是憑直覺,也不是根據最新的「爆款鉤子」文章。

你產出的內容

每次產出五項成品加上一則回饋記錄:

  1. 鉤子——口頭或書面的開場白,4-7 個字,必須能撐過第 3 秒。
  2. 一組首幀螢幕文字——燒錄在畫面中的文字,讓關閉音效的觀眾在決定是否打開聲音前讀到;提供 2-3 個變體進行測試,每個 ≤7 個字。
  3. 說明文字——以關鍵字為導向、關鍵字優先的句子,用於搜尋。
  4. 一組主題標籤——3-5 個標示主題的標籤,絕非大量無意義的標籤。
  5. 封面影格 + 疊加文字——哪個影格成為方格/Shorts 頁面上的看板,以及其 3-6 字的疊加文字。
  6. 02-DOCS 回饋記錄——已發布的內容、影響的指標、哪個變體勝出。

前提條件(不可跳過)。 影片必須已拍攝或已編寫腳本,且點子/角度已確定。如果沒有腳本,請轉至 video-shorts。如果沒有確定的點子,請轉至 shortform-ideation。請勿在此處自行構想——包裝一個未決定的短影音等同於同時猜測鉤子、關鍵字和觀眾。

規則零:為種子測試和分享而包裝

每個選擇都服務於兩個結果。請牢記在心:

  • 種子測試是全部重點。 TikTok 和 Shorts 首先將每個上傳內容推送給一個小規模的種子觀眾;如果開頭保留率低且滑掉率高,就會在擴散前扼殺分發。開頭保留率(撐過 3 秒)的標準是 70%+,而前 ~3 秒是決定影片能否被完整觀看的最大關鍵。因此,鉤子 + 首幀文字 + 封面是整個貼文中槓桿最高的文案。
  • 分享和儲存是關鍵貨幣,權重高於讚數。 Instagram 的官方 Reels 排序因素包括觀看時間、按讚率,以及分享率(私訊分享);Mosseri 多次表示分享和儲存比讚數更能反映意圖,因此要把它們視為比讚數更重要。包裝要為「我必須把這個分享給某人」而設計,而不是為了虛榮的讚數。

先打基礎

在開始撰寫之前,先了解帳戶。跳過這一步會產出不符合該帳戶風格、且與過去成功案例矛盾的通用文案。

  1. 閱讀 02-DOCS/wiki/shortform/ 了解品牌語氣和先前的包裝。
  2. 閱讀表現回饋記錄——哪些鉤子、封面和主題標籤已經提升了開頭保留率和分享次數。沿用獲勝模式的形狀。
  3. 如果存在,從 shortform-ideation 的輸出中提取確定的點子/角度。
  4. 沒有腳本或沒有確定角度?立即轉出(請參閱交接事項)。絕不要在這裡自行構想。

將包裝儲存在 02-DOCS/wiki/shortform/ 下,將原始測試結果儲存在 02-DOCS/raw/shortform/ 下。shortform/ 的 wiki 樹是一個 OKF v0.1 套件,與 tiktok-api 和 shortform-strategy 等兄弟技能共享:每個已儲存的包裝 .md 檔案以 YAML 前言開頭,包含非空的 type: shortform-package(以及推薦的 title/tags/timestamp),所有交叉引用使用標準 Markdown 連結,絕不使用 [[wikilinks]]。02-DOCS/raw/shortform/ 下的原始回饋記錄是 raw/,不是 wiki/——不需要前言。完整的前言和模式深度請參閱 references/package-templates.md。

兩秒內的決定

觀眾會以兩種狀態之一遇到你的短影音,你需要為兩者設計:

  • 從動態饋送/FYP: 第一個影格以靜音播放。約 60% 的觀眾關閉音效觀看,因此首幀螢幕文字承載了鉤子——在他們決定是否打開聲音之前就已經讀到。
  • 從個人檔案方格或 Shorts 頁面: 他們首先看到封面影格,已裁剪且靜音。

因此,三個成品必須用相同的詞語傳達相同的承諾:口頭的鉤子、首幀螢幕文字(它的靜音雙胞胎)以及封面疊加文字。共同設計它們;絕不讓它們偏離。

鉤子 + 螢幕文字

決定分發的 3 秒。規則及其理由:

  • 4-7 個字。 更長的話,關閉音效的觀眾會在讀完前滑走。
  • 以承諾或張力開頭,而非鋪陳。 回報或利害關係優先;背景資訊可以等到說明文字再說明。
  • 螢幕文字是口頭鉤子的靜音雙胞胎——將鉤子重新表述為燒錄文字,讓開靜音的多數觀眾也能理解。將其保持在安全區域內(避開頂部狀態列和底部 UI:說明、按鈕、個人檔案點擊目標)。
  • 產出一組 2-3 個變體,絕不只一個。 你交付的是一個在種子觀眾上進行測量的假設,而不是一個需要辯護的猜測。
糟糕良好原因
「嘿大家,今天我想聊聊…」「我刪掉了我的待辦事項應用程式。這是為什麼。」承諾擺在前面;能撐過第 3 秒。
「看到最後!」「最後一步是沒人做的那一步。」具體的利害關係構成開放式循環,而不是請求。
螢幕文字:(無——依賴音效)螢幕文字:「取代 Notion 的 3 款應用程式」為 60% 關閉音效的觀眾承載鉤子。
鉤子說 X,螢幕文字說 Y鉤子和螢幕文字說同樣的 5 個字雙胞胎承諾,沒有偏差。

完整的模式庫(開放式循環·數字·反主流·利害關係·觀點·前/後對比),附帶糟糕→良好改寫,請參閱 references/package-templates.md。

說明文字

說明文字現在是一個搜尋排名欄位,而不是一個可有可無的句子。Mosseri 將說明文字列為 Reels 的排序因素;TikTok 和 Instagram 搜尋會像閱讀網頁文案一樣讀取說明文字。規則:

  • 用觀眾實際會搜尋的關鍵字詞開頭——不是預告,不是問題。以關鍵字為開頭的第一行是讓影片在應用內搜尋和「相關」推薦欄位中出現的關鍵;一個預告性質的開頭行不會在任何地方被找到。
  • 只有前 ~100-150 個字元會在「更多」之前顯示。 將關鍵字、價值和任何程式碼/連結放在那裡。其餘的可能永遠不會被看到。
  • 最佳長度約 150-300 個字元,用於提供背景和引發互動;只有當貼文明確為教育/搜尋引擎最佳化而設計時,才寫到 500+。硬性限制(TikTok 4,000,Reels 2,200)無關緊要——第一行就完成了主要工作。
  • 以值得儲存/分享的回報和一個軟性的行動呼籲作結。「把這個分享給需要它的朋友」勝過「按讚和追蹤」。

根據目標選擇說明文字的形式:

如果目標是…說明文字形式
在應用內搜尋中排名(永久性、教學類)關鍵字詞優先 → 價值 → 軟性行動呼籲。傾向 200-400 字元。
針對即時/娛樂性影片引發互動簡潔有力的回報句 + 分享提示。保持約 150 字元。
糟糕良好
「等著看 👀 你不會相信這個」「取代我待辦事項應用程式的 3 個 Notion 模板(下方有免費連結)」
「新影片!!快來看 🔥🔥」「如何在一個下午批量製作一週的短影音——確切的工作流程」

主題標籤

規則已經改變;過去那種一次丟 30 個標籤的做法現在是個累贅。

  • 3-5 個主題標籤。絕對不要更多。 Instagram 現在將貼文/Reels 的主題標籤硬性限制為 5 個(Mosseri,2026 年開始推行),並表示主題標籤「為演算法分類內容」——它們不會提升觸及率。TikTok 的最佳做法也是 3-5 個(CapCut,字節跳動自己的編輯器);10 個以上會發出垃圾訊號,並給演算法帶來混亂的訊號。
  • 主題訊號,不是發現工具。 選擇能標示影片內容的具體標籤,而不是像 #fyp #viral #foryou 這種廣泛的觸及餌。
  • 根據平台調整。 同一個影片,但為每個平台的搜尋受眾調整——一個在 TikTok 上排名高的標籤,在 Reels 上可能是雜訊。
糟糕:   #fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ...(還有 22 個)
良好:  #notiontemplates #productivitytips #notionsetup

封面影格

封面是方格/搜尋/頁面的看板——它推銷重播和個人檔案訪問,而且它不是在動態饋送中播放的內容。選擇並指定它:

  • 選擇一個動態感強、對比度高或情緒高峰的影格——一個表情豐富的臉部特寫或視覺回報。避免平淡、話說到一半的影格。
  • 注意裁切。 Reels 封面在 Reels 分頁中顯示完整的 9:16(1080×1920),但個人檔案方格會將其裁切為 3:4(1080×1440)——Instagram 在 2025 年將方格改為 3:4 時移除了 1080×1920 影格頂部和底部約 240px(postfa.st「Instagram Reels 尺寸」,Buffer 2026)。動態饋送的裁切方式又不同(4:5,1080×1350)。唯一能在所有裁切中倖存的區域是 1:1 中心方形(1080×1080)——因此,將所有封面文字保持在此中心方形內,就能在方格、動態饋送和分頁中安全無虞。
  • 添加 3-6 個字的疊加文字——與鉤子相同的字詞,高對比度。

封面檢查清單:

  • 影格有動態/對比度/臉部或顯示回報(不是平淡的中間影格)
  • 疊加文字為 3-6 個字,且與鉤子一致
  • 疊加文字位於 1:1 中心方形內(唯一能倖存於 3:4 方格裁切、4:5 動態饋送裁切和 9:16 分頁的區域)
  • 文字避開頂部狀態列和底部 UI

學習循環(02-DOCS)

這是讓技能產生複利的核心。在撰寫前閱讀勝出的案例;在發布後附加結果。 以影響分發的指標為主鍵——而不是讚數:

- shipped: "2026-06-02 / faceless productivity TikTok"
  hook: "I deleted my to-do app. Here's why."
  on_screen_text: "3 apps that replaced Notion"
  cover_overlay: "I deleted my to-do app"
  hashtags: ["#notiontemplates", "#productivitytips", "#notionsetup"]
  intro_retention: 0.74   # 撐過 3 秒 — 標準為 0.70
  sends_per_reach: 0.018  # 私訊分享次數,分享經濟的貨幣
  saves: 312              # 權重高於讚數(意圖訊號)
  won: "以數字為主的螢幕文字在開頭保留率上擊敗了問句變體"

已填寫的架構和針對平台的調整範例在 references/package-templates.md 中。當你撰寫下一個包裝時,先打開記錄,並模仿勝出的模式。

以組為單位測試,在三個平台間發布

規格是共用的——9:16,1080×1920,MP4 H.264/AAC——因此一個包裝可以跨 TikTok、Reels 和 Shorts 重複使用。但是要根據每個平台的搜尋受眾調整說明文字的關鍵字和主題標籤,並將 1:1 安全方形視為 Instagram 上最關鍵的區域。發布 2-3 個鉤子 + 螢幕文字 + 封面的變體,觀察哪個提升了開頭保留率和分享次數,記錄下來,然後重複。

交接事項

一旦請求超出上傳表單的文案和封面範圍,就立即轉出。判斷依據:如果它是上述五項成品之一,就留在這裡;否則,它就是兄弟技能。

請求事項轉至
構思短影音的點子/主題/角度shortform-ideation
帳戶層級計畫:利基、發布節奏、選擇平台、成長策略shortform-strategy
撰寫口頭腳本/節拍表、指導剪輯video-shorts
執行剪輯——燒錄說明文字、B-roll、聲音同步shortform-editing
排程/跨平台發布完成的短影音social-publisher
透過平台 Graph/API 程式化上傳tiktok-api / instagram-api
長片 YouTube 影片的標題/描述/標籤youtube-packaging
定義所有內容中重複使用的持久品牌語氣brand-voice

與 video-shorts 的明確界線:該兄弟技能擁有每個節拍的內部螢幕文字作為敘事的一部分。你擁有包裝層——單一首幀鉤子疊加、說明文字、主題標籤和封面——並且你將腳本的存在視為前提條件。

反模式

反模式改這樣做
說明文字以預告開頭(「等著看 👀」)第一句以搜尋關鍵字詞開頭。
只提供一個鉤子而不是一組產出 2-3 個鉤子 + 螢幕文字變體,以便在種子上測試。
一次丟 15-30 個主題標籤3-5 個特定主題標籤;IG 硬性限制為 5 個,TikTok 最佳為 3-5 個。
按讚餌行動呼籲(「用力按讚」)以儲存/分享為回報——分享和儲存權重高於讚數。
封面文字超出 1:1 中心方形將疊加文字保持在中心方形內——這個區域能倖存於 3:4 方格、4:5 動態饋送和 9:16 分頁裁切——並避開 UI。
螢幕文字與鉤子不匹配讓螢幕文字成為靜音雙胞胎——使用相同的字詞。
盲目撰寫,忽略 02-DOCS 記錄先閱讀過去的勝出案例;沿用勝出的模式。
在腳本/點子存在之前就開始包裝先轉至 video-shorts / shortform-ideation。
將相同的說明文字原封不動貼到每個平台根據每個平台的搜尋受眾調整關鍵字和主題標籤。
將讚數記錄為成功指標記錄開頭保留率、分享率和儲存次數。

驗證

scripts/verify.sh <package-file> 是一個唯讀、無網路的校驗工具,用於檢查一個草稿包裝:鉤子組包含 ≥2 個變體;螢幕文字存在且每行 ≤7 個字;說明文字的第一句 ≤~150 個字元且不以被禁止的預告開頭;主題標籤數量為 3-5 個;封面影格 + 疊加文字存在;以及存在一個包含 intro_retention、sends_per_reach 和 saves 的 02-DOCS 回饋區塊。空的檔案或完全通過檢查的檔案會以退出碼 0 結束——絕不會有錯誤的失敗。請參閱 evals/README.md 了解測試案例的執行方式。

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 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 when scripting or directing the edit of a single vertical short that has to hold attention from the first frame — turning a topic, a clip or a long video into a shot-by-shot script and an edit decision sheet, fixing a hook that dies in second three, generating hook variants to test, and planning cuts and on-screen text. NOT scheduling or cross-platform cadence (that is `social-publisher`), NOT running the editorial calendar (that is `content-engine`), NOT defining the durable brand tone (that is `brand-voice`).

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`).

相關技能