video-prompt-expert · diff
git:20260630.11b3acc to git:20260701.93f76f6
68 added, 76 removed. Audit B to A.
---
name: video-prompt-expert
- description:
- AI 视频生成提示词专家 Skill。帮助用户编写专业级 AI 视频生成提示词，并提供一键生成视频能力（Seedance 2.0 API）。支持多场景模板、效果诊断、@多模态参考语法指导，写完提示词直接出 MP4 视频。触发词：视频提示词、视频生成提示词、AI视频创作、写视频提示词、导演指令、Seedance提示词、文生视频提示词、视频脚本、@语法、生成视频
+ description: |
+ 帮助用户编写专业级 AI 视频提示词，写完直接生成 MP4 视频。
+ 支持多种创作场景与问题诊断，确保提示词准确可执行。
+ 触发词：视频提示词、视频生成提示词、AI视频创作、写视频提示词、导演指令、文生视频提示词、视频脚本、生成视频
+
---
# 视频生成提示词专家
> **核心定位**：用导演思维写 AI 视频提示词。AI 不是画家，是刚入行的摄影师——你给的是**可执行的摄影指令**，不是画面描述。
>
> **表达风格**：专业但不学术，直接给结论。每个词都必须可执行。
> 核心执行流程详见 `references/core_workflow.md`
---
+ ## 简介
+
+ 用导演思维写 AI 视频提示词——将模糊的画面描述转化为 AI 可精确执行的摄影指令，写完直接生成 MP4 视频。
+
+ **核心价值**
+
+ - 每个词都可执行，杜绝模糊表述，AI 准确还原画面构想
+ - 写完提示词一键出片，无需切换工具
+ - 内置 20+ 常见问题诊断能力，直接给出修复方案
+
+ **适用对象**
+
+ - 🎬 **短视频创作者** — 专业提示词提升视频质量，减少反复试错
+ - 📱 **自媒体 / 内容运营** — 快速产出多场景视频素材
+ - 🎨 **创意工作者** — 将抽象创意转化为精确的生成指令
+
+ ---
+
## 功能特性
### 核心功能
| 功能 | 说明 |
|------|------|
| 结构化提示词编写 | 按专业技术参数体系逐层构建提示词 |
- | @多模态参考语法 | 首帧锁定/风格参考/运镜参考/音频同步/主体锁定 |
+ | 多模态参考语法 | 首帧锁定/风格参考/运镜参考/音频同步/主体锁定 |
| 黄金公式校验 | 检查主体+动作+场景+风格+情绪五要素完整性 |
- | 20+场景问题诊断 | 人物不一致、运镜混乱、画面质量差等常见问题修复 |
- | 实战模板库 | 8个常见场景模板（自然风光、城市夜景、人物特写等） |
- | 一键生成视频 | 写完提示词直接调用 API 出 MP4 视频 |
+ | 常见问题诊断 | 人物不一致、运镜混乱、画面质量差等问题修复 |
+ | 场景模板库 | 8个常见场景模板（自然风光、城市夜景、人物特写等） |
+ | 一键生成视频 | 写完提示词直接生成 MP4 视频 |
### 特色亮点
- - **提示词即摄影指令**：将抽象描述转化为 AI 可精确执行的指令，避免"很科幻""有感觉"等模糊表述
- - **写+拍一体化**：完成提示词后可直接生成 4-15 秒 1080p 视频，无需切换工具
+ - **提示词即摄影指令**：将抽象描述转化为 AI 可精确执行的指令，避免模糊表述
+ - **写+拍一体化**：完成提示词后可直接生成高清视频，无需切换工具
- **内置诊断能力**：遇到人物换脸、运镜混乱等问题时，可直接给出修复方案
---
## 使用指南
+ ### 鉴权
+
+ > 使用本技能前，请确保已配置 API Key。
+
+ #### 获取 API Key
+ 1. 访问 [红狐Hub 官网](https://redfox.hk/) 了解服务详情
+ 2. 前往 [注册页面](https://redfox.hk/login) 注册账号
+ 3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务
+ 4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`
+
+ #### 配置 API Key
+ - `REDFOX_API_KEY` 从环境变量获取，格式 `ak_xxxxxxxx`
+ - 若未设置，提示用户自行配置：`export REDFOX_API_KEY=<你的apikey>`；若用户不会配置，Agent 应主动帮用户设置：
+ - **macOS/Linux**：将 `export REDFOX_API_KEY=<值>` 追加到 `~/.zshrc`（zsh）或 `~/.bashrc`（bash），然后 `source` 对应文件使其全局生效
+ - **Windows**：使用 `[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")` 设置用户级永久环境变量（需重启终端生效）
+ - 配置完成后应验证：`echo $REDFOX_API_KEY`（macOS/Linux）或 `echo %REDFOX_API_KEY%`（Windows），确保换一个 skill 也能读取到
+
### 基础使用
直接用自然语言描述你想要的视频画面，技能会自动将其转化为专业级提示词。
> 用户：帮我写一个日落海滩的视频提示词，要电影感
>
> 助手：会按技术参数、空间层次、光影设计、运动编排逐层构建提示词
### 常用说法速查
| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 新写提示词 | 「帮我写一个赛博朋克城市夜景的视频提示词」 | 按专业体系逐层构建完整提示词 |
| 效果诊断 | 「生成的视频人物总是换脸，怎么办」 | 诊断问题并给出修复方案 |
| 调用模板 | 「给我一个产品展示的提示词模板」 | 直接输出对应场景的可用模板 |
- | 生成视频 | 「用这个提示词生成视频，16:9，8秒」 | 调用 API 直接出片 |
+ | 生成视频 | 「用这个提示词生成视频，16:9，8秒」 | 直接生成视频 |
---
- ## 视频生成（调用 API 出片）
-
- 写完提示词后可直接调用 Seedance 2.0 API 生成 MP4 视频。
-
- ### 前置条件
-
- - 环境变量 `REDFOX_API_KEY` 已配置（前往 [redfox.hk](https://redfox.hk/settings/api-keys?source=github) 获取）
- - 依赖：`pip3 install requests`
-
- ### 基础命令
-
- ```bash
- python3 "$SKILL_PATH/scripts/videogen.py" "提示词内容" --ratio 16:9 --duration 8 --resolution 1080p
- ```
-
- ### 参数速查
-
- | 参数 | 说明 | 默认值 |
- |------|------|--------|
- | `prompt` | 提示词（必填，中英文均可） | — |
- | `--resolution` | `480p` / `720p` / `1080p` | `720p` |
- | `--ratio` | `16:9` / `4:3` / `1:1` / `9:16` / `21:9` / `adaptive` | `16:9` |
- | `--duration` | 时长（秒）：4-15 或 -1（智能） | `5` |
- | `--seed` | 随机种子：-1 到 2147483647 | `-1` |
- | `--no-audio` | 不生成声音 | 默认生成 |
- | `--watermark` | 添加水印 | 默认不添加 |
- | `--image-url` | 参考图 URL（`asset://` 格式引用虚拟人像） | — |
- | `-o, --output-dir` | 输出目录 | `~/Downloads/QoderVideos` |
- | `--no-download` | 仅提交任务，不等待 | — |
- | `--task-id` | 查询已有任务并下载 | — |
-
- ### 画幅选择建议
-
- | 用途 | 推荐画幅 |
- |------|--------|
- | 短视频（抖音/小红书） | `9:16` |
- | 横屏内容（B站/YouTube） | `16:9` |
- | 电影感宽银幕 | `21:9` |
- | 社交帖图/产品展示 | `1:1` 或 `4:3` |
-
- ### 工作流示例
-
- ```bash
- # 1. 写完提示词
- # 2. 直接调用生成
- python3 "$SKILL_PATH/scripts/videogen.py" "提示词" --ratio 16:9 --duration 8 --resolution 1080p
+ ## 视频生成（一键出片）
- # 竖屏短视频
- python3 "$SKILL_PATH/scripts/videogen.py" "提示词" --ratio 9:16 --duration 5
+ 写完提示词后可直接生成 MP4 视频，支持多种画幅比例和分辨率。
- # 多段连续视频：第一段获取尾帧
- python3 "$SKILL_PATH/scripts/videogen.py" "第一段" --return-last-frame
- # 将返回的 lastFrameUrl 作为第二段首帧
- python3 "$SKILL_PATH/scripts/videogen.py" "第二段" --image-url "上一步的lastFrameUrl"
- ```
+ ### 支持能力
- ### 生成耗时与消耗
+ | 能力 | 说明 |
+ |------|------|
+ | 多种画幅 | 横屏、竖屏、正方形等多种比例可选 |
+ | 多种分辨率 | 从标清到高清，按需选择 |
+ | 灵活时长 | 支持 4-15 秒视频生成 |
+ | 参考图支持 | 可上传参考图辅助生成 |
- - 通常 3-15 分钟，脚本自动轮询等待
- - 分辨率越高、时长越长，Token 消耗越大
- - 中途网络超时脚本会自动重试，不影响最终结果
+ ### 生成耗时
- ### API Key 配置
+ - 通常 3-15 分钟即可完成
+ - 分辨率越高、时长越长，资源消耗越大
- ```bash
- # 方式1：环境变量（推荐）
- export REDFOX_API_KEY=ak_你的密钥
+ ---
- # 方式2：命令行参数
- python3 "$SKILL_PATH/scripts/videogen.py" "prompt" --api-key ak_你的密钥
+ ## 使用场景
- # 方式3：配置文件（持久化）
- mkdir -p ~/.qoder/apis && echo '{"api_key":"ak_你的密钥"}' > ~/.qoder/apis/redfox.json
- ```
+ | 场景 | 角色 | 示例问法 | 收益 |
+ |------|------|---------|------|
+ | 短视频创作 | 博主 / 编导 | 「帮我写一个日落海滩的电影感视频提示词」 | 专业级提示词，一次生成高质量视频 |
+ | 产品广告 | 电商 / 品牌运营 | 「产品旋转展示的视频提示词，要高端感」 | 快速产出产品视频素材，降低拍摄成本 |
+ | 内容批量产出 | 内容运营 / MCN | 「给我一套城市夜景和美食的提示词模板」 | 复用模板批量生成，提升内容产出效率 |
+ | 效果问题排查 | 所有用户 | 「视频里人物总是变形，怎么解决」 | 精准诊断问题并给出可操作的修复方案 |
---
## 文件结构
```
video-prompt-expert/
├── SKILL.md # 主技能文件（本文档）
├── scripts/
- │ └── videogen.py # 视频生成主程序（Seedance 2.0 API）
+ │ └── videogen.py # 视频生成主程序
├── references/
│ └── core_workflow.md # 核心执行流程
└── assets/
└── templates/
└── prompt_templates.json # 结构化模板数据
```