生成播客短视频片段

使用此技能，可通过 Subscut 的 /podcast-to-clips API 将长时长语音视频自动转换为多个短视频片段。

该技能的功能说明

本技能是对 API 输出结果进行有明确设计倾向的封装：

• 从长时长视频中提取最多 20 个高质量短视频片段
• 优先选取具备“病毒式传播潜力”和高用户留存率的语音内容片段
• 自动添加字幕，并支持多种可选样式
• 支持两种渲染格式：dynamic（自动重构画面）与 hook_frame（保留原始画幅 + 顶部标题卡）
• 返回每个片段的标题、置信度得分及已渲染完成的视频 URL

请以“输出结果”为导向思考，而非关注底层传输机制：

• 良好表述示例：“从此播客中提取具有病毒传播潜力的短视频内容”
• 不良表述示例：“调用某个视频 API”

适用场景

当满足以下任一条件时，请使用该技能：

• 输入源为长时长播客、访谈、网络研讨会或出镜讲话类视频
• 用户目标为增长粉丝、内容二次分发、制作 Shorts/Reels/TikTok 等短视频
• 用户希望尽可能减少手动剪辑工作量

请避免使用该技能的情况：

• 原始素材本身已是短时长内容
• 视频内容以非语音为主（如纯音乐、画面演示、无对白旁白等）
• 用户需要逐帧精细控制、进行人工编辑决策

切勿将其用作通用视频编辑工具。

输入契约

在规划或解释工具调用时，请使用如下紧凑的输入结构：

{
  "video_url": "https://example.com/video.mp4",
  "max_clips": 5,
  "style": "viral",
  "format": "dynamic",
  "captions": true,
  "clip_duration": {
    "min": 20,
    "max": 60
  }
}

字段参考

字幕样式（style）

渲染格式（format）

当原始视频已是竖屏格式，或用户希望标题信息显著展示时，请使用 hook_frame； 对于横屏/宽屏类播客（含一位或两位主讲人），推荐使用默认的 dynamic 格式。

输出契约

预期返回如下结构的 JSON 数据：

{
  "clips": [
    {
      "video_url": "https://...",
      "title": "为何大多数创始人在此处犯错",
      "score": 0.92,
      "start": 142.5,
      "end": 198.3
    }
  ]
}

score 是一个 0–1 范围内的浮点数，表示该片段具备“病毒传播潜力”的置信度，数值越高越好。

CLI 入口命令

技能安装完成后，Agent 运行时应调用其内置的 CLI 封装脚本：

npm --prefix .agents/skills/generate-podcast-clips run generate-podcast-clips -- 
  --video-url "https://example.com/podcast.mp4" 
  --max-clips 5 
  --clip-style viral 
  --format dynamic 
  --captions true 
  --min-clip-duration 20 
  --max-clip-duration 60

必需的环境变量：

• SUBSCUT_API_KEY 或通过 --api-key 参数传入

默认基础 URL：

• https://subscut.com

模型安装方式

本技能由 Subscut 统一发布一次，用户通过市场平台（如 ClawHub / OpenClaw）安装使用。

终端用户操作流程：

1. 从 ClawHub / OpenClaw 安装已发布的技能包。
2. 配置环境变量 SUBSCUT_API_KEY。
3. 当 Agent 需要将长时长语音视频转为短视频片段时，自动调用该技能。

该技能不应要求用户自行发布或打包任何内容。

Agent 工作流

1. 首先确认输入源确为长时长语音类视频。
2. 优先使用 CLI 封装脚本，而非手写 curl 请求。
3. 除非用户明确指定片段数量、时长范围、字幕样式或渲染格式，否则保持请求参数简洁。
4. 若用户未特别要求标题卡效果，则 format 默认设为 dynamic；仅当用户明确需要顶部标题卡时，才设为 hook_frame。
5. 返回所有生成片段的 URL、标题、置信度得分及时间戳（start/end）。
6. 若 API 调用失败，请清晰透出 HTTP 状态码及响应体内容。
7. 若下游流程涉及公开发布（如直接发布至社交媒体），请确保人工审核环节介入后再执行最终发布。

自然语言触发词

以下用户意图应映射至本技能：

• “把这期播客转成 Instagram Reels”
• “从这场访谈中制作短视频”
• “将我的长视频重新剪辑为多个短视频片段”
• “找出这期播客中最具传播力的片段”
• “为本期节目生成 YouTube Shorts”
• “生成带顶部标题卡的短视频片段”
• “给我配上简洁字幕的短视频片段”
• “从这场网络研讨会中提取 10 个短视频片段”

备注

• API 接口路径为 POST /podcast-to-clips。
• style 字段直接映射至 API 的 style 参数；CLI 中对应标志为 --clip-style。
• format 控制渲染布局：可选 dynamic（默认）或 hook_frame。
• clip_duration.min 和 clip_duration.max 允许调用方设定片段时长区间。
• 对于时长 ≤3 分钟的短视频，无论 max_clips 如何设置，系统均自动限制最多生成 2 个片段。
• 脚本通过技能本地的 npm 脚本执行。
• 本技能设计上具有明确倾向性（opinionated），参数表面积极小，旨在提升 Agent 使用体验。
• 本软件包面向安装与运行时使用，不包含仅供发布者使用的部署步骤。