生成播客剪辑

使用此技能通过 Subscut 的 /podcast-to-clips API 将长篇口语视频转换为多个短视频剪辑。

该技能的功能

此技能是 API 返回结果的有明确倾向性的封装：

• 从长篇视频中提取最多 20 个高质量短剪辑
• 优先选择具有病毒传播潜力和高留存率的口语片段
• 添加可选样式的字幕
• 支持两种渲染格式：dynamic（自动重新构图）和 hook_frame（保留原始画面 + 标题卡）
• 返回剪辑标题、评分以及渲染后的剪辑 URL

以结果为导向，而非传输方式：

• 好的表述：“从这个播客中提取适合短视频传播的内容”
• 差的表述：“调用某个视频 API”

适用场景

在以下情况使用此技能：

• 输入内容为长篇播客、访谈、网络研讨会或单人出镜视频
• 用户希望实现增长、内容再利用、制作短视频、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 入口

技能安装后，代理运行时应调用内置的 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

默认基础地址：

• https://subscut.com

安装说明

此技能由 Subscut 发布一次，随后用户可通过市场平台安装使用。

终端用户流程：

1. 从 ClawHub / OpenClaw 安装已发布的技能。
2. 设置 SUBSCUT_API_KEY。
3. 让代理在需要将长篇口语视频转为短剪辑时调用该技能。

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

代理工作流

1. 确认源视频为长篇口语类内容。
2. 优先使用 CLI 包装器，而非手动编写 curl 请求。
3. 除非用户明确要求自定义剪辑数量、时长、样式或格式，否则保持请求简单。
4. format 默认设为 dynamic，除非用户明确希望使用标题卡（即 hook_frame）。
5. 返回生成的剪辑 URL、标题、评分及时间戳。
6. 若 API 调用失败，清晰展示状态码和响应体。
7. 若下游流程涉及公开发布，应在最终发布前保留人工审核环节。

自然语言触发词

可能映射到此技能的用户意图包括：

• “把这个播客变成 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 分钟的视频会自动限制为最多 2 个剪辑，不受 max_clips 影响。
• 脚本通过技能本地的 npm 脚本执行。
• 该技能设计为有明确倾向性，参数界面保持简洁，便于代理高效使用。
• 此包仅用于安装与运行时使用，不包含发布者专用部署步骤。