vk视频制作（VK Video Studio）
把「产品素材 + 评论数据」一次性加工成可发布的 VK 竖版短视频交付包：脚本、分镜、
画面提示词、俄语成稿、交付页，一次成型。
四个能力模块串成一条单向流水线，每个模块只做一件事，边界不重叠。
> 安全默认值（v1.1）：本技能默认离线运行，不联网、不外发任何文案；
> 写入范围限制在当前目录与临时目录内，凭据/系统/宿主配置目录一律拒绝；
> 朗读链接默认不生成。联网与链接生成都需显式开启。
快速开始
# 1. 生成输入模板
python scripts/vk_pipeline.py init --out brief.json
# 2. 填好 product.selling_points / audience.pain_points 后校验
python scripts/vk_pipeline.py validate --brief brief.json
# 3. 跑完整流水线（默认离线；有评论 CSV 就带上，能显著提升钩子质量）
python scripts/vk_pipeline.py run --brief brief.json --review-csv reviews.csv --out out/
# 4. 看门禁报告
python scripts/vk_pipeline.py check --out out/
产出落盘在 out/：01_insight.json → 02_script.json → 03_prompt_pack.json →
04_localized.json → 05_qa.json → bundle.json → delivery.html。
退出码 0 = 门禁 PASS；1 = 输入契约失败或路径不安全；2 = 门禁 BLOCK
（产物照常落盘，便于定位）。
默认离线时翻译会被标为 pending，门禁必然 BLOCK——这是预期行为，代表
"未取得译文不得发布"。确实需要联网翻译时：
python scripts/vk_pipeline.py run --brief brief.json --out out/ --online
CLI 参数（安全相关）
| 参数 | 默认 | 说明 |
|---|---|---|
--online |
关闭 | 开启联网翻译。开启后待译中文文案会发送至第三方公共翻译服务（见下方「数据外发须知」） |
--offline |
兼容保留 | 离线已是默认行为，传入等同不传，仅打印提示 |
--allow-outside |
关闭 | 放行写入当前目录/临时目录之外的位置。默认拒绝越界写入 |
--tts-links |
关闭 | 生成朗读链接。链接会把完整文案明文拼进 URL，点击即外传 |
--no-html |
关闭 | 不生成 delivery.html 交付页 |
--review-csv |
— | 评论文件，扩展名白名单 .csv/.tsv/.txt/.json，上限 8 MiB |
写入守卫（始终生效，无放行开关）：系统目录（/etc、/usr、/System、
/Library、/var/log 等）、凭据目录（~/.ssh、~/.aws、~/.gnupg、~/.config、
~/.netrc、~/.git-credentials 等）、技能安装目录与宿主配置（~/.workbuddy、
~/.claude）一律拒绝写入。
数据外发须知（务必阅读）
翻译使用 MyMemory 公共接口。其服务条款明确声明：提交的任何片段都会被
长期留存；未显式标记为私有的片段构成其 Public Data，归其全权所有；
合作方可将其用于改进机器翻译模型。也就是说——
> 未公开的卖点、定价话术与新品文案，一旦在联网模式下处理，即构成不可撤销的
> 商业信息外流。 处理这类内容请保持默认离线模式。
另需注意：匿名调用每日仅约 5,000 字符配额，批量出片会触顶。
朗读链接所指端点属 Google 未公开内部接口，程序化调用存在合规与稳定性风险；
且链接以明文携带文案，会残留在浏览器历史、代理日志与 Referer 头中。
因此默认不生成，交付页在启用时也会附带同意提示。
五个阶段与职责边界
| 阶段 | 源技能 | 只做 | 绝不做 |
|---|---|---|---|
| S1 Evaluate | review-analyzer-skill | 评论 CSV → 情感/维度打标 → 统计 → 5 条异常规则 → 画像 → 卖点/痛点/钩子 | 写脚本、出提示词、关键词选品；把推断当数据 |
| S2 Script | video-script-generator | 标题备选、六镜骨架、景别运镜、中文口播意图稿、字幕意图稿、标签、加权配时 | 出 AI 绘图提示词；产出最终俄语成稿 |
| S3 Prompt | video-prompt-generation-system-v1 | 全局风格锚、逐镜提示词、负向提示词、角色一致性表、工具适配 | 改动分镜结构、时长、节奏；翻译 |
| S4 Localize | all-translate | 中俄翻译、锁定术语保护、口播时长与字幕长度校验、按需朗读链接 | 创作或改写文案含义；动提示词 |
| S5 QA | 整合层新增 | 10 项确定性铁律校验、门禁判定 | 修改任何产物（只报告） |
一句话记忆：Evaluate 说什么 → Script 怎么排 → Prompt 怎么拍 → Localize 怎么说外语
→ QA 能不能发。
完整契约与边界冲突裁决规则见 references/interface-spec.md。
执行顺序（强制）
S0 Intake → S1 Evaluate → S2 Script → S3 Prompt → S4 Localize → S5 QA → 交付
↑ ↑
└── 可并行 ──┘
S1可跳过（无评论数据）；跳过时必须在产物里标注source = 未检索到评论数据。S2不可跳过，S3/S4都依赖它，两者之间无依赖可并行。S5依赖全部产物，缺任一直接 BLOCK。- 禁止跳阶：不允许先做 S3 再回头补 S2。
每阶段的 done 标准、失败回退矩阵见 references/workflow.md。
七条交付铁律
QA 阶段机器校验，任一 FAIL 即 BLOCK：
| ID | 铁律 |
|---|---|
| R1 | 成片比例一律 9:16（1080×1920），禁用 3:4 / 1:1 素材硬裁 |
| R2 | 画面内不出现任何文字，俄语字幕一律后期烧录 |
| R3 | 品牌 Logo / 型号一律后期贴图，不交给生成模型 |
| R4 | 数字用中文读法（十七厘米、一百九十五克、九比十六） |
| R5 | 卖点只取素材原文，尺寸口径不一致必须标「未检索到/需以设计稿为准」 |
| R6 | 不承诺产品不具备的功能（工具类不承诺剪钢丝等） |
| R7 | 所有俄语成稿必须经 S4 统一产出，S2 只出中文意图稿 |
补充校验：R8 字幕 ≤42 字符、R9 口播时长、R10 时长合规。
宿主 Agent 需要做的 LLM 环节
脚本只跑确定性部分。以下必须由 Agent（或人）执行：
- 22 维精标——词典法只给倾向，精标按
references/voc-analysis.md逐条执行 - 15 章 VOC 报告——脚本只出洞察摘要
- 文案精修——把模板句打磨成有真实感染力的口播
- 镜头语言精修——把场景描述替换为该产品的具体动作与细节
- 译文终审——机翻结果必须经母语级审校后再回填
参考资料索引（按需读）
| 文件 | 何时读 |
|---|---|
references/interface-spec.md |
每次都要过——契约字段、边界冲突裁决、命名约定 |
references/workflow.md |
编排流程、done 标准、失败回退矩阵、铁律定义 |
references/vk-platform-spec.md |
确认平台规格、字幕烧录要求、算法偏好、上传清单 |
references/script-templates.md |
精修脚本时——六镜结构、口吻句式、字幕规范、标签池 |
references/prompt-patterns.md |
精修提示词时——七段式结构、光线配色映射、镜头参数、角色一致性 |
references/voc-analysis.md |
精修 VOC 分析时——22 维标签、异常规则阈值、画像方法、反幻觉红线 |
references/translation-glossary.json |
术语表——追加新品术语时改这里，脚本自动加载 |
脚本清单
| 文件 | 作用 |
|---|---|
scripts/vk_pipeline.py |
唯一 CLI 入口：init / validate / run / report / check |
scripts/vk_core.py |
公共契约层：平台规格、时长预设、六镜模板、brief 校验、铁律表、路径守卫与读取守卫 |
scripts/evaluate.py |
S1 评测分析（源：review-analyzer-skill） |
scripts/script_generator.py |
S2 脚本生成（源：video-script-generator） |
scripts/prompt_builder.py |
S3 提示词构建（源：video-prompt-generation-system-v1） |
scripts/localize.py |
S4 本地化（源：all-translate） |
scripts/qa_check.py |
S5 交付自检门禁 |
使用注意
- 卖点唯一来源是
brief.product.selling_points，必须逐字取自产品素材；任何模块
不得发明卖点。痛点只能进钩子与异议处理，不能当卖点。 - 翻译不等于可发布：机翻结果必须经母语级审校，性数格与时态要人工修正。
delivery.html是交付载体：带顶部「一键复制全部」与每段「复制」按钮，
所有内容直接来自bundle.json，未经二次改写。页内所有数据插值均经 HTML 转义
（覆盖& < > " '），不会因内容含 HTML 而产生脚本注入。- 成片制作不在本技能范围：裁切 / 烧字幕 / 配音 / 编码请交给成片类技能处理。
- 平台规则会变，正式投放前以 VK 后台当前提示为准。
