Communitygithub.com

ericrisco/rsc-harness

用於為 Reels/TikTok/Shorts 帳號的下一個影片點子進行評分,並建立排好優先順序的待辦清單,所有點子都基於帳號自身的表現記錄與標註日期的流行音效,每次下注的結果會回饋到下一批點子中。不負責撰寫已選定點子的腳本(那是 `video-shorts` 的職責),也不處理內容支柱或發文節奏(那是 `shortform-strategy` 的職責),更不包裝最終剪輯成品(那是 `shortform-packaging` 的職責)。

rsc-harness 是什麼?

這項技能為短影音內容創作者(Reels/TikTok/Shorts)提供一個閉環式點子生成與實驗管理系統。其核心運作遵循「假設 → 下注 → 衡量結果 → 優化下一批」的循環。使用者給出一個點子後,技能會依據該帳號過往的表現數據(例如 3 秒停留率、分享數)以及來自 TikTok 創作者中心或 Instagram 的當期流行訊號(需合法取得,禁止爬蟲),對點子進行加權評分並建立優先級待辦清單。每個被推進到「拍攝」或「已發布」階段的點子,都會被記錄為一個可驗證的假設(Hypothesis),並在後續取得實際數據後填入結果,形成持續學習的迴路。這項技能明確界定了自身的邊界:它只產出經過排名與附有證據的點子、鉤子角度與所選音效;一旦涉及撰寫完整腳本或時間碼,就應立即交接給 `video-shorts` 技能。它支援多平台趨勢感知,並內建了合法的趨勢訊號擷取流程(例如比較 TikTok 7 天與 30 天內的趨勢變化,以及偵測 TikTok 到 Reels 的領先時間窗)。最終產出的待辦清單檔案(`02-DOCS/shortform/backlog.md`)與實驗記錄檔案(`02-DOCS/shortform/experiments/`)都有嚴謹的結構化格式,可透過腳本進行語法檢查。

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

在你喜歡的 AI 中提問

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

說明文件

短影音點子發想 — 點子引擎與下注帳本

你為 Reels/TikTok/Shorts 帳號執行一個完整的閉環流程:假設 → 下注 → 衡量結果 → 產生更好的下一批點子。 你負責管理點子清單、優先級分數以及實驗帳本。

你的輸出止於一個帶有排名、附有證據、並包含所選流行鉤子與書面假設的點子。 當你開始撰寫口白台詞或節拍時間碼時,你已經越界進入了 video-shorts 的領域 — 請立即交接,不要佔著不走。

一個你無法用 (a) 這個帳號自身的表現記錄 以及 (b) 一個標註日期的流行訊號 來辯護的點子,只是腦力激盪,而非下注。此技能拒絕產出腦力激盪式的垃圾資訊。

決策關卡 — 你現在真的在點子發想階段嗎?

在生成任何東西之前,請根據下表判斷需求,當需求落在你的欄位之外時,也依據此表進行交接。原因:這裡一半的錯誤都是因為範圍蔓延到其他負責實際交付成果的同級技能。

需求負責技能為什麼不是你
"給我 N 個有排名的點子 / 我們應該先拍哪一個"你生成 + 評分 + 排名是核心循環
"把本週的流行音效融入點子裡"你基於趨勢的點子發想是招牌動作
"我們下的賭注為什麼失敗了?"你結果帳本將下注與結果連結起來;這是你的職責
"為這個點子撰寫分鏡腳本 / 剪輯工作表"video-shorts你的職責止於點子 + 鉤子角度 + 所選音效
"我們的內容支柱 / 發文節奏 / 定位應該是什麼?"shortform-strategy你將內容支柱作為輸入來消耗,而不是制定它們
"為這個完成剪輯的影片撰寫標題、主題標籤和封面"shortform-packaging你可以建議一個主題標籤作為趨勢訊號,但不能最終確定它
"YouTube 點子,需以縮圖為優先的包裝方式"youtube-ideation那個流程是以包裝為主導,且衰退速度較慢
"規劃跨頻道行事曆,涵蓋部落格、電子報和社群媒體"content-engine你將排名後的點子餵入行事曆,而不是管理行事曆
"為我建立一個數據儀表板"analytics你讀取表現記錄來評分點子,而不是建立報表

循環 — 四個階段,按順序進行

階段 1 建立根據     階段 2 尋找趨勢     階段 3 生成+評分    階段 4 記錄下注
讀取 02-DOCS 的   ─▶ 擷取有日期      ─▶ 點子 = 主題 × 格式 ─▶ 將假設寫入
表現記錄;           的流行訊號         × 趨勢鉤子 × 節奏      02-DOCS/shortform/
提取成功的             (合法地,不爬蟲);     → 評分 → 排名待辦     experiments/,
鉤子/格式和           標記過時訊號         清單                   保留結果欄位為
已證實的失敗                                                   待填狀態

絕對不可以跳過階段 1。 沒有以這個帳號自身數據為根據的點子,只是偽裝成計畫的猜測。有根據的數據才能讓分數有意義。原因:在烹飪帳號上大獲成功的鉤子,可能在 B2B SaaS 帳號上徹底失敗;只有記錄能告訴你現在是哪一種情況。

階段 1 — 以 02-DOCS 為根據

帳號的表現記錄位於 02-DOCS/shortform/performance.md (或 performance.csv)。每次循環都先讀取它。

提取以下四點,並在工作記憶中保留以供評分使用:

  1. 成功的鉤子 — 開頭 1–3 秒內能獲得超過 60% 3 秒停留率的模式。
  2. 成功的格式 — 談話頭、無臉配音、螢幕錄製、短劇、清單式 — 任何表現超出平均的格式。
  3. 失敗的主題/格式 — 表現低於平均兩次或以上的主題或格式。這些是負面證據;不要為它們換上新包裝後再次提出。
  4. 最佳的 3 秒停留模式 — 那些能留住觀眾的特定第一幀動作,因為 3 秒停留率是整個批次要優化的指標(見指標章節)。

如果沒有記錄檔案,請建立一個最簡版本,位置在 02-DOCS/shortform/performance.md,包含欄位 date | url | format | hook line | 3s-hold | shares | saves | views | note,並請使用者盡量回憶填入初始資料。同時將這個循環中所有點子標記為 unvalidated,以便下次循環知道這個分數是先驗的,而非後驗的。原因:缺少記錄不是默默猜測的理由 — 這是開始衡量的理由。

階段 2 — 尋找趨勢(合法地)

擷取流行的音效、格式和主題標籤,並為每個訊號標註日期,因為短影音的趨勢窗口很短,過時的訊號比沒有訊號更糟。

鐵則:絕對不要爬蟲。TikTok 創作者中心沒有公開的趨勢 API,自動化收集違反其服務條款(2026 年 4 月的規則更新也強化了這點)。趨勢探索(流行歌曲/主題標籤/熱門廣告)可以透過在應用程式中切換地區到美國來以非登入方式瀏覽;程式化存取則需要使用 sanctioned Research API 或 Commercial Content API (來自 developers.tiktok.com)。你只能指示手動或輔助擷取 — 請使用者貼上創作者中心的畫面,或從 sanctioned API 讀取 — 並且你絕對不能在你產出的任何產物中嵌入爬蟲指令。原因:爬蟲不僅違反服務條款,也是脆弱的依賴項,會破壞整個循環。

四個擷取管道,摘要如下,每個來源的詳細做法在 references/trend-sources.md 中:

  • TikTok 創作者中心 — 將地區切換到美國,並比較 7 天與 30 天的變化趨勢。 數據每 24–48 小時更新一次。只在 30 天視圖中有變化的音效可能已經在衰退;優先加權 7 天內上升的訊號。
  • Instagram 熱門音訊 — 原生的熱門音訊清單僅限美國專業帳號使用;熱門音效旁會顯示一個向上箭頭指示器。非美國/非專業帳號則依賴探索頁面、利基創作者的重複使用,以及跨平台來源追蹤。
  • TikTok → Reels 領先窗口 — Reels 的趨勢通常比 TikTok 慢 3–7 天。一個在 TikTok 上爆紅,但在 Instagram 上使用該音效的 Reels 少於 5,000 個,這是一個有記錄的領先時間窗口;將其標記為 early 並優先處理。
  • 利基創作者重複使用 — 當該帳號所屬利基中的 3 位以上創作者在一週內重複使用相同的音效/格式時,即使在全球清單中出現之前,也將其視為經利基驗證的訊號。

為每個擷取的訊號加上標籤:signal | platform | first-seen date | 7d trend | 30d trend | freshness(early|peaking|stale)。沒有日期的訊號不得進入階段 3。

階段 3 — 生成 + 評分

點子是產物,不是主題:

點子 = 主題 × 格式 × 趨勢鉤子 × 節奏原型
  • 主題 — 從帳號的內容支柱和成功主題(階段 1)中提取。
  • 格式 — 記錄中的成功格式,或一個經過深思熟慮的實驗。
  • 趨勢鉤子 — 一個來自階段 2 的有日期、非過時訊號,如果沒有適合的訊號則用 "evergreen"(常青)。
  • 節奏原型 — 加上目標長度,因為「單位長度的觀看時間」比「原始長度」更重要:教育類內容可以容忍 +5–10 秒及更深入的證明,娛樂類內容則需要 1–2 秒的快速剪輯。附上目標長度,讓下注是可測試的。

使用加權 1–5 評分表為每個點子評分。權重反映了真正驅動短影音觸及率的因素 — 鉤子強度和可分享性,而非主題興趣。

標準權重5 分的樣子
鉤子強度×3前 3 秒開啟一個循環 / 模式中斷,與經過驗證的成功鉤子相符
帳號契合度×2主題+格式在此帳號的記錄中皆表現超出平均;絕非已證實的失敗
趨勢新鮮度×27 天內上升的音效,或 TikTok→Reels early (<5k Reels) 窗口
可分享性/儲存×2觀眾有明確的理由傳送或儲存(實用性、地位感、「這就是我們」的感覺)
努力程度(反向)×1製作負擔低;5 分 = 用現有資源今天就能拍

weighted_score = 3·hook + 2·fit + 2·fresh + 2·share + 1·(6−effort) → 最高 50 分。按分數降序排列到待辦清單。

待辦清單表格結構(這是可檢查的產物 — 02-DOCS/shortform/backlog.md):

idideahook linetrend signal + dateformattarget lenscorestatus
SF-001……… (2026-06-01, 7d↑)……42planned

status ∈ {planned, shooting, posted, killed}。

壞 → 好 的點子範例:

  • 壞的: "做一支關於我們義式咖啡機的影片。" — 一個沒有鉤子、沒有格式、沒有趨勢、沒有分數的主題。無法排名。
  • 好的: SF-007 | "€4 拿鐵的謊言"成本分析 | 鉤子:倒入濃縮 + 畫面顯示"你的咖啡館收取 900% 加價" | 趨勢:配音收據格式,TikTok 7天↑,3k Reels (early) 2026-06-01 | 無臉配音 | 18s | 分數 45 | planned — 一個有根據的下注,帶有開啟循環的鉤子、新鮮的標註日期訊號,以及儲存理由(人們會截圖數學計算)。

階段 4 — 記錄下注

每個你推進到 shooting/posted 階段的點子,都會在 02-DOCS/shortform/experiments/<YYYY-MM-DD>-<slug>.md 產生一個假設檔案。結構和一個完整的 before/after 範例在 references/experiment-ledger.md 中。

假設是一個可被否證的句子:

假設: 趨勢 voiceover-receipt + 鉤子 "900% 加價" 將會把 3s-hold 提升至 60% 以上,針對 咖啡定價 這個主題。

然後將結果欄位保留為待填狀態 — result: pending | 3s-hold: __ | hook-rate: __ | shares: __ | saves: __ | verdict: __ — 等待影片發布後填入。下次循環會在階段 1 讀取這些結論:被證實的假設會成為成功模式;被否證的假設則會成為失敗模式。原因:記錄了下注卻從未記錄結果,會讓帳本變成一堆猜測的墳場 — 循環只有當結果閉合時才能學習。

若要對輸出的待辦清單或實驗檔案進行結構化語法檢查,可對其執行 scripts/verify.sh(唯讀模式):bash scripts/verify.sh 02-DOCS/shortform/。

重要的指標

根據這些指標來評分和判斷,而不是原始觀看次數。原因:觀看次數是落後指標且容易被操弄;這些才是演算法真正獎勵的槓桿。

指標解讀來源事實
3 秒停留率>60% = 強勁;<40% = 終止這個模式前 3 秒內流失率高達 ~50%;>60% 停留率的 Reels 觸及率可能是 <40% 的 5–10 倍
鉤子率~28% 是 Meta 短影音的平均值;超越它前 3 秒內的鉤子/跳接剪輯與 ~72% 更高的爆紅可能性相關
分享 + 儲存發現的貨幣 — 在評分中加權演算法獎勵觀看時間和分享,以實現分發
單位長度的觀看時間一段 10 秒 80% 停留率的影片,勝過一段 60 秒 30% 停留率的影片最佳化「長度保留率」,而不是原始時長

反模式

反模式失敗原因正確做法
未經評分的腦力激盪傾倒無法排名;使用者無法決定先拍哪個總是產出包含每個點子分數的排名待辦清單表格
追逐只在 30 天內移動的流行音效僅 30 天內的變化通常表示音效已經在衰退加權 7 天內上升的訊號;將僅 30 天變化的標記為 stale
重提記錄已證明失敗的主題忽略了帳號自身的負面證據在評分前檢查階段 1 的失敗點;絕不提出已證實的失敗
為了趨勢而爬蟲創作者中心違反服務條款,破壞循環,產出脆弱的程式碼手動/輔助擷取或使用 sanctioned API;產物中零爬蟲指令
根據主題興趣而不是鉤子強度來評分一個迷人但前 3 秒乏味的主題仍然會失敗鉤子強度有 ×3 的權重;先為第一幀評分
記錄了下注卻從未記錄結果循環永遠學不到東西;下一批又在重新猜測保留結果欄位並填寫;階段 1 讀取結論
在這裡撰寫完整腳本/時間碼越界進入 video-shorts;搞混點子帳本止於鉤子台詞 + 所選音效;然後交接
擷取趨勢訊號時沒有標註日期新鮮度無法評分;你可能會簡報一個已過時的音效每個訊號都必須帶有首次發現的日期,否則不得進入階段 3

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

相關技能