将视频上传到云盘
video-animado 技能将 MP4 文件交付到项目中。本技能负责将文件放入团队公认的云文件夹中，并按规范命名。这些文件名将成为后续分析每个广告创意的效果的唯一标识。
规范
<目标文件夹，由用户确认>/
<活动名称>/
30S/ 每个时长一个子文件夹
vvs_bala_coroa/ 每个视频一个文件夹
vvs_vertical_bala_coroa.mp4 9:16 · 1080×1920
vvs_wide_bala_coroa.mp4 16:9 · 1920×1080
vvs_square_bala_coroa.mp4 1:1 · 1080×1080
como_foi_feito.md 视频创建过程说明
15S/
vvs_bala_coroa/ …
- 文件名：
<前缀>_<格式>_<关键词>.mp4，全部小写。默认前缀为vvs，可通过清单中的"prefixo"修改。 - 格式： 竖屏变为
vertical，正方形变为square，横屏变为wide。不存在的格式直接忽略，不要自行创建。 - 关键词： 1 到 4 个单词，取自视频标题，小写无变音符号。冠词、介词、"e" 和 "que" 等会被脚本自动过滤掉。
- "A bala na coroa" 变成
vvs_vertical_bala_coroa.mp4。 - "Três crianças diante do poder" 变成
vvs_wide_tres_criancas_diante_poder.mp4。 - 如果标题中的有效单词超过 4 个，则使用清单中
"palavras"字段指定的单词；脚本会拒绝不完整的配置。
- "A bala na coroa" 变成
- 视频文件夹的名称为
<前缀>_<关键词>。时长信息仅体现在子文件夹（30S/、15S/）和记录中。时长 14.0 秒的视频会被归入15S/文件夹。 - 同一标题存在两个不同时长版本时，会在不同文件夹中生成相同的文件名。脚本会给出警告。在广告管理器中，将时长放入广告名称中即可区分。
como_foi_feito.md文件必须出现在每个视频文件夹中，供任何人审查制作过程。脚本会根据源项目（来自atributos.projeto）自动生成此文档，内容包括：- 技术规格；
- 导演、配音和配乐；
- 概念和脚本（取自
roteiro.json）； - 项目中的
ANALISE.md和RELATORIO.md文件：简要说明、概念、创意圣经和评审意见。
操作步骤
- 目标文件夹：必须由请求者确认。 切勿猜测。如果未提及，则需询问。
- 查找同步文件夹的本地路径。 在 macOS 上，Google Drive for Desktop 的路径为
~/Library/CloudStorage/GoogleDrive-<您的电子邮件>/（Meu Drive/、Drives compartilhados/）。如果收到 Drive 链接且存在 Drive 连接器，则可以通过父文件夹 ID 链追溯同步路径中存在名称的文件夹。直接复制到同步文件夹即是上传；不要通过 API 发送大的 MP4 文件。 - 创建清单（
manifesto.json，格式见下方）：每个视频包含标题、标称时长、各格式的文件路径，以及分析所需属性（创意方向、制作流程、配音、配乐、源项目）。 - 在复制文件之前，先显示名称表格和目标路径，除非用户已明确指示直接上传。目标通常是一个共享文件夹。
- 运行
python3 ~/.claude/skills/subir-videos/subir.py manifesto.json。- 运行前，建议先添加
--seco参数进行试运行：仅验证并显示名称。 - 如果文件已存在于云端，可使用
--so-registro参数：仅写入记录。 - 脚本会检查视频尺寸和时长，拒绝不符合规范的名称或重复的标题，创建文件夹，复制文件，为每个视频生成
como_foi_feito.md，并在全局记录文件~/videos/VVS_REGISTRO.csv中追加条目。
- 运行前，建议先添加
- 几分钟后检查云端，因为同步是后台进行的，大文件需要较长时间。
- 交付文件夹链接和名称表格，并在项目中的
ANALISE.md文件中记录每个视频的存储位置。
清单（模板）
{
"destino_local": "~/Library/CloudStorage/GoogleDrive-<您的电子邮件>/Drives compartilhados/<驱动器>/<文件夹>",
"campanha": "活动名称",
"prefixo": "vvs",
"drive_link": "https://drive.google.com/drive/folders/<目标文件夹ID>",
"videos": [
{"titulo": "A bala na coroa", "duracao": "30S",
"arquivos": {"vertical": "…/out/30s_9x16.mp4", "wide": "…/out/30s_16x9.mp4", "square": "…/out/30s_1x1.mp4"},
"atributos": {"direcao": "2D角色动画", "processo": "视频请求 + video-animado",
"voz": "Gemini TTS", "trilha": "Lyria, ~120 bpm", "projeto": "~/videos/<slug>"}}
]
}
为什么需要记录
文件名 <前缀>_<格式>_<关键词> 是用于与广告投放结果交叉分析的关键（时长信息放入广告名称中）。团队在广告管理器中以此名称上传广告创意，该名称会出现在媒体数据的广告名称字段中。VVS_REGISTRO.csv 文件保存了每个视频的属性（方向、流程、配音、配乐、实际时长），以便后续比较哪些效果好、哪些效果差。请勿在其中存储个人数据。
禁止事项
- 不得上传到未经确认的文件夹，也不得删除或重命名文件夹中他人的文件。
- 不得擅自更改命名规范：更改规范是请求者的决策。
- MP4 文件不应提交到 Git 仓库。