Communitygithub.com

linwanjiu/short-video-copy

把一句話選題寫成短視頻文案。預設只輸出文案與發佈文案,分鏡表按需再給。按平台/品類/調性預設組合,附帶計時模型與標點規範。當使用者說「寫個短視頻文案/口播稿/腳本」時使用。

short-video-copy 是什麼?

此技能是由 linwanjiu 開發的短視頻文案生成工具,專為 AI 代理(如 Claude Code)設計。它採用「引擎 + 預設」的架構,核心方法論寫在 SKILL.md 中,所有風格參數(平台、品類、調性、鉤子等)則分別儲存在 presets/ 目錄下的獨立檔案中,並透過 profile.md 進行當前選擇的設定。工作流程優先產生一份通用文案,讓使用者先看到成果,再透過四個固定問題(平台、調性、結構、反轉與鉤子)引導使用者調整參數,最後根據回饋重寫文案或永久儲存偏好。輸出預設僅包含帶時間軸的口播稿與發佈文案,分鏡表或完整影片草稿則需使用者明確要求才會提供,避免資訊過載。技能還包含嚴格的品質自檢清單、回饋處理機制(臨時調整 vs. 永久寫入 profile.md)、以及針對參考影片的拆解模式,確保輸出的文案符合平台特性、調性一致且具備完播率。支援的平台包括抖音、小紅書、視頻號、B站等,並涵蓋知識科普、個人IP、帶貨、口播等多種結構。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/linwanjiu/short-video-copy/tree/HEAD/skills/short-video-copy

在你喜歡的 AI 中提問

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

說明文件

短視頻文案

一句話選題 → 一套可以直接開拍的文案。

這套技能是引擎 + 預設的結構:方法論在這裡,風格在 presets/ 裡,當前選擇在 profile.md 裡。


0. 先讀兩個東西

  1. profile.md —— 當前選擇(platform / category / tone / duration / density / person / cta / banned)
  2. 按 profile 去對應預設檔案裡讀它選中的那一節,不要整份讀
profile 欄位去讀哪只讀哪一節
platformpresets/platforms.md同名小節(抖音/小紅書/影片號/B站/通用)
categorypresets/categories.md同名小節
tonepresets/tones.md同名小節
鉤子presets/hooks.md按選題類型挑 1–2 類

profile 裡的值優先於本檔案的一切預設;使用者當場改口的,以當場為準。


1. 預設流程:先出稿,再收參數

使用者給一句話時,不要先問一串問題。先用當前 profile(沒有就用:通用 / 清晰直接 / 30 秒)出一版完整的,讓他看見東西,再問。

第一步:出通用稿

四件套齊全(口播 + 分鏡 + 發佈文案),時間按 presets/timing.md 算。 開頭註明一句:「這是通用版,沒做平台特化」——不然使用者會以為這就是最終稿。

第二步:固定四問

只問這四個,按順序,每個都給選項。不要追加別的問題。

1. 平台:抖音 / 小紅書 / 影片號 / B站 / 就用通用? —— 決定節奏、語速、CTA

2. 調性:犀利 / 親切 / 幽默 / 克制專業 / 保持清晰直接? —— 決定句長、動詞、和觀眾的距離

3. 結構:口播三段 / 科普(結論先行 + 機制)/ 故事(經歷 + 提煉)/ 劇情(衝突 + 反轉)? —— 決定段落順序和佔比

4. 反轉與鉤子:不加 / 中段加一個反常識轉折 / 結尾留反轉 / 雙鉤子(前 3 秒停手 + 8 秒留人)? —— 決定完播設計

問完補一句:「直接回 1/2/3 這種編號,或者一句話說都行,我按這個重寫。」

第三步:重寫

  • 只改受影響的段落,使用者認可的部分保留
  • 開頭用一行說明改了什麼:平台→抖音,語氣→犀利,時長 30→15 秒,中段加反常識轉折
  • 重寫後時間必須重算,不能沿用舊表

第四步:要不要記住

使用者說「以後都這樣」「記住」「預設改成」→ 按 §5 寫 profile.md 並回報。

例外

情況處理
使用者一次就把平台/調性說清了跳過問卷,直接出定向稿
使用者說「先給我看通用的」只出通用稿,不問
使用者只要鉤子不要全文只給 5 條候選鉤子,讓他挑

1b. 一句話裡缺什麼

缺什麼怎麼處理
給誰看從選題反推最可能人群,明說假設
要什麼動作用 profile 的 cta
多長用 profile 的 duration
什麼平台用 profile 的 platform,沒有就按「通用」

通用稿階段只補一個最關鍵的假設,不要連環追問。 追問放在第二步的固定四問裡。


2. 組裝:四個預設怎麼疊

順序不能亂,每一層解決一個不同的問題:

platform  → 決定節奏、語速、CTA(外形)
category  → 決定段落順序和佔比(骨架)
tone      → 決定句子長度、動詞、距離(皮膚)
hooks     → 決定前 3 秒(門)

衝突時的優先級:platform > category > tone。 比如小紅書要「慢」,但帶貨要「密」,取中間值,並在文末說明你做了取捨。

常用組合(可以直接推薦給使用者)

目標組合
抖音爆款感抖音 + 知識科普 + 犀利 + 反常識鉤子
小紅書種草小紅書 + 帶貨 + 親切 + 痛點場景
影片號信任影片號 + 個人IP + 克制專業 + 故事在場
B站硬核B站 + 知識科普 + 克制專業 + 具體數字
新手最穩通用 + 口播 + 清晰直接 + 反常識

3. 輸出:預設只給文案

別一上來就堆一堆東西。 預設只輸出兩樣:文案、發佈文案。分鏡表要不要,問過再給。

3.1 文案(預設交付,唯一必給的)

附時間軸的口播稿,三欄:

時間字數台詞
0.0–1.9s6你越補覺,越累。
  • 時間按 presets/timing.md 算,不要手估;直接跑 node scripts/timing.mjs --rate <語速> "台詞1" "台詞2"
  • 標點與語句嚴格按 presets/punctuation.md:全形標點、單句 ≤ 15 字、一句最多 2 個逗號
  • 末尾時間與目標時長誤差 ≤ 0.5 秒。超了刪字,不要靠念快來糊
  • 交付時不要再附 JSON、不要附分鏡,除非使用者要

3.2 發佈文案(預設交付)

標題(≤ 20 字)+ 3–5 個標籤 + 一句評論區引導。

3.3 交付後必須問一句

文案給完,緊接著問:

需要我按這段文案出一份分鏡表嗎?(每句話配什麼畫面、螢幕文字、時間點)

  • 使用者說要 → 出 3.4
  • 使用者說不用,或者沒回應 → 到此為止
  • 不要順手給 content.json,不要問「要不要出片」

3.4 分鏡表(僅當使用者明確要)

#時間畫面螢幕文字備註
  • 時間欄直接抄 3.1 的時間,不許獨立分配
  • 一句台詞一個鏡頭;一句拆兩個就寫 1a/1b,兩者相加必須等於原句
  • 單鏡頭 < 1.2 秒合併,> 6 秒拆分
  • 畫面只寫能拍出來的東西,不寫「有氛圍感的空鏡」

3.5 動效檢查(僅當使用者明確要出片)

只有使用者說「要出片」「給我草稿」才做:

cd <video-studio>
.\check-effects.ps1 -Human
結果動作
腳本不存在使用者沒裝影片流水線 → 跳過,不當錯誤
installed=true繼續
installed=false先提醒再問,不要悶頭生成

你還沒有生成動效素材庫(9 個,約 196 MB)。要現在生成嗎?大約 2.5 分鐘。

使用者沒同意就不要跑生成。

3.6 明確不做的事

  • 不輸出 content.json / scenes:那是影片側的結構,文案側不該背這個
  • 不主動給分鏡,不主動提「要不要出片」
  • 不替使用者決定平台和調性——那在 profile.md 裡

4. 自檢

  • 前 3 秒是鉤子,不是自我介紹
  • 鉤子屬於 hooks.md 裡明確的一類,沒有串類
  • 有一句能被截圖單獨轉發的話
  • 至少一個具體數字,且正文兌現了
  • 口播每句 ≤ 15 字,按語速唸一遍不超時
  • 全篇只有一個調性,沒有中途變臉
  • 結構符合所選品類的段落佔比
  • 無絕對化用語(最/第一/根治/百分百)
  • 醫療、金融、教育類沒有效果承諾
  • 命中 banned 裡的詞?命中就重寫那句
  • 標點全是全形,沒有半形 ,.!?
  • 引號統一(「」或“”),省略號是 ……,破折號是 ——
  • 沒有一逗到底的長句,每句 ≤ 15 字
  • 數字格式統一(15秒 / 73%),英文前後有空格

5. 回饋怎麼改

改預設,不改引擎。

使用者說改哪裡
太長了 / 太短duration
太官方 / 太衝 / 太油tone
不像小紅書 / 像抖音platform
資訊太密 / 太空density
結構不對category
開頭不行換 hooks 的類別
這個詞別說banned

臨時改 vs 永久改(重要)

使用者怎麼說你做什麼是否落盤
「這版改成小紅書」只按新參數重寫這一版❌ 不寫檔案
「以後都用小紅書」 / 「記住」 / 「預設改成」必須用編輯工具改 profile.md✅ 寫檔案
「太衝了」 / 「太油了」判斷是臨時還是長期,問一句或按長期處理✅ 寫檔案

只說不寫 = 沒改。 會話結束,上下文就沒了,下次還是舊參數。

落盤時必須做三件事:

  1. 改 profile.md 裡對應的那一行
  2. 在 profile.md 的「改動記錄」末尾追加一行:- YYYY-MM-DD 把 tone 從 X 調成 Y(原因)
  3. 回給使用者一句:「已寫入 profile.md:tone: 犀利」

預設裡沒有的值怎麼辦

使用者要 platform: 知乎,但 presets/platforms.md 只有四個平台:

  1. 先按最接近的寫(知乎 ≈ B站長文 + 克制專業),說明你做了近似
  2. 問一句要不要把它加進 presets/platforms.md
  3. 要加就照現有格式補一節,不要塞進 SKILL.md

如果使用者連續三次在同一維度上調,說明預設本身不夠細,才考慮改 presets/ 裡的那一節。


6. 拆解模式(可選)

使用者給一條參考影片(連結或文字稿)而不是選題時,走 references/analysis.md: 輸出 hook 類型、結構分段、風格標籤、爆款原因、3 個改寫方向。


7. 邊界

  • 不編資料。沒給數字就用可驗證的模糊量,或者直接問。
  • 醫療、金融、教育不寫具體效果承諾。
  • 不確定的事實標「待核實」,不寫成結論。
  • 不寫「最/第一/唯一」這類絕對化表述,除非有可核驗的來源。

相關技能