Communitygithub.com

vaprigliano1/ai-reels-creator

為頻道擁有者製作或接續旁白影片,包含研究、腳本、ElevenLabs 音訊、HeyGen 唇形同步、輔助素材、字幕、審核以及最終 MP4 輸出。適用於完整製作或入職流程,不適用於發佈貼文。

ai-reels-creator 是什麼?

這是一個專為 AI 代理設計的技能,用於自動化產生高品質的旁白影片。它整合了 ElevenLabs 的文字轉語音、HeyGen 的虛擬人物唇形同步、自動字幕、B-roll 素材搜尋與渲染等功能,形成一條完整的生產線。主要支援 Claude Code、Cursor 和 Codex 等代理平台,透過讀取與寫入專案目錄中的結構化檔案來管理狀態與工作流程。此技能特別注重安全性:它要求所有秘密(如 API 金鑰)僅從明確指定的 `.env` 檔案中讀取,絕不將秘密寫入日誌、HTML 或可分享的套件中。此外,它強制執行明確的逐項批准流程,以避免未經授權的付費 API 呼叫,並確保每次付費操作(如音訊生成、唇形同步、轉錄與渲染)都需獲得使用者明確同意。該技能還透過 SHA-256 雜湊驗證已批准的檔案,防止重複產生相同內容。其設計哲學是代理不取代人類研究、導演的判斷與最終驗證;它提供自動化的製作骨架,但所有美學決定、版權確認與最終發佈仍需人類把關。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vaprigliano1/ai-reels-creator/tree/HEAD/skills/channel-video

在你喜歡的 AI 中提問

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

說明文件

頻道影片

此方法不預先定義頻道品牌、憑證、模型或人物。請閱讀專案的 AGENTS.md。在已安裝的專案中,輔助程式位於 .agent/skills/channel-video/scripts/。

強制入職流程

如果上下文/個人檔案尚未獲得批准,請先閱讀 references/onboarding.md 並引導對話,之後再產生付費媒體。根據回覆建立頻道上下文,提議可設定的偏好設定,並請求批准。不得根據已填寫的欄位推斷批准。擁有者需要有自己的 HeyGen 和 ElevenLabs 帳戶、其 ElevenLabs 聲音和 HeyGen 虛擬角色,並具備 API 存取權和額度。

任何 ID 或密鑰都不得從其他頻道、全域環境或對話中複製。.env 必須是當前工作區的;不會自動搜尋外部的憑證。

流程

  1. 讀取 channel_context.md 和 channel_profile.json。識別是零星請求、完整資料夾、已發佈的內文或現成的腳本。重複使用現有主題或建立 videos/<主題>/。
  2. 對於新腳本,請閱讀 references/editorial.md。對於淺層請求進行深入調研;對於完整資料夾進行缺口分析。主題不一定是旅遊、飯店、創始人或商業。根據素材調整敘事和時長,不要為了湊足固定時間而重複事實。
  3. 儲存腳本、來源、貼文說明文字和旁白。如果已有已批准的腳本,請保留它。使用 scripts/init_job.py 初始化 job.json;使用 doctor.py 檢查依賴項/設定。
  4. 在擁有者的文件/帳戶中確認實際的 model_id、語言、限制和對標籤的支援。如果擁有者想要標籤,請保持相容;不要在不相容的模型上發音標籤。API 不應接收虛構的商業模型名稱作為 ID。進行乾測試並解釋字元/設定/預估成本,但不要列印憑證。
  5. 請求授權以進行短期付費測試,然後使用 elevenlabs_audio.py --smoke-test --allow-paid 生成。展示實際音訊,不得聲稱聽到了未聽到的內容。測試的批准不會自動批准完整旁白。
  6. 獲得授權後,生成完整旁白並請求對檔案的明確批准。使用 approve_audio.py 記錄 SHA-256。未經擁有者要求,不得使用手機錄音作為生產音訊。
  7. 獲得唇形同步授權後,使用相同的已批准 MP3 執行 heygen_video.py --allow-paid。HeyGen 接收 audio_asset_id;不會重新合成腳本。驗證透明背景、身份、手勢和上半身裁切。
  8. 使用 transcribe.py --allow-paid 轉錄已批准的旁白。實際時間戳決定 B-roll、疊加層和字幕。檢查姓名、數字和語言;新的音訊需要新的唇形同步。
  9. 閱讀 references/media.md。按片段搜尋連貫的素材,在 asset_manifest.json 中記錄來源和精確時間區間,並使用 contact_sheet.py 生成審閱頁面。在做出決定之前不要下載最終檔案。使用 import_approvals.py 匯入匯出的 JSON,並檢查清單的雜湊值;缺失的決定仍保持為待定。
  10. 使用 download_media.py 或環境中授權的工具下載已批准的原始素材。頁面網址不是影片網址。不得繞過 DRM、私人存取權限或使用條款。分別記錄來源、修改和權限。
  11. 閱讀 references/render-plan.md 和 operations.md。使用已批准的素材、測量的時間區間、虛擬角色和字幕建立計劃。render.py 使用 FFmpeg 和點陣化排版,不需要其他編輯器。官方疊加層或裁切的人像可選,取決於頻道風格。不得重新設計商標或偽造文件照片。
  12. 閱讀 references/qa.md,執行 qa.py 並進行實際視覺檢查。技術檢查不保證美學、發音、穩定性或版權。提供預覽以獲得批准。使用 save_final.py 將當前的 MP4 整合到 video final/ 中,不重新編碼並保留歷史記錄。

接續與安全

  • 在執行前閱讀狀態/工件。不要重新生成已存在且雜湊值有效的內容。
  • 密碼僅來自明確指示的 .env。絕不將其放入持久化負載、日誌、HTML、清單或可分享的套件中。
  • 無自動付費重試。不確定的結果需要檢查和新的授權;應使用已記錄的外部 ID 來繼續輪詢。
  • 不得為了方便而將虛擬角色/聲音轉移到另一個頻道。建立/複製需要自己的範圍和權限,不是自動入職流程的一部分。
  • 不得變更已批准的上下文、更換模型或悄悄刪減腳本。當這會實質改變製作時,請請求決策。
  • 封面圖片和說明文字可以在要求時作為單獨的工件產生;連接社交媒體、發佈或排程需要自己的整合/授權。

這些腳本不取代人類研究、導演和驗證。版面預設值可調整;已批准的音訊、成本、來源和秘密保護的恆定不變性不是美學偏好。

相關技能