前言¶
在业务里接入腾讯云点播（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
