naming-convention 是一个专注于视频交付物文件命名的技能。它的核心目标是让接收者无需打开文件就能挑选出正确的文件。
【用途】 该技能解决批量视频文件命名混乱的问题。当一批视频以 ad-v5-hook-01.mp4 … ad-v5-hook-21.mp4 这样的名称交付时，接收者必须打开全部 21 个文件才能了解内容，而且一周后这些数字就失去了意义。本技能通过一套命名规则，使文件名本身携带足够的信息。
【主要能力】
- 命名规则：文件名应包含批次中所有变化的维度，加上稳定的排序键。格式为 <index>-<subject>-<descriptor>-<treatment>.<ext>。
- index：补零并放在最前，使磁盘顺序与审核顺序一致（如审核画布上的第 7 张卡片对应文件夹中的第 7 个文件）。
- subject：内容主体（产品、客户、主题）。
- descriptor：区分近似副本的轴（风格、格式、角度、镜头等）。
- treatment：对文件做了什么处理（如 body-edited / body-unedited、captioned / clean、9x16 / 1x1、draft / approved）。
- 验证事实：在将标签写入文件名之前，必须验证其准确性。上游步骤（如剪辑列表、镜头列表、客户表格、之前会话的 JSON）中的标签只是证据，不是真相，可能因为不同步骤解决不同问题而保留错误。技能提供了三种低成本的检查方法：查找源文件中的声明（如工具提示面板中的提示词和参考图缩略图）、观察画面本身（但特写可能裁剪掉文字标记）、交叉核对转录文本。如果纠正了继承的标签，应在交接时明确说明。
- Slug 规则：保持名称 shell 安全、URL 安全且可排序。使用小写、连字符分隔、ASCII 字符；不使用空格、撇号、& 或括号；索引补零（07 而非 7）以使字典序匹配数值序；优先使用人类可读的名称而非内部代码；保持主体 slug 跨批次稳定；避免过度堆砌描述符。
- 将映射保存为数据：将每个条目的信息放在批次旁边的小型 JSON 文件中，而不是硬编码在重命名脚本里。包括一个注释说明事实来源，以便后续人员判断是否可信。
- 安全重命名：使用 scripts/rename_batch.py 脚本，默认试运行，检查每个源文件存在、目标不与不同文件冲突、模式产生唯一名称。脚本是幂等的，第二次运行会报告“已命名”而不是重复重命名，并更新构建清单。重命名前后需注意：始终先试运行；更新清单；如果批次已在审核画布上，重新发布并打印每个卡片上的文件名；不要重命名已交付并下载的文件，如需更改应作为新副本交付或明确告知。
- 常见命名模式：针对 hook 变体、比例缩减、修订轮次、静帧/帧抓取等场景提供了建议模式。
【使用方式】
技能附带 rename_batch.py 脚本，可通过命令行调用。示例：
python3 scripts/rename_batch.py --dir variants/ --map subjects.json
--pattern "hook-{index:02d}-{subject}-{style}-body-{treatment}"
--set treatment=unedited --manifest variants.json # 试运行
python3 scripts/rename_batch.py ... --apply # 提交
同时提供 assets/subjects.example.json 作为真实 21 项映射的示例，包含事实来源注释。
【适用场景】 适用于视频编辑和交付工作流，特别是批量生成广告变体、多比例版本、修订轮次、审核静帧等场景。也适用于任何需要批量重命名并保持可追溯性的文件管理任务。
【限制】 技能文档未提及具体的运行环境要求、依赖项或性能指标，这些信息暂未提供。脚本的具体实现细节和参数说明在文档中未完全展开，暂未提供。