byted-mediakit-voiceover-editing

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: byted-mediakit-voiceover-editing
display_name: 口播视频智能精剪工具
version: 1.0.7
description: |
  Volcano Engine AI MediaKit voiceover-editing Skill: an end-to-end workflow for cutting talking-head / voiceover content. Covers environment setup, media asset management, audio processing, voiceover editing, video export, review UI, and self-iteration. You MUST invoke this Skill when the user mentions voiceover editing, cutting voiceover video, removing pauses, processing audio, exporting voiceover output, auto-editing, removing verbal slips, or video editing in this sense—or the Chinese phrases 口播剪辑, 剪口播, 剪视频, 去掉停顿, 处理音频, 导出口播, 自动剪辑, 去除口误, 视频剪辑. Also invoke when the user uploads video or audio and requests editing.
category: 音视频处理
env:
  - name: VOLC_ACCESS_KEY_ID
    description: 火山引擎访问密钥ID，需开通VOD服务权限
    required: true
    secret: true
    default: ''
  - name: VOLC_ACCESS_KEY_SECRET
    description: 火山引擎访问密钥Secret
    required: true
    secret: true
    default: ''
  - name: VOLC_SPACE_NAME
    description: 火山引擎VOD存储空间名称
    required: true
    secret: false
    default: ''
  - name: ASR_API_KEY
    description: 语音识别服务API密钥
    required: true
    secret: true
    default: ''
  - name: ASR_BASE_URL
    description: 语音识别服务接口地址
    required: true
    secret: false
    default: 'https://openspeech.bytedance.com/api/v3/auc/bigmodel'
  - name: VOD_EXPORT_SKIP_SUBTITLE
    description: 导出时是否跳过字幕压制（默认跳过；0/false/no 表示启用字幕压制）
    required: false
    secret: false
    default: '1'
  - name: TALKING_VIDEO_AUTO_EDIT_REVIEW_AUTO_OPEN
    description: 审核页启动时是否自动打开浏览器（默认不打开；1/true/yes 表示打开）
    required: false
    secret: false
    default: '0'
  - name: TALKING_VIDEO_AUTO_EDIT_VIDEO_CUT
    description: 是否开启视频裁剪功能：1 进行（默认）；0 不进行。仅当有字幕或音频静音时生效。
    required: false
    secret: false
    default: '1'
permissions:
  - network
  - file_read
  - file_write
  - temp_storage
triggers:
  - 口播剪辑
  - 剪口播
  - 剪视频
  - 去掉停顿
  - 处理音频
  - 导出口播
  - 自动剪辑
  - 去除口误
  - 视频剪辑
---

> ⚠️ **凭据与安全（必读）**
>
> - **能力范围**：`VOLC_ACCESS_KEY_ID` / `VOLC_ACCESS_KEY_SECRET` / `VOLC_SPACE_NAME` 用于火山引擎视频点播（上传、媒资、导出等）；`ASR_API_KEY` / `ASR_BASE_URL` 用于豆包语音大模型转写。与 VOD + ASR 流程一致。
> - **最小权限与隔离**：在控制台创建**仅含所需 API 权限**的访问密钥；**勿**将生产主账号密钥用于本技能。测试与开发请使用**独立点播空间**与专用子账号/密钥，避免误操作生产媒资。
> - **本地 `.env`**：技能从 `<SKILL_DIR>/.env` 读取配置（`setup.sh` 可在缺失时从 `templates/env.md` **生成空壳文件**）。**密钥须由用户在本地手工填入**；Agent **不得**在对话或仓库中写入真实 Secret，亦不得将 `.env` 提交到版本库。请保持 `.gitignore` 忽略 `.env`（若仓库尚无则在本技能目录补充）。

---

> ⚠️ **STRICT EXECUTION RULES — NO EXCEPTIONS**
>
> - Use ONLY the scripts listed below. Creating new scripts is FORBIDDEN.
> - Execute ALL steps IN ORDER. Skipping any step is a task FAILURE.
> - **SKILL_DIR**：指 `byted-mediakit-voiceover-editing` 目录路径
> - **Output-dir**：执行任何需要 `--output-dir` 的命令前，**必须**按「从上下文推导 output-dir」规则先行推断，减少用户重复输入, 默认值为 `<SKILL_DIR>`往上数三级，如
>   - `<SKILL_DIR>` 为： `./xx/skills/byted-mediakit-voiceover-editing` ，
>   - `Output-dir` 则默认值为 `./output` 即**./xx 的上级**。
> - Always `cd <SKILL_DIR>/scripts` before running any command in this Skill.
> - At each CHECKPOINT, verify output before proceeding.
> - If any step fails, HALT immediately and report to the user. Do NOT continue.

> - **禁止简化版**：Step 4/5/6 的所有输出必须完整、符合规范；**严禁**输出「简化版」「占位符」「示例」或省略内容以绕过问题。
> - **审核页是否自动打开由 TALKING_VIDEO_AUTO_EDIT_REVIEW_AUTO_OPEN 决定（强制）**：默认不打开；`.env` 中 `TALKING_VIDEO_AUTO_EDIT_REVIEW_AUTO_OPEN=1`（或 `true`/`yes`）时打开。Agent 不得额外执行 `open`、`start`、`xdg-open` 等命令，以脚本行为为准；可加 `--no-open` 覆盖。
> - **最终输出输出结果，必须保持原样，不能做任何修改**
> - **超时时间**： 音视频处理时长较长，请把**宿主超时时间设置为 60 分钟**

---

> ⚠️ **职责分工（重要）**
>
> | 组件                 | 职责                                                             | 不做                  |
> | -------------------- | ---------------------------------------------------------------- | --------------------- |
> | **脚本（规则引擎）** | ASR 准确率优化、口播剪辑候选生成（标记位置+规则置信度+删除建议） | 不做最终删除/保留决策 |
> | **宿主 Agent（你）** | 语义断句、口癖识别确认、候选复核、最终删除/保留决策              | 不修改脚本            |
>
> **核心原则：脚本提供候选（含删除建议 deleted_par