Reels 腳本撰寫

Reels 腳本撰寫 是做什麼的？

Codex 與 Claude 執行環境

• 在 Codex 或 Claude 中使用此技能時，請使用當前任務實際可用的工具。AskUserQuestion 範例描述的只是問題類型，而非強制要求的 API：請在工具限制範圍內使用可用的提問工具，或直接在聊天中提問。重複使用已提供的答案與原始素材。
• 在使用者選擇的專案中工作。在進行個人化工作前，請先閱讀該專案的 about-me.md、voice.md 及相關品牌檔案。如果檔案內容衝突或包含預設的初始值，請確認預定的作者身分。若缺少必要資訊，請提問或執行 voice-builder；切勿繼承維護者的身分、帳戶或私人檔案。
• 解析此技能資料夾中的 references/ 目錄路徑。若使用者明確要求重新整理個人資料，請直接讀取並更新專案中的 about-me.md、voice.md 或 newsletter-voice.md，保留其他不相關的使用者事實與規則。其他使用流程必須重新讀取這些主要檔案。僅在新建的交付項目可能與現有不相關檔案發生衝突時，才使用新的檔案名稱。僅安裝技能不會啟動訪談或寫入檔案。除非使用者要求，否則不要寫入持續性學習內容。
• 優先使用已提供的證據。必要時，可透過可用的搜尋/來源工具驗證外部主張。如果某個來源或整合功能不可用，請說明缺少的能力，並提供以文字或匯入方式輸入的選項。切勿捏造事實、第一人稱經驗、數據或成功的工具執行結果。
• 僅在使用者現有帳戶的範圍內，連接所選路徑所需的服務。切勿顯示憑證或覆寫連線設定。草稿、儲存與審閱並未授權發布、發送訊息或變更帳戶。

重要：載入時自動啟動

當此技能觸發時，直接前往步驟 1。請勿進行摘要。

先決條件

使用完整的 Apify + Gemini 影片分析流程需要：

• APIFY_API_TOKEN 環境變數（用於 Instagram 爬取）
• GOOGLE_AI_API_KEY 環境變數（用於 Gemini 2.5 Flash 影片分析）
• Node.js 18+ 以及 apify-client 和 @google/generative-ai 套件

僅檢查所選路徑需要的能力。對於 URL 提取和 Gemini 影片分析，請確認使用者現有的憑證存在（但不要印出），然後確認供應商和模型可用。如果缺少憑證、套件、影片為私人或模型不可用，則該階段保持待處理狀態。說明缺少什麼；不要修改帳戶設定或擅自更換供應商。

如果使用者已提供影片，則可跳過 Apify。如果已提供逐字稿或分析結果，則可跳過步驟 3 和 4，並在步驟 5 中支援基於逐字稿的標籤式腳本，但這不等同於 Gemini 影片分析的結果。重複使用已安裝的套件；在產生輔助腳本前，請先查閱最新的官方 SDK 與 Actor 文件，並在使用者同意前避免產生供應商費用。

步驟 1. 取得參考

詢問：

請貼上參考的 Reel URL 或 Notion 連結。這是您想要逆向分析格式的異常 Reel。

等待使用者提供 URL。

如果使用者貼上 Notion 連結，請透過可用的授權 Notion 連接器讀取該頁面，找到其中的 Instagram Reel URL 並提取出來。如果在 Notion 頁面上找不到 Reel URL，請要求使用者直接貼上 Reel URL。

步驟 2. 取得電子報主題

詢問：

您電子報中哪個主題想要改編成這個 Reel？請貼上相關的電子報段落，或用一句話描述核心概念。

等待使用者提供主題。如果專案中存在 newsletter-voice.md、voice.md 和 about-me.md，請閱讀這些檔案，確保腳本符合使用者的語調。

步驟 3. 爬取並下載 Reel

在選定的專案中，使用新的 outputs/reels/<slug>/ 資料夾。如果已有適用的輔助腳本，請直接使用；否則，在該資料夾中撰寫一個小型任務專用的 Node.js 腳本，該腳本需：

1. 使用 apify-client 和現有的 apify/instagram-reel-scraper 路由（請先查閱其最新的文件紀錄），來處理單一指定的 Reel。請勿爬取留言、回覆或留言串，包括透過 deepScrape 或 numComments 參數。在呼叫前，請確認該供應商支援僅收集貼文/影片；否則，要求使用者上傳影片。請勿猜測其他 Actor 的輸入參數。
2. 從回傳的項目中提取 videoUrl。
3. 將影片下載至 outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4。
4. 將原始爬取資料儲存至 outputs/reels/<slug>/reel_data_{shortCode}.json。

執行該腳本。在繼續前，請確認檔案大小及元資料（觀看次數、讚數、留言總數（如有）、標題前 200 個字元）。

單一 Reel 是參考，而非經過驗證的異常。僅當有提供或明確要求的比較數據能證明其相對於同一創作者近期貼文的表現時，才能稱之為異常；引用樣本、時間範圍及多個數據點。請勿捏造此基準。

步驟 4. 使用 Gemini 2.5 Flash 分析

擴展現有的 Node.js 腳本（或執行第二次處理），使其：

1. 將下載的 .mp4 檔案以 base64 格式讀取。
2. 呼叫 genAI.getGenerativeModel({ model: 'gemini-2.5-flash' })。
3. 將影片與以下精確提示一起發送：

我正在研究這個 Reel，以便為我的 [來自 about-me.md 的目標受眾] 撰寫類似風格的腳本。

## 完整逐字稿
- 轉錄每個字，並附上時間戳記

## 鉤子
- 說出的第一句話
- 鉤子的字數
- 是什麼讓它能夠抓住注意力？

## 語言模式
- 平均句長
- 你/您的 vs 我/我的 比例
- 觀點之間的轉換
- 「只是」這類淡化詞語出現在哪裡？

## 結構
- 總時長
- 各段落的時間分配
- 轉折點是什麼？
- 行動呼籲（CTA）是什麼？

## 一個關鍵洞察
- 可以從這個 Reel 學到的最重要技巧

將分析結果儲存至 outputs/reels/<slug>/analysis_reference_{shortCode}.md。

步驟 5. 撰寫新的 Reel 腳本

使用步驟 4 的分析結果、步驟 2 的電子報主題以及使用者的語調檔案，將新的 Reel 腳本寫入 outputs/reels/<slug>/reel-[slug].md。

套用以下規則（不可協商）：

鉤子

• 絕不以「我」開頭。使用「這個」、「你」、一個事實或一個名字。
• 經過驗證的格式：「這個改變了……永遠」/ 反面陳述（「X 沒用，除非……」）/ 能力陳述。
• 鉤子須在 3 秒內引發好奇心或打斷模式。
• 模仿參考分析中的鉤子字數和結構。

主體

• 使用英式英語。句子要短。不要使用破折號或分號。
• 以口語方式使用「你」和「只是」（例如「你就直接放進去……」）。
• 切勿將三個或以上的斷裂片段合併。應組合成一個流暢的句子。
• 永遠不要說出結論。讓事實說話。
• 僅在使用者有實際可交付項目且已確認可運行的自動化工具時，才使用留言行動呼籲。否則，使用一個相關但不承諾交付的下一步行動。

留言觸發詞（僅在支援時使用）

• 僅使用一個大寫單詞（腳本、維基、提示、影片）。
• 必須直接與所承諾的內容相關。
• 不要使用引號、不要寫「在下方」、不要有結尾標點符號。

行動呼籲（CTA）

• 「留言 [單詞]，我會寄給你 [具體東西]」
• 簡短。不要添加「我完整內容的連結」這類贅詞。

時長與結構

• 目標總時長為 30 到 45 秒。
• 最多 2 個重點，不要 3 個。
• 標題需與腳本一致。兩者應同時更新。

腳本檔案結構

# Reel：[標題]

## 參考分析
- URL：[Reel 網址]
- 觀看次數：[數字]
- 關鍵技巧：[來自 Gemini 分析]

## 目標時長
30-45 秒

## 鉤子（0-3秒）
[確切台詞]

## 重點 1（[開始]-[結束]秒）
[確切台詞]

## 重點 2（[開始]-[結束]秒）
[確切台詞]

## 行動呼籲（[開始]-[結束]秒）
[確切的下一步行動，僅在確認可交付時才包含留言承諾]

---

## 標題
[與腳本一致，並格式化為 Instagram 風格]

## 留言觸發詞（僅在已設定時使用）
[單詞 或 不適用]

## 可交付項目（僅在已承諾時使用）
[實際可用的資源 或 不適用]

---

## 視覺筆記
[剪輯方式、B-roll 點子、文字疊加]等

步驟 6. 品質驗證（QA）循環

在執行中的助手內進行審查：來源準確性（30）、使用者語調（25）、鉤子與結構（20）、口語朗讀時長與清晰度（15）、標題/CTA 一致性（10）。為每個評分提供依據。修正實際違規事項並重新評分，最多進行三輪。及格分數為 95/100；如果無法解決，請回報含有特定阻礙因素的草稿，而不是提高分數或宣稱已完成。若可朗讀，請計時口語朗讀；否則標註時長為估計值。在 Codex 中，此審查不需要 Claude。

需要檢查的常見違規事項：

• 以「我」開頭
• 三個或以上的斷裂片段
• 說出結論
• 多詞或非標準的留言觸發詞
• 朗讀時長超過 45 秒
• 3 個重點而非 2 個
• 標題與腳本不一致

步驟 7. 交付腳本

將審查後的腳本與對應標題交付至專案中，並附上參考來源、分析方法及任何未解決的檢查項目。使用者可以自行錄製，或明確要求使用他們自己可用的製作流程。此公開技能不包含頭像、編輯或發布流程。

規則

• 絕不能跳過 95/100 的 QA 門檻。
• 在撰寫前務必閱讀 voice.md 和 about-me.md。語調匹配不可協商。
• 絕不能捏造參考 Reel 的數據。僅使用經過驗證的已提供或已取得元資料，並將不可用的數據標記為無法取得。
• 使用英式英語。不要使用破折號。不要使用分號。
• 每個腳本都包含對應的標題；僅在承諾的交付項目能確實運作時，才包含留言觸發詞。
• 如果參考來源存取失敗，請回報失敗的階段，並提供使用者上傳影片或逐字稿的選項。請勿偽造影片分析。
• 使用 Gemini 2.5 Flash 模型。未經使用者同意，請勿更換。