关于 tuzi-short-video
tuzi-short-video 是用于制作社交媒体短视频的工作流技能,可分析文本、文章、脚本或主题,按平台要求编写提示词,并将生成任务交给 tuzi-video-gen。
主要功能
- 01分析来源内容与结构
- 02按平台规格调整输出
- 03编写单段或分段视频提示词
- 04读取已保存的平台和模型偏好
- 05委托 tuzi-video-gen 生成视频
适用场景
- 01将文章改编为短视频
- 02为长内容准备多段提示词
- 03为指定社交平台制作视频
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tuziapi/ tuzi-skills --skill tuzi-short-video安装后在 Claude Code 中输入/tuzi-short-video确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/config/first-time-setup.mdpreferences-schema.mdreferences/platforms/douyin.mdweixin-video.mdx-twitter.mdxiaohongshu.mdreferences/workflows/long-video.mdsingle-video.md详细介绍
短视频创作
为社交媒体平台创作短视频。分析内容、适配平台规格、生成提示词,并调用 tuzi-video-gen 后端。
脚本目录
这是一项仅包含工作流的技能(无脚本)。它会将视频生成工作委托给 tuzi-video-gen。
VIDEO_GEN_DIR:根据相对于项目根目录的 skills/tuzi-video-gen/SKILL.md 确定。
步骤 0:加载偏好设置 ⛔ 阻塞性步骤
重要:必须在生成任何视频之前完成此步骤。
0.1 检查 API 密钥
echo "${TUZI_API_KEY:-not_set}"
grep -s TUZI_API_KEY .tuzi-skills/.env "$HOME/.tuzi-skills/.env"
| 结果 | 操作 |
|---|---|
| 找到密钥 | 继续步骤 0.2 |
| 未找到密钥 | ⛔ 运行 API 密钥设置(参见 references/config/first-time-setup.md) |
0.2 检查 EXTEND.md
test -f .tuzi-skills/tuzi-short-video/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-short-video/EXTEND.md" && echo "user"
| 结果 | 操作 |
|---|---|
| 找到 | 加载、解析并应用设置 |
| 未找到 | ⛔ 运行首次设置(references/config/first-time-setup.md) |
| 路径 | 位置 |
|---|---|
.tuzi-skills/tuzi-short-video/EXTEND.md | 项目目录 |
$HOME/.tuzi-skills/tuzi-short-video/EXTEND.md | 用户主目录 |
EXTEND.md 支持:默认平台 | 默认模型
架构:references/config/preferences-schema.md
步骤 1:分析用户输入
分析用户提供的内容(文本、文章、脚本、主题描述):
- 确定主题和要点
- 判断内容类型(教程、故事、展示、说明)
- 估算理想视频时长和片段数量
步骤 2:确认平台和参数
除非用户已指定或 EXTEND.md 中已保存设置,否则使用 AskUserQuestion 让用户选择目标平台:
header: "Target Platform"
question: "目标发布平台?"
options:
- label: "小红书"
description: "9:16 竖屏, 720x1280"
- label: "抖音"
description: "9:16 竖屏, 1080x1920"
- label: "X/Twitter"
description: "16:9 横屏, 1280x720"
- label: "视频号"
description: "9:16/16:9, 1080x1920"
平台预设
| 平台 | 画面比例 | 尺寸 | 时长 | 说明 |
|---|---|---|---|---|
| 小红书 | 9:16 | 720x1280 | 15-60s | 竖屏短视频 |
| 抖音 | 9:16 | 1080x1920 | 15-60s | 竖屏,高分辨率 |
| X/Twitter | 16:9 | 1280x720 | 5-140s | 以横屏为主 |
| 视频号 | 9:16 | 1080x1920 | 15-60s | 优先采用竖屏 |
平台详情:参见 references/platforms/
步骤 3:生成视频脚本
根据内容分析结果和平台要求:
单个视频(内容适合一个片段)
- 用英文编写详细的视频生成提示词
- 包含:视觉场景、镜头运动、风格、氛围、灯光
- 将提示词保存至
prompts/01-video-prompt.md
长视频(内容需要多个片段)
- 将内容拆分为逻辑连贯的片段(开场 + 正文 + 结尾)
- 为每个片段编写提示词,并附上连贯性说明
- 保存至
prompts/01-segment-opening.md、02-segment-main.md等文件
工作流详情:参见 references/workflows/
步骤 4:生成视频
单个视频
npx -y bun ${VIDEO_GEN_DIR}/scripts/main.ts \
--promptfiles <output-dir>/prompts/01-video-prompt.md \
--video <output-dir>/01-video-<slug>.mp4 \
--size <platform-size> \
--seconds <duration>
长视频
npx -y bun ${VIDEO_GEN_DIR}/scripts/main.ts \
--video <output-dir>/01-video-<slug>.mp4 \
--segments <N> \
--segment-prompts <output-dir>/prompts/01-segment-opening.md <output-dir>/prompts/02-segment-main.md ... \
--size <platform-size> \
--seconds <per-segment-seconds>
步骤 5:完成报告
显示:
- 输出视频路径
- 使用的平台和规格
- 使用的模型
- 时长
输出目录
short-video/{topic-slug}/
├── source-{slug}.md
├── prompts/
│ ├── 01-video-prompt.md (single video)
│ ├── 01-segment-opening.md (long video)
│ ├── 02-segment-main.md
│ └── 03-segment-ending.md
├── segments/ (long video temp, cleaned up)
└── 01-video-{slug}.mp4 (final output)
扩展支持
通过 EXTEND.md 使用自定义配置。支持的路径和选项请参见步骤 0。
评论
支持 Markdown