mcpField
B
blitzreels-editing

blitzreels-editing

github.com/blitzreels创意与媒体450 次安装6 周前更新
代码仓库

关于 blitzreels-editing

用于通过 CLI 或 REST 编辑 BlitzReels 项目的技能，涵盖安全修改、验证、故障恢复和导出流程。

主要功能

  1. 01选择 CLI 或 REST 操作方式
  2. 02检查限定范围的时间线内容
  3. 03高风险编辑前预览
  4. 04修改后核对状态与画面
  5. 05检查导出状态

适用场景

  1. 01编辑时间线剪切和字幕
  2. 02放置媒体与可编辑文本
  3. 03处理过期 ID 或部分失败

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/blitzreels/agent-skills --skill blitzreels-editing

安装后在 Claude Code 中输入/blitzreels-editing确认已加载。

附带文件evals/evals.json

详细介绍

BlitzReels 编辑

将 CLI 和 REST 视为同一项目编辑的两种执行路径。 直接操作工作区时使用已安装的 CLI；进行集成或明确的 API 操作时使用 REST。

工作流

  1. 选择操作方式。
    • CLI：确认 command -v blitzreels，然后使用 agent-context --command 检查确切命令。
    • REST：加载能力索引，然后仅检查所需的 OpenAPI 操作。
    • 如果没有 CLI，且公共契约支持该编辑，则通过 REST 继续。
  2. 在选择 ID 之前，读取项目和范围受限的时间线内容。 仅加载受影响区间内的字幕词或媒体。
  3. 选择涵盖完整更改的最高级操作。
    • 移除语音：使用带字幕波纹调整的时间线剪切。
    • 修正字幕：编辑词语文本、合并、拆分、删除、调整时间或修补字幕块。
    • 放置视觉素材：优先使用放置预设插入媒体或进行变换。
    • 可编辑文本：使用内容项。
  4. 使用 dry run 或计划预览有风险的写入操作。 传递确认标志前，先检查具有破坏性的输出。
  5. 如果契约支持，则使用幂等键进行修改。
  6. 重新读取受影响的状态，并渲染每个更改区间的帧。
  7. 仅在完成视觉验证并获准进行付费渲染后，才启动导出。 轮询直至导出成功结束，并验证输出可检索。

CLI 发现

blitzreels agent-context --command "timeline cut" --json
blitzreels agent-context --command "captions words list" --json
blitzreels agent-context --command "media attach" --json
blitzreels agent-context --command "project snapshots" --json

仅在需要深入的词级元数据时使用 project inspect --mode full。

恢复

  • 遇到过期 ID 或冲突时，放弃待处理的编辑，刷新上下文，然后重新选择目标。
  • 部分失败时，逐一核对所有项目，并在验证后仅重试失败的项目。
  • 如果 API 调用可能已到达服务端，重试前先读取当前状态。
  • 附加已转录媒体后，先刷新时间线再添加图层，因为字幕可能会重叠。

完成

返回所用操作方式、受影响的 ID、修改回执、警告、预览证据和导出状态。 只有后续读取和渲染帧能证明已达到所需状态，编辑才算完成。

评论

支持 Markdown