# Product Video Script Writer

> Use when creating or revising Douyin organic-traffic product monologues, product stories, shooting scripts, or confirmed Word shooting documents; do not use for boss-IP stories, selling-point research, paid Qianchuan ads, or livestream selling.

- Skill: `jiaoedc668/product-video-script-writer` (Agent Skill, multi-file: 38 files)
- Install (CLI): `npx skillmds@latest add jiaoedc668/product-video-script-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiaoedc668/product-video-script-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: jiaoedc668 (https://skillmd.com/u/jiaoedc668)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jiaoedc668/product-video-script-writer

---


# Product Video Script Writer

把用户提供的产品事实转成可筛选的自然流量候选，再经选择、修稿和当前版本确认生成可编辑拍摄 Word。目标固定为抖音自然流量播放潜力。

当前版本以 [VERSION](VERSION) 为准；维护本技能时读取 [版本与文件管理](references/maintenance.md)，历史变更见 [CHANGELOG.md](CHANGELOG.md)。技能版本与候选文案版本分别管理。

## 边界

- 产品事实只来自用户输入。不得联网补参数，不得编价格、优惠、赠品、稀缺性、续航、效果或产品结构。
- 联网只研究至少 3 条同类高热视频的开头、节奏、题材和评论需求。优先近一年抖音；抖音不可达时使用用户参考或其他平台并记录原因。必须遵循 `web-access`。
- 不复制连续文案、故事骨架或金句。政治题材禁用。
- 用户催时间、要求直接成稿或直接 Word，都不能跳过候选、选择和确认门。

## 输入门

一次检查并列出全部缺项：产品名、种类、用途、核心卖点、目标顾客、形式。形式只接受 `monologue`、`story`、`both`。缺任一项时只追问缺项，不研究、不创作。

选填型号、场景、演员场地、必现信息、禁用表达、参考视频。未提供拍摄条件时默认手机竖屏、普通家庭或公司场地、少量道具；剧情 1–2 人，必要时最多 3 人。产品前 2 秒清晰入镜是默认策略，效果不佳可调整并说明。

先读当前项目规则和最新 brief 中的拍摄条件。已知演员人数、性别、出镜与画外音限制必须落实到角色，不用换装、配音或未授权的额外演员绕过；缺少确实影响执行的条件时一次问清。某项目的演员配置不推广成其他项目的默认要求。

用 `scripts/contract.py` 的 `validate_brief` 检查输入。内容库默认放在当前项目根下的 `产品视频内容库`，也可由用户或项目配置指定；通过 `scripts/manage_workspace.py` 追加记录，绝不覆盖历史。

## 候选阶段

先读取 [候选数据契约](references/candidate-packet.md)。创作或修改剧情时必须读取 [产品剧情创作与审稿](references/story-craft.md)。研究完成后，先做剧情语义审稿，再写内部候选包并运行：

```powershell
python <skill-dir>/scripts/check_packet.py --input <candidate-packet.json> --public-json
```

- `monologue` 正好 3 稿，单稿估算 25–35 秒。
- `story` 正好 3 稿，单稿不超过 90 秒，完整故事可更短。
- `both` 正好 6 稿，每种各 3 稿。
- 候选必须实质不同，每稿至少使用一个用户卖点，默认只突出一个主卖点。口播可自然引导评论关注，剧情自然结束。
- 对用户只展示：形式、主题、创意说明、完整文案、预计时长。预计时长只称估算，不展示内部评分、研究包或事实映射。

提交候选后停止。不得替用户选择，不得补拍摄执行表，不得生成 Word。

校验器只检查结构、事实映射、数量与时长等约束，不判断动机是否真实、对白是否自然、故事是否让人对产品产生兴趣。语义审稿未解决的问题不能用机器通过替代。

## 选择与确认门

用户选中后，通过 [台账契约](references/workspace-events.md) 记录用户原话和选择；只在对话中修改完整文案。每次修订都追加新版本并使旧确认失效。

只有用户明确确认当前完整文案后，才能补充时间段、画面动作、台词、字幕提示、拍摄备注及道具场景清单。台词栏是主体。沉默、选中、允许修改或要求 Word 都不等于当前文案确认。

## Word 交付

确认后读取 [Word 交付契约](references/word-delivery.md)。先用 `scripts/manage_workspace.py can-generate-word` 检查当前文案哈希，再用 `scripts/generate_word_cli.py` 生成新版本。文件不得覆盖旧版。

必须遵循 `documents` Skill：生成后用其打包的 `render_docx.py` 渲染全部页面，在 100% 视图逐页检查缺字、溢出、重叠和断表；有问题就修改、重生成新版本并重新渲染。机器通过只证明流程和版面，不代表用户认可或真实播放效果。

## 学习

只记录用户原话、明确选择、修改、淘汰原因、偏好和发布数据。淘汰原因只分题材、结构、表达、仅本次不合适；原因不明时追问，仍无原因只做相似提醒，不永久封杀。24 小时播放、7 天播放和同期近 10 条中位数允许为空，绝不推断。

聊天记录先区分用户原话、其他助手建议、明确接受和本次推断。独立案例单独记录，不反推其他候选被否定的原因。“题材角度可以”只认可角度，不等于选定全文或确认；不得因此调用 select/confirm。学习可复用的动机与产品发现方法，不将案例中的角色、回访时长、对白或卖点数量固化成模板。

共享创作偏好只共享抽象表达偏好，不共享老板 IP 人设、题材规则或固定文案套路。损坏事件、重复 ID 或缺少用户原话时停止写入并报告具体位置。

## 失败红旗

- “今晚要拍，所以先给一稿或先出 Word”
- “用户让我看着补，所以价格或续航可以合理推测”
- “选中已经等于确认”
- “只是改结尾，旧确认还能沿用”

出现任一想法就回到对应门，不做折中流程。