Deep Video Converter Skill

Deep Video Converter Tool · Deploy & Operate Skill

**"深度视频转换器"类工具的通用部署/运维 Agent Skill** —— 让 AI 助手能一键完成这类工具的定位、环境搭建、启动、五种特效模式的使用、免浏览器验证与故障排查。

本技能是**通用模式**，不绑定任何特定 GitHub 仓库/主项目。目标项目由使用者提供（自己的 clone、fork 或已有目录），skill 按约定结构识别并操作。

这是什么

本仓库遵循 **Agent Skills（SKILL.md）开放标准**（顶层 `SKILL.md` + `references/`），凡是支持该标准的 agent 都能直接识别使用。已兼容：

• Claude Code → ~/.claude/skills/
• OpenAI Codex CLI → ~/.codex/skills/
• WorkBuddy → ~/.workbuddy/skills/
• 其他 SKILL.md 标准实现（Cursor、OpenClaw 等）

操作对象的结构约定

skill 面向满足以下布局的"深度视频转换器"项目：

<你的项目>/
├── backend/app.py + pipeline.py + face_worker.py + config.py   # Flask + 双环境编排
├── frontend/index.html                                          # 单页 UI
├── scripts/setup.sh|bat  run.sh|bat  run_e2e_all.py  recomposite_test.py
├── models/            # 权重（通常不入库，setup 下载）
├── venvs/env-main     # torch/transformers/opencv/flask（py3.12）
├── venvs/env-face     # mediapipe（py3.11，进程隔离）
└── jobs/              # 每任务中间帧与结果

skill 触发后按流程执行：**定位项目 → 一键 setup（双 venv + 模型）→ 启动 `http://localhost:8000` → 五种模式使用 → 免浏览器验证 → 排障**。

安装

按所用 agent 选择用户级技能目录（所有项目通用）：

# Claude Code
git clone https://github.com/tututashu/deep-video-converter-skill.git ~/.claude/skills/deep-video-converter

# Codex CLI
git clone https://github.com/tututashu/deep-video-converter-skill.git ~/.codex/skills/deep-video-converter

# WorkBuddy
git clone https://github.com/tututashu/deep-video-converter-skill.git ~/.workbuddy/skills/deep-video-converter

或从 [Releases](https://github.com/tututashu/deep-video-converter-skill/releases) 下载 `deep-video-converter.zip`，解压后把 `deep-video-converter/` 文件夹放到上述任一技能目录。

使用方式

1. 打开 agent 会话，进入你的 deep-video-converter 项目目录（或把路径告诉 agent）
2. 提问触发，例如："启动深度视频转换器"、"帮我把这个项目跑起来"、"跑一下 CLI 端到端验证"、"人脸点云是空的，查一下"
3. agent 自动加载本 skill：先做环境预检（Python 3.11/3.12、ffmpeg），再按结构定位你的项目并执行对应流程

**没有代码时的一键安装**：若你手头没有该项目代码，skill 内置一个**可配置默认源**（`git clone https://github.com/tututashu/deep-video-converter.git`），agent 会用它自动克隆后