branch-video-agent-cli
Installation
SKILL.md
图片持久任务（CLI 0.4.5+）
- 图片生成/编辑默认采用
ai-gateway image-generate --wait --raw/image-edit --wait --raw，stdin 提供稳定idempotencyKey（生产任务 + 资产 revision）。先确认服务端已部署图片任务 API；不自动回退同步提交。 - 只提交不等待用
--async；提交前保存幂等身份，stderr 的 taskId 回执须保留。stdout 始终为单个 JSON。 - 丢失提交回执时，用同项目 token 执行
image-get，输入idempotencyKey；拿到 taskId 后按 taskId 查询。原参数同键重提只找回同一任务，不换新 key。 - 超时、Ctrl+C、
waitStopped只表示本地停止等待；继续查询原任务。unknown/RECONCILIATION_REQUIRED需要核对真实上游记录和费用，禁止自动重新生图。 - 成功结果
data[].url是 BV 鉴权下载地址，使用同项目 Bearer 下载后走既有资产上传流程；不要把此 URL 当作公开 CDN 素材。 - 完整契约、输入限制和编辑参数见 图片异步任务。旧同步方式只用于显式兼容，不用于长耗时生产请求。
Provider simulation
scripts/stage09_publish_transaction.py --execution-mode provider_simulation 在正式脚本读取和校验后使用进程内 deterministic backend，不启动 BranchVideo CLI，不创建或发布真实项目。缺省仍为 production，两个 mode 的 durable state 不可混用；simulation project/version/URL 只表示 build-and-check 仿真结果。
此 skill 用于通过通用 Agent CLI 调用分支互动视频业务能力，而不是手写底层 HTTP 请求。
正式 Stage09 在任何发布调用前校验 V3 结构、更新并回读同一草稿项目，再实时执行一次现有 playtest run；只有本次命令和标准 JSON 报告均为 passed 才发布。
每次 Stage09 调用还必须显式提供绝对 --publish-domain-node、--publish-domain-helper、各自预期 SHA-256，以及持久 --publish-domain-work-root。事务现场调用这一个 builder helper 规范化完整 script+productionData request，并用同一 helper 检查 published script+productionData+playUrl；不得从 PATH 猜 Node，也不得复制旧域列表或相信外部手写 receipt。