Back to Details

video-script

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Video Script

视频脚本

Scripts that sound like the creator on their best day: short, concrete, with a hook that earns the next 30 seconds. Everything comes from their real week and their own words. Nothing is invented.
这些脚本听起来就像创作者的最佳表现：简短、具体，钩子能让人愿意再看接下来 30 秒。所有内容都来自他们真实的一周和他们自己的原话，绝不编造。

Before writing

写作前

Read, in this order:
  1. video-agent/voice.md
    : who they are, who they talk to, how they sound, what they believe, their proof, the ask. Missing: offer 
    /video-setup
    (about 10 minutes, recommended), or ask 4 questions now (what they do, for whom, the language they record in, what viewers should do after watching).
  2. video-agent/swipe.md
    : hooks that worked in their niche and, on top, the "Concepts" that over-performed with their proof (from 
    /video-viral
    ). Every script sits on one of them (references/viral.md). Missing: run 
    /video-viral
    first (5 minutes); a week written without it is written blind.
  3. video-agent/audit.md
    if it exists: what works on their own account (from 
    /video-audit
    ). Its "3 changes for next week" apply to this week's scripts, and its best topics, lengths and hook formulas come first. Their own data beats the niche's.
  4. The last 20 lines of 
    video-agent/log.md
    : topics and hook formulas already used. Never repeat a topic from the last 4 weeks unless they ask.
  5. references/viral.md, references/hooks.md, references/script-rules.md and references/humanize.md.
Talk to them in their language, and write the scripts in the language they record in.
按以下顺序阅读：
  1. video-agent/voice.md
    ：他们是谁、面向谁、说话方式、相信什么、拥有什么证据，以及希望观众采取什么行动。缺少 Offer：运行 
    /video-setup
    （约 10 分钟，推荐）；或者现在询问 4 个问题（他们做什么、面向谁、录制时使用什么语言、观众看完后应该做什么）。
  2. video-agent/swipe.md
    ：其细分领域中已经奏效的钩子；此外还有结合其证据后表现超群的“Concepts”（来自 
    /video-viral
    ）。每条脚本都应基于其中之一（references/viral.md）。缺少此内容：先运行 
    /video-viral
    （5 分钟）；未运行就写完一周，等于盲写。
  3. video-agent/audit.md
    （如存在）：他们自己账号上哪些内容有效（来自 
    /video-audit
    ）。其中“3 changes for next week”适用于本周脚本；效果最佳的主题、时长和钩子公式优先。自己的数据胜过赛道通用数据。
  4. video-agent/log.md
    最后 20 行：已经使用过的主题和钩子公式。除非用户明确要求，否则绝不重复过去 4 周的主题。
  5. references/viral.md、references/hooks.md、references/script-rules.md 和 references/humanize.md。
用创作者的语言与其沟通，并使用他们录制时所用的语言编写脚本。

Modes

模式

  • /video-script
    → a week of scripts (default 5).
  • /video-script <topic or idea>
    → one script.
  • /video-script hook <script or topic>
    → the hook printer: 20 hooks from at least 10 formulas, grouped by concept of swipe.md (proven concepts first), filled with voice.md (the viewer's words, their phrases, their proof, their myths), scored, through the quality gates, best 3 on top. Each keeps its formula name, so a hook that works can be reposted with a new wording.
  • /video-script rewrite <script>
    → their script, tightened: same content and facts, better hook, shorter lines, timing checked, humanized. Show what changed.
  • /video-script humanize <file, script slug or pasted text>
    → any text (script, caption, description, post) made to sound like them: references/humanize.md, with its before and after score. 
    humanize check
    only reports.
For 
hook
and 
humanize
, skip "The week" and "The mix": read voice.md and the references, then do only that job.
  • /video-script
    → 一周的脚本（默认 5 条）。
  • /video-script <topic or idea>
    → 一条脚本。
  • /video-script hook <script or topic>
    → hook printer：基于至少 10 种公式生成 20 个钩子，按 swipe.md 中的 Concept 分组（已验证的 Concept 优先），并填入 voice.md 中的信息（观众会说的话、创作者常用的措辞、证据和误区），逐一评分并通过质量门槛，最佳 3 个置顶。每个钩子都保留其公式名称，以便将有效的钩子换一种措辞再次发布。
  • /video-script rewrite <script>
    → 精简创作者的脚本：保留相同内容和事实，优化钩子，缩短句子，检查时长并进行 humanize 处理。展示改动内容。
  • /video-script humanize <file, script slug or pasted text>
    → 将任意文本（脚本、字幕、描述、帖子）调整为创作者的语气：遵循 references/humanize.md，并给出处理前后的评分。
    humanize check
    仅进行检查和报告。
对于 
hook
和 
humanize
，跳过 
The week
和 
The mix
：阅读 voice.md 和相关 references，然后只完成对应任务。

1. The week

1. 本周

Ask one question: "What actually happened this week?" Give prompts so it's easy: a result (with the number), a mistake, a question a client or a follower asked, something they learned or tested, a tool they used, an opinion that came up in a conversation, something they disagree with.
Real material beats ideas, as long as it fits a proven concept. Then check what is hot today in the niche (a launch, a trend, a price change of the week): one script rides it, first in the week. If they have nothing, propose 5 topics from voice.md (beliefs, mistakes their viewer makes, proof), audit.md (their topics that over-perform) and swipe.md, and let them pick.
Then: how many videos (default 5) and is there something to promote this week (yes → one Offer video, no → none).
只问一个问题：“本周究竟发生了什么？” 给出提示，让创作者容易回答：一个带数字的结果、一次失误、客户或粉丝提出的问题、学到或测试过的某种东西、使用过的工具、对话中出现的观点，或不认同的某件事。
只要符合已验证的 Concept，真实素材就胜过一个想法。然后查看当前赛道的热点（新品发布、当天趋势、本周价格变化），让一条脚本借势热点，并排在当周第一位。如果没有素材，从 voice.md（理念、观众常犯的错误、证据）、audit.md（他们表现超额的主题）和 swipe.md 中提出 5 个主题，让创作者选择。
然后确认：要制作多少条视频（默认 5 条），以及本周是否需要推广内容（需要 → 制作一条 Offer 视频；不需要 → 不制作）。

2. The mix

2. 组合

Each video gets a type. Plan the week before writing:
TypeWhat it doesDefault per week of 5
Teachone problem, one fix the viewer can apply today2
Proofa real result and what made it happen1
Storya moment, a turn, a lesson1
Opiniona position against the usual advice in the niche1
Offerthe problem, what they made for it, who it's for, the ask0 or 1, never 2
Each video also gets its offer proximity, the rung of voice.md "The ask" it points to (0 to 3, script-rules.md), following the week mix there.
Show the plan as a table (number, type, topic, concept, hook formula you'll try first, offer proximity) and let them swap before you write. Never the same hook formula twice in a row, never the same type three times in a week.
每条视频都要确定类型。写作前先规划好这一周：
类型作用每周 5 条的默认数量
Teach（教学）讲明一个问题，并给出观众今天就能应用的修复方法2
Proof（实证）展示真实结果，以及促成结果的因素1
Story（故事）一个时刻、一次转折、一个教训1
Opinion（观点）针对赛道中常见建议提出反对立场1
Offer（推广）问题、为此制作的 Offer、适用对象和行动号召0 或 1，绝不为 2
每条视频还要确定 Offer 接近度，也就是它指向 voice.md 中“The ask”的哪一档（0 到 3，见 script-rules.md），并遵循其中的每周组合。
将计划以表格展示（编号、类型、主题、Concept、优先尝试的钩子公式、Offer 接近度），并在写作前让创作者调整。连续两条视频不得使用相同的钩子公式，同一类型一周内绝不能出现三次。

3. Write each script

3. 撰写每条脚本

  1. Aim: the concept of swipe.md it rides (with its best video and its x), the fresh news if any, the viewer it talks to, the false belief or myth it breaks (voice.md), and the ask line of its rung.
  2. 3 hooks, each from a different formula of hooks.md. Score each with the rubric in script-rules.md. Keep the best; the other two go under "Other hooks". All below 7/10: write 3 more.
  3. The on-screen hook: 6 words or fewer, shown during the first seconds. It adds to the spoken hook, never repeats it word for word.
  4. The body, from the structure of its type (script-rules.md). One sentence per line. A re-hook near the middle.
  5. The end: the ask from voice.md, said once, or a last line that loops into the first.
  6. Visual notes, apart from the spoken lines: what to show, and the 1 to 4 words worth a callout (a number, a result, a tool name).
  7. Timing: count the words, divide by their pace (voice.md, else 160 wpm). Check every beat rule in script-rules.md. Fix before showing.
  8. Facts: every number, name and result comes from voice.md or what they told you. Anything else becomes 
    {{your number}}
    , 
    {{client name}}
    , and is listed under "To fill".
  9. Humanize: run references/humanize.md on the script (steps 1 to 6, no report per script). Read it as if spoken aloud. Nothing they would never say (voice.md "Words I never use"), no em dash, no AI shape, every fact intact. Its score goes in the script's Score line.
  10. Triggers and gates: at least four triggers of script-rules.md at their place, then the four quality gates (generic, structureless, interchangeable, viral). A failed gate is a rewrite before showing.
  1. 目标：所依托的 swipe.md Concept（附最佳案例视频及其 x）、可用时采用的最新热点、目标观众、要打破的错误观念或误区（voice.md），以及对应档位的 ask 台词。
  2. 3 个钩子：每个钩子使用 hooks.md 中不同的公式。按照 script-rules.md 中的评分标准逐一评分。保留最佳钩子；另外两个放在 
    Other hooks
    下。如果全部低于 7/10，则再写 3 个。
  3. 画面钩子：不超过 6 个词，在最初几秒显示。它要补充口头钩子，绝不逐字重复。
  4. 正文：按照其类型的结构编写（script-rules.md）。一行一句。中段附近加入 re-hook。
  5. 结尾：使用 voice.md 中的 ask，且只说一次；或者用最后一句自然衔接回第一句。
  6. 视觉备注：与口头台词分开记录需要展示的内容，以及值得做画外提示的 1 至 4 个词（数字、结果或工具名称）。
  7. 时长：计算词数，再除以其语速（voice.md；否则使用 160 wpm）。检查 script-rules.md 中的每个节奏节点规则。展示前先修正。
  8. 事实：所有数字、名称和结果均来自 voice.md 或创作者提供的信息。任何其他内容都要替换为 
    {{your number}}
    、
    {{client name}}
    ，并列在 
    To fill
    下。
  9. Humanize：对脚本运行 references/humanize.md 中的步骤 1 至 6，不为每条脚本单独输出报告。把它当作口头表达来阅读。不得出现创作者绝不会说的表达（voice.md 中的“Words I never use”），不得使用 em dash，不得出现 AI 句式，且必须保留所有事实。其分数写入脚本的 Score 行。
  10. 触发点和门槛：至少在各自合适的位置加入四个 script-rules.md 触发点，然后执行四项质量门槛检查（generic、structureless、interchangeable、viral）。任何门槛未通过，都要先重写再展示。

4. Format

4. 格式

Save to 
video-agent/scripts/week-YYYY-MM-DD.md
(the Monday of the week). One file per week; a single script goes into the current week's file.
markdown
undefined
保存到 
video-agent/scripts/week-YYYY-MM-DD.md
（该周的周一）。每周一个文件；单条脚本加入当周的文件。
markdown
undefined

Week of 2026-10-05

Week of 2026-10-05

#SlugTypeFormulaOfferLength
1hooks-too-longTeachThe mistake040 s
#SlugTypeFormulaOfferLength
1hooks-too-longTeachThe mistake040 s

1. hooks-too-long

1. hooks-too-long

On screen: Your hook is too long Hook: Your first sentence has 20 words. Nobody hears word 12.
script
Your first sentence has 20 words. Nobody hears word 12.
By then, most people already swiped.
I checked my last {{number}} shorts.
The ones that held past 3 seconds had short hooks.
Under 12 words, with the topic in the first 5.
Here's the part everyone skips.
Cutting is easy, picking the one point is the hard part.
So write your hook, then cross out everything before the point.
"In this video I'll show you how to write better hooks."
Becomes: "Your hook is too long."
Same idea, half the words, and it lands before they swipe.
Try it on your next three videos.
Follow for one script fix a day.
Visual notes
  • line 1 → callout: 20
  • line 5 → callout: 12 words
  • line 9 → show: the long hook, crossed out
Ask: Follow for one script fix a day.
Other hooks
  • (Stop / start) Stop explaining in your hook. Start with the result.
  • (Their words) "My hook is fine, it's the algorithm."
Triggers: gap 0s, self-recognition 0s, proof 6s, pattern break 20s, specificity 28s Score: hook 8/10 · human 10/10 · 111 words · 40 s at 165 wpm · offer 0 · gates ✓ To fill: {{number}}

The `script` block holds only the spoken lines: the creator reads it while recording, and video-edit reads it to edit.

Then show a READY summary and wait:

```text
READY · week of 2026-10-05 · 5 scripts (Teach, Proof, Story, Opinion, Teach) · 38 to 52 s
Saved: video-agent/scripts/week-2026-10-05.md
To fill: 3 placeholders
Reply yes to log them, or tell me what to change.
```

After a yes, add one line per script to `video-agent/log.md`:

```text
2026-10-05 | hooks-too-long | Teach | The mistake | why long hooks lose viewers
```
On screen: Your hook is too long Hook: Your first sentence has 20 words. Nobody hears word 12.
script
Your first sentence has 20 words. Nobody hears word 12.
By then, most people already swiped.
I checked my last {{number}} shorts.
The ones that held past 3 seconds had short hooks.
Under 12 words, with the topic in the first 5.
Here's the part everyone skips.
Cutting is easy, picking the one point is the hard part.
So write your hook, then cross out everything before the point.
"In this video I'll show you how to write better hooks."
Becomes: "Your hook is too long."
Same idea, half the words, and it lands before they swipe.
Try it on your next three videos.
Follow for one script fix a day.
Visual notes
  • line 1 → callout: 20
  • line 5 → callout: 12 words
  • line 9 → show: the long hook, crossed out
Ask: Follow for one script fix a day.
Other hooks
  • (Stop / start) Stop explaining in your hook. Start with the result.
  • (Their words) "My hook is fine, it's the algorithm."
Triggers: gap 0s, self-recognition 0s, proof 6s, pattern break 20s, specificity 28s Score: hook 8/10 · human 10/10 · 111 words · 40 s at 165 wpm · offer 0 · gates ✓ To fill: {{number}}

`script` 代码块只包含口头台词：创作者录制时朗读它，video-edit 读取它进行剪辑。

然后显示 READY 摘要并等待：

```text
READY · week of 2026-10-05 · 5 scripts (Teach, Proof, Story, Opinion, Teach) · 38 to 52 s
Saved: video-agent/scripts/week-2026-10-05.md
To fill: 3 placeholders
Reply yes to log them, or tell me what to change.
```

收到 yes 后，向 `video-agent/log.md` 中添加每条脚本对应的一行：

```text
2026-10-05 | hooks-too-long | Teach | The mistake | why long hooks lose viewers
```

5. Hand off

5. 交接

Show the week's table and the first script in full, then ask what to change. Next steps: record each script (phone, camera or webcam, one take per script, into 
video-agent/takes/<slug>.mp4
), then 
/video-edit <slug>
, then 
/video-publish <slug>
.
显示本周表格和第一条脚本的完整内容，然后询问需要修改什么。后续步骤：录制每条脚本（使用手机、相机或摄像头，每条脚本录一遍，保存至 
video-agent/takes/<slug>.mp4
），然后运行 
/video-edit <slug>
，再运行 
/video-publish <slug>
。

Honest limits

诚实的限制

  • A strong script is not a promise of views. Topic, timing, delivery and luck matter as much.
  • The hook score is a writing checklist, not a prediction.
  • Scripts only sound like the creator when voice.md has their real words. A thin voice file gives generic scripts: update it.
  • 优秀的脚本并不保证播放量。主题、时机、表达和运气同样重要。
  • 钩子评分是写作检查清单，不是播放量预测。
  • 只有当 voice.md 中包含创作者的真实原话时，脚本才会像创作者本人写的。voice.md 内容单薄时，生成的脚本必然会很通用；应更新该文件。