Communitygithub.com

marsik641/space-shorts

太空短片製作管線的第一步:建立短片工作目錄,並提出三個選項供使用者選擇下一部宇宙主題短片的方案。

space-shorts 是什麼?

此技能為《The Universe Inside Out》頻道的太空短片製作管線之第一步,專注於協助使用者選擇下一部短片的內容。它會自動建立短片專屬的工作目錄(worktree),並基於頻道總體規劃、歷史紀錄、品質標準、競爭對手分析及當前進行中的專案,產出三個候選主題。每個主題都包含鉤子(hook)、高潮鏡頭(money shot)、視覺參考、時程估算及工作負荷評估,確保提案的原創性與多樣性。支援 Claude Code 與 Codex 平台,透過 `EnterWorktree` 或 `workdir` 指令操作。使用者可從三個選項中挑選,或要求重新提案,系統會將最終選擇記錄至 ideas 檔案並提交版本控制。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/marsik641/space-shorts/tree/HEAD/.agents/skills/next-video

在你喜歡的 AI 中提問

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

說明文件

/next-video — 步驟 1:短片工作目錄與 3 個選項

此對話代表一個未來的短片(參閱 AGENTS.md,「對話管線」)。此步驟的目標是讓使用者選擇主題。 在選擇之前,請勿進行任何渲染,也請勿建立 episodes/<ep>/ 資料夾。 頻道 The Universe Inside Out 涵蓋整個宇宙:行星、衛星、恆星、黑洞、星系、系外行星、彗星、 真實任務與事件、尺度、「如果……會怎樣」。短片僅使用英文,目標長度為 29–29.5 秒,最長不超過 30.0 秒 (docs/shorts_format.md)。品質標準請參考 docs/quality.md:如果一個主題沒有任何能讓觀眾停下捲動的畫面,則不予提案。

步驟 0 — 短片工作目錄

  • 對話在主副本中:執行 python tools/video_wt.py start → 路徑 out/wt/epNNN,分支 video/epNNN, 編號已保留。Claude 請使用 EnterWorktree 搭配此 path;Codex 請將 workdir 設為此路徑。後續所有操作皆在此目錄中進行。
  • 對話已由應用程式在工作目錄中開啟(非 video/… 分支):執行 python tools/video_wt.py start --here。
  • 若已在目前短片的 video/epNNN… 分支上:則繼續使用該分支。

步驟

  1. 讀取以下資訊:
    • python tools/video_wt.py status — 其他對話目前正在處理哪些短片(不要提案這些主題);
    • docs/channel.md — 系列與「首波主題」表格(✅ = 已拍攝完成);
    • episodes/INDEX.md — 已完成的內容及其使用的鏡頭(不要重複使用相同的物體、鏡頭配置或鉤子類型);
    • docs/quality.md — 畫面品質標準;docs/spacekit.md — 「有 / 沒有」矩陣(哪些需要模組);
    • docs/timings.md — 每秒幀數與 ETA 公式;docs/metrics.md — 哪些內容表現好 / 不好;
    • docs/competitors.md — 競爭對手表現好的主題與鉤子,以及他們的弱點;
    • ideas/*_options.md — 此處的「已選擇:……」行,以及已在進行中的短片分支中被提案或選擇的主題:對每個 status 中的 video/… 與 codex/… 分支執行 git grep -h -e "^## 選項" -e "已選擇:" <分支> -- ideas/,加上分支名稱中的 slug。
  2. 選擇 3 個候選方案:
    • 選項 1 — 下一個未標記的主題,來自 docs/channel.md 表格(按編號順序),且不在其他對話的分支中;
    • 選項 2 和 3 — 來自與選項 1 不同的其他系列和物體類別,彼此不同,且與上一集不同(「最新消息」— 搜尋過去 3–7 天的天文與任務新聞);
    • 每個選項需包含 高潮鏡頭(一個關鍵畫面),驚艷度評分 1–5,以及 2–3 個視覺參考(URL)。 摘要中的選項順序應依驚艷度排列,而非 spacekit 的便利性。
  3. 對每個選項進行快速事實查核(ATNF、NASA Exoplanet Archive、JPL SSD/Horizons、arXiv、NASA/ESA 任務頁面);「事實查核員」角色請參考 docs/workflows.md。
  4. 根據 docs/timings.md 進行估算:渲染時間 = Σ 鏡頭數 × 每種鏡頭類型的秒/幀 + 約 30 秒/鏡頭;最終成品規劃 4–6 小時以確保品質,最多 6 小時(docs/quality.md);工作量 = 1–2 小時(無需新模組)+ 每個來自 docs/spacekit.md「否」欄位的模組需 3–8 小時。
  5. 依照 ideas/_TEMPLATE_options.md 模板(使用中文)寫入 ideas/<YYYY-MM-DD>_options.md。如果該日期的檔案已存在,則加上 _2 後綴。
  6. 在短片分支中提交:docs(epNNN): 短片選項 + 模型追蹤器(AGENTS.md,「代理程式運作方式」)。保持工作目錄乾淨。
  7. 向使用者顯示三個選項的簡短摘要(每個選項 3–4 行:物體、鉤子、高潮鏡頭、驚艷度、spacekit 新增項目、渲染 ETA + 到完成套件的完整週期),並附上檔案路徑,請使用者選擇:「/make-video N」(可附帶修改意見)。停止。

規則

  • 僅限具有實際測量參數的真實物體 / 事件;假設與「如果……會怎樣」需明確標示。
  • 不要過度專注於中子星:連續兩個脈衝星 / 磁星僅限使用者要求時。
  • 不要提案需要以他人影片 / 音樂為基礎的內容。
  • 避免「虛假內容」(docs/pipeline.md,最後一節):每個選項應使用不同類型的鉤子和結構,不要複製過去集數的模式。
  • 如果使用者拒絕所有選項 — 在同一對話中提供新的 3 個選項;如果使用者關閉主題 — 執行 video_wt.py finish --no-release(合併 ideas 檔案)和 remove:該編號將保持佔用狀態。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能