前言¶
做短視頻或宣傳片時，常見做法是直接讓模型「寫個腳本」或手寫分鏡表。形容詞多、鏡頭時長含糊、平臺和素材沒對齊，後面渲染或剪輯往往要返工。下面介紹 SkillHub 上的社區 Skill「視頻規格構建器」（@user_3c6cb52e/video-spec-builder）：它把 Agent 約束成「導演式追問 + 結構化輸出」，目標是在項目裏生成或更新帶分鏡表的 video-spec.md，並可與 HyperFrames 等渲染鏈路銜接。
這是什麼¶
視頻規格構建器是面向 AI Agent 的 SKILL.md 技能包，座標 @user_3c6cb52e/video-spec-builder，版本 1.0.0，來源爲 community，發佈者 user_3c6cb52e，分類 ai-agent。SkillHub 頁面簡介爲：視頻規格構建器專用技能，幫助 AI Agent 高效完成相關任務。標籤 requires_api_key=false，安裝本 Skill 本身不強制 API Key。
在 SkillHub 上，該 Skill 評分 100000，下載 1229 次（頁面數據以 SkillHub 爲準）。包內聲明兼容 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy，平臺屬性爲 multi-platform。SKILL 元數據中的 homepage / repository 指向 GitHub 用戶 1991513ccie-png。
核心功能¶
以下能力均來自已發佈的 SKILL.md 正文，不展開未隨包提供的 references/ 文件細節。
兩種工作模式¶
- 0-1 模式：通過對話收集視頻需求，主動說明渲染側可用能力，把需求追到「鏡頭粒度」，輸出含分鏡表的
video-spec.md。 - 迭代模式：用戶已有
video-spec.md並提出改鏡頭、節奏、音樂、字幕、配色等變更時，追問澄清、做衝突檢測並更新文檔。
啓動檢查¶
Agent 啓動後按規則掃描項目目錄：
- 精確匹配
video-spec.md，或模糊匹配*video-spec*.md、*分鏡*.md、*storyboard*.md。 - 找到 1 個 → 迭代模式；多個 → 讓用戶選定文件；未找到 → 0-1 模式。
- 可選檢查項目根目錄是否存在
design.md/DESIGN.md（視覺主題相關，啓動時不強制）。
對話與輸出原則¶
Skill 強調「能力優先」（用畫面描述而非堆技術名）、信息密度（避免空幀、約束鏡頭時長）、聯網覈實（參考片、平臺慣例、工具版本等）。內置 能力對照表，覆蓋 TTS 配音、Whisper 字幕、摳像、各類動效與 3D、shader 轉場、畫幅與幀率等觸發條件。
結構化輸出按 templates/video-spec-template.md 的約定（模板路徑寫在 SKILL 中；當前 SkillHub 下載包僅含 SKILL.md 與 _meta.json，若本地無 references/ 與 templates/，Agent 只能依據 SKILL 正文執行，完整工作流以作者完整倉庫爲準）。
與 HyperFrames 的關係¶
Skill 描述的項目樹中，渲染端爲 HyperFrames（示例路徑 .agents/skills/hyperframes/，需另行安裝）。video-spec.md 生成或更新後，Skill 要求 Agent 提示用戶是否用 /hyperframes 啓動渲染，由渲染端讀取 spec，Skill 本身不再介入渲染細節。
安裝與啓用¶
先按 SkillHub 安裝說明 準備 skillhub CLI；未安裝時可執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別：
skillhub install video-spec-builder --namespace user_3c6cb52e --dir <你的 Agent skills 目錄>
SkillHub 文檔給出的常見 skills 路徑示例：
| 環境 | 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
官方頁面亦提示：可將 https://skillhub.cn/install/skillhub.md 交給 AI，讓其安裝 @user_3c6cb52e/video-spec-builder。安裝或更新後按所用客戶端要求重啓或刷新技能列表。
典型用法¶
用法是「啓用 Skill → 用自然語言描述視頻或修改意圖 → Agent 按模式追問 → 落盤 video-spec.md」。可復現的流程要點如下。
- 在已安裝 Skill 的項目或工作區中，說明想做的視頻類型（宣傳片、產品演示、短視頻等）或要改的 spec 內容。
- Agent 執行啓動檢查，進入 0-1 或迭代模式，並按 SKILL 要求加載對應的
references/workflow-0-1.md或references/workflow-iteration.md（若本地包內無這些文件，需自行補齊作者提供的完整技能目錄）。 - 對話中 Agent 對照 question-bank 紀律追問：Phase 1 七維爲 gate，後續 Phase 按視頻類型裁剪；不接受「高大上」等空形容詞，推斷內容須標
[待用戶確認]。 - 信息充足後，按模板寫出或更新項目根目錄（與 spec 同基準路徑）下的
video-spec.md；若走自定義視覺主題，可能在根目錄生成或引用design.md（及可選tokens.css），或選用 HyperFrames 八種預設主題名寫入 spec。 - 完成後 Agent 應告知 spec 已生成/更新，並詢問是否啓動 HyperFrames（
/hyperframes）。
Skill 初始化時會輸出固定 ASCII 標識與開場白，隨後執行啓動檢查——這是 SKILL 規定的 Agent 行爲，而非終端命令。
適用場景與注意¶
適合：需要 Agent 長期扮演「分鏡策劃」，把模糊 brief 拆成可執行 spec、並統一記錄平臺、素材、節奏與組件 ID 的團隊或個人；計劃接 HyperFrames 或同類「讀 spec 再渲染」流水線的項目。
注意：
- SkillHub 當前下載包體極小，SKILL 內引用的
references/、templates/、examples/在包內可能不存在，實際效果取決於你是否部署完整技能樹。 - 渲染、TTS、3D 等能力是對下游渲染層的描述與激發用戶選項，不等於本 Skill 自帶可執行二進制；做不到的能力 SKILL 要求直接說明。
requires_api_key=false僅指 Skill 安裝層面；若後續渲染或聯網搜索依賴外部服務，仍需各自配置密鑰或環境。- 與同名變體（如
video-spec-builder-y7x1）不同，本文僅對應座標@user_3c6cb52e/video-spec-builder，安裝時注意 namespace 與 slug。
結尾¶
視頻規格構建器把「寫腳本」變成「追到鏡頭級並輸出 video-spec.md」的 Agent 工作流，適合作爲視頻前期 spec 階段的技能約束。安裝與詳情見 SkillHub：視頻規格構建器，API 座標頁：api.skillhub.cn/user_3c6cb52e/video-spec-builder。
