前言¶
在智能體裏做「文生視頻」，常見做法是反覆查即夢（Dreamina）文檔、自己拼 dreamina 子命令和輪詢邏輯。視頻任務比文生圖慢，參數（時長、分辨率、模型版本）也容易填錯，提交後還要查積分、查任務狀態、處理會話。下面介紹 SkillHub 上的社區 Skill「即夢-文生視頻 CLI 技能」，它把上述流程寫成 Agent 可遵循的 SKILL.md 指引，在用戶提到 dreamina text2video、命令行生視頻 或要提交/執行視頻提示詞時，由智能體按規範調用 CLI。
這是什麼¶
即夢-文生視頻 CLI 技能，讓你的智能體通過 即夢 CLI 生成視頻（座標 @user_c1d16043/jimeng-cli-text2video，當前版本 v1.0.3，來源 community，發佈者 user_c1d16043）是一份面向開發場景的 Agent Skill（分類 dev-programming）。它不替代 dreamina 可執行文件本身，而是在智能體側提供：如何通過 dreamina CLI 對接即夢 Seedance 2.0 文生視頻、如何選參、如何輪詢與排錯。
SkillHub 頁面標註作者爲 Loong10K；技能標籤爲 requires_api_key=false（指安裝該 Skill 本身不額外要求 API Key 類配置，具體以你本機 dreamina CLI 的登錄與鑑權爲準）。
核心功能¶
依據 SkillHub 簡介與已抓取說明，該 Skill 覆蓋的能力包括：
- 文生視頻執行指引：面向即夢 Seedance 2.0，指導通過命令行完成文本生成視頻（觸發詞包括
dreamina text2video、生成視頻、提交或執行視頻提示詞等）。 - 視頻專用參數說明：
duration、video_resolution、model_version等選項的參考；CLI 側視頻默認使用 720P 分辨率，時長支持 4–15 秒。 - 模型選擇說明：Seedance 2.0 在速度與生成分辨質量之間的取捨說明（供智能體幫用戶選型）。
- 標準工作流：文檔中歸納 4 種常見視頻執行流程（具體步驟以安裝後的 SKILL.md 爲準）。
- 異步任務與運維：建議輪詢時間比圖片更長（60–180 秒）；並覆蓋積分查詢、任務查詢、session 管理，以及基於官方文檔的錯誤處理模式。
用戶線索中的英文簡介還提到通過 dreamina text2video 進行提交、輪詢與故障排查，以及會話與異步終態狀態——與上述「任務查詢 / session / 輪詢」表述一致；未在 SkillHub 公開簡介中出現的 CLI 小版本號或比例校驗細節，本文不展開。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（推薦）或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
說明：在受限網絡環境下，安裝腳本需要允許訪問外網。
2. 安裝本 Skill¶
SkillHub 頁面給出的安裝提示爲：根據 SkillHub 安裝說明 安裝座標 @user_c1d16043/jimeng-cli-text2video。
命令行方式示例（--dir 必須指向當前 Agent 實際使用的 skills 目錄，否則可能裝到默認 ./skills/ 而未被加載）：
skillhub install @user_c1d16043/jimeng-cli-text2video --dir <你的 Agent skills 目錄>
常見目錄（來自 SkillHub 安裝文檔，按你使用的客戶端選用）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後，按你所用 Agent 的要求重啓或刷新技能列表，使 SKILL.md 生效。
3. 前置依賴¶
本 Skill 假定你已在環境中配置並可調用 dreamina CLI（即夢命令行）。視頻生成、登錄與計費以 CLI 與即夢官方文檔爲準；Skill 負責讓智能體「按正確流程」使用 text2video 相關能力，而不是代替 CLI 安裝。
典型用法¶
安裝後，智能體在匹配場景時會讀取 Skill 內的流程與參數表。從公開簡介可復現的使用模式如下（具體子命令與標誌位以 SKILL.md 與官方 CLI 文檔爲準）：
- 提交視頻任務：用戶給出已審覈的文本提示詞，智能體按 Skill 選擇 Seedance 2.0 與
duration（4–15 秒）、video_resolution（720P）、model_version等，通過dreamina text2video相關命令提交。 - 輪詢結果：視頻生成耗時通常長於圖片；按 Skill 建議，輪詢間隔或總等待宜落在 60–180 秒量級，並查詢異步任務狀態直至成功或明確失敗。
- 輔助操作：需要時查詢積分、按任務 ID 查詢進度，或在多輪對話中維護 session，避免重複登錄或參數丟失。
- 排錯：參數不合法（如時長超出 4–15 秒）、分辨率不符合要求、或任務終態異常時，按 Skill 中的錯誤處理模式對照官方說明調整。
你無需手寫上述 checklist；在對話中直接說明「用命令行給即夢生成一段 N 秒視頻」或引用 dreamina text2video，Agent 應自動加載本 Skill。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的客戶端，希望智能體穩定走 CLI 文生視頻 而非臨時猜命令的開發者。
- 需要即夢 Seedance 2.0、固定 720P 與 4–15 秒時長約束下的批量或腳本化嘗試（由 Agent 代勞命令拼裝與輪詢）。
限制與注意
- 視頻任務慢：務必按 Skill 建議拉長輪詢，避免過早判定失敗。
- Skill 版本爲 v1.0.3，SkillHub 統計（以頁面與抓取爲準）：評分 100000，下載 4219，安裝計數 0——安裝數可能未回傳，以你本機
--dir是否裝對爲準。 - 分類爲 dev-programming，側重開發與自動化，不承諾替代即夢產品內的全部 UI 能力。
- 公開資料未列出各客戶端差異配置時，僅按 SkillHub 通用
--dir方式安裝即可。
結尾¶
若你希望智能體在提到即夢命令行生視頻時，自動覆蓋 Seedance 2.0 參數、輪詢時長、任務與會話管理，可在 SkillHub 安裝 @user_c1d16043/jimeng-cli-text2video。官方入口：SkillHub 技能頁，API 座標頁：https://api.skillhub.cn/user_c1d16043/jimeng-cli-text2video。
