前言¶
在業務裏接入騰訊雲點播（VOD）的 AIGC 能力時，常見工作包括：選對生圖、生視頻、自定義主體、自定義音色等接口，按文檔拼請求參數，輪詢或回調裏查任務狀態，再對照官方 SDK 寫示例代碼。文檔分散、異步任務鏈路長，容易在簽名、字段名和回調處理上反覆查資料。
下面介紹 SkillHub 上的 Tencent VOD AIGC code helper（座標 @tencent-adm/tencent-vod-aigc-code-helper）。它面向「在 Agent 裏完成 VOD AIGC 對接」這一件事：把官方能力範圍寫進 Skill，讓對話式開發時少翻文檔、少猜接口細節。
這是什麼¶
Tencent VOD AIGC code helper 是騰訊雲點播 VOD AIGC 接口對接助手。SkillHub 標註來源爲 enterprise，發佈者爲騰訊視頻雲 MPaaS 團隊，當前版本 1.0.1，分類爲 dev-programming。
Skill 簡介寫明：幫助用戶調用 AIGC API（生圖、生視頻、主體、音色），查詢任務狀態，處理回調，並提供 SDK 示例代碼。標籤 requires_api_key=true，表示對接真實雲 API 時需要有效的騰訊雲密鑰或等價憑證，具體字段以 Skill 內說明與騰訊雲控制台爲準。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在資料中出現的接口名或參數不寫進正文。
- AIGC API 調用：覆蓋生圖、生視頻，以及自定義主體、自定義音色等相關對接場景。
- 任務狀態查詢：異步生成類任務完成後纔可用，Skill 側引導查詢任務狀態，避免只發請求不跟結果。
- 回調事件處理：對接服務端回調時的解析與處理思路，減少自行摸索事件格式的時間。
- SDK 示例代碼：結合騰訊雲 SDK 的示例寫法，便於在現有工程裏落地。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，通過 SkillHub CLI 安裝到當前 Agent 的 skills 目錄；裝錯目錄時 Agent 可能識別不到，需要按環境選對路徑。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已安裝：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需要 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄。以 Cursor 爲例，常用路徑爲 ~/.cursor/skills/：
skillhub install @tencent-adm/tencent-vod-aigc-code-helper --dir ~/.cursor/skills/
其他客戶端路徑以 SkillHub 安裝說明 爲準，例如 Claude Code 爲 ~/.claude/skills/，Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/。
3、通過對話讓 Agent 安裝¶
SkillHub 頁面提供的安裝提示詞爲：請 Agent 根據 https://skillhub.cn/install/skillhub.md 安裝 @tencent-adm/tencent-vod-aigc-code-helper。適合本地未裝 CLI、或希望由 Agent 按文檔逐步執行的場景。
安裝完成後，在 Cursor 等支持 Skills 的客戶端中啓用或刷新技能列表（具體以各客戶端文檔爲準），再在對話中說明你要對接的 VOD AIGC 能力即可。
典型用法¶
資料未附帶完整可複製的業務代碼片段，典型用法以「安裝 Skill + 自然語言任務描述」爲主，與官方簡介一致。
- 確認已在騰訊雲開通點播 VOD 及所需 AIGC 能力，並準備好 API 密鑰（Skill 標記需要 API Key）。
- 在 Agent 中說明目標，例如：調用生圖或生視頻接口、創建或引用自定義主體/音色、根據任務 ID 查詢狀態、編寫或校對回調處理邏輯、生成某語言騰訊雲 SDK 的調用示例。
- 按 Agent 給出的步驟在項目中實現；涉及密鑰時勿提交到版本庫，沿用團隊現有的密鑰管理方式。
經過上面的步驟，Skill 的價值在於把 VOD AIGC 對接的常見子任務收斂到一次對話裏，而不是替代騰訊雲官方文檔與控制台配置。
適用場景與注意¶
適合誰：需要在應用或服務中對接騰訊雲點播 AIGC、且使用 Cursor、Claude Code、Codex 等支持 SkillHub Skills 的開發者。
使用注意：
- 對接生產環境前，請在騰訊雲控制台確認產品與計費、配額及地域限制；Skill 不替代賬號側開通與權限配置。
requires_api_key=true：未配置合法密鑰時，生成代碼也無法成功調用雲端接口。- SkillHub 頁面統計（截至資料抓取）：評分 100000，下載約 1862 次；安裝數等以 SkillHub 實時展示爲準。
- 版本以 SkillHub 爲準（當前 1.0.1）；升級可用
skillhub對應 update 流程，並繼續指定正確的--dir。
結尾¶
Tencent VOD AIGC code helper 把騰訊雲點播 VOD 的 AIGC 對接——API 調用、任務查詢、回調與 SDK 示例——整理成面向 Agent 的技能包，由騰訊視頻雲 MPaaS 團隊在 SkillHub 發佈。若你正在做 VOD 生圖、生視頻或主體/音色相關集成，可從官方頁獲取座標與安裝方式：
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/tencent-vod-aigc-code-helper
- API 索引：https://api.skillhub.cn/tencent-adm/tencent-vod-aigc-code-helper
