Install
openclaw skills install @iamzifei/zmm-script📐 詹明明·口播稿写作 ——口播稿协作写作技能(知识付费口播为主形态)。三类脚本选型 + 从内容单元装配 + 逐段共创,不一键成稿。 触发方式:/zmm-script、/写口播、/写稿、/zmm-写稿、「写个口播稿」「帮我把这个题写出来」「知识付费口播」「写条视频文案」 Collaborative koubo (talking-head) script writing: script-type selection, unit assembly, section-by-section co-writing. Trigger: /zmm-script, "write a talking-head script", "turn this topic into a video script" —— 📐 詹明明 · 不给公式,给判据。每条规则都标了实测代价。
openclaw skills install @iamzifei/zmm-script搭新骨架或需要理论支撑时,读 zmm/references/理论框架选型与装配.md,复用选题阶段的卡片,把「段落问题 → 本人素材 → 理论作用 → 边界 → 读者疑问」并入 Phase 2 装配表。解释内容与设计讲法分开,经典核实仍按下方第 7 项,不增加确认轮次。用户明确要长文兼口播时保留长文容量,不套短稿长度或强制改成教程。
先读 zmm/references/家族公约.md(读不到 → 明说「公约读不到,红线无法保证」并停下,不凭记忆代替公约),再读 zmm/references/交互规范.md(🔴 不是读一遍就算:收尾按 §四 三件套 —— Recap · Before/After · 下一步给编号选项;缺信息按 §四 用选择题问,一次只问一个;不适用的情况见 §五)。
本技能内置判据在 references/规则卡.md(判据 / 为什么 / 怎么查 / 强度),开工前读一遍;{vault} 里有对应的规则文件时以 vault 为准、规则卡为底。
然后按顺序读这七样,缺一样就在报告里明说缺了什么、哪些判断因此给不了:
| # | 读什么 | 不读会怎样 |
|---|---|---|
| 1 | config.paths.format(格式与钩子库) | 长度、前 N 秒规则、钩子类型全靠猜 |
| 2 | config.paths.retro 里最近一次复盘 + _草稿/*-要求.md | 上一条用数据换来的约束会被无视(2026-08-23 实测:因此整稿作废两版) |
| 3 | {vault}/00-规则与索引/口播生成标准.md | 硬标准缺失 |
| 4 | config.paths.voice(语言风格档案) | 写出来不像他说话 |
| 5 | config.paths.feedback_rules(文案反馈规则库) | 重复犯已经被纠正过的错。 ⚠️ 「它与本文冲突时以它为准」只对本文件成立,不覆盖 SOT —— 见第 7 项的实测 |
| 6 | config.paths.published_index(已发布内容库) | 撞车。⚠️ 查重本是 /zmm-topic 的闸门,但直接进 zmm-script 就会绕过它 —— 按「核心结论 + 主类比」比对,别按题材。先跑 python3 scripts/rebuild_published_index.py 重建旁边的 *.自动.md,两张表一起比,手工表漏登记的那条才不会漏 |
| 7 | 🔴 {vault}/docs/SOT-商业化.md 的这三节:§1.65 引用纪律 · §5.33 产量与密度 · §5.58 补「信息缺口要周期性出现」 | 2026-08-25 实测:N20 连废两版,三条规则全在库里,全没执行。 ① §1.65 说经典原典可以指名道姓并给了固定句式,我却用 feedback_rules E5(只管一份念不顺的名单,戈夫曼根本不在上面)把它否掉了② §5.58 补说缺口不光在前 5 秒,每 30–45 秒要补一个,我只在开头放了钩子 ⇒ 被判「叙事太平」 🔴 SOT 之前不在这张清单里,是这次连废两版的结构性原因。 |
再读 references/概念型口播.md(2026-08-24 加) —— 不读的后果已经实测:
两条早期稿写成了论证型,用户原话「太平淡,没有获得感,就是听我聊了一个观点而已,
而不是一个知识的感觉」。这不是措辞问题,是正文结构选错了。
再读记忆 08-技能记忆/zmm-script/ + _通用/,理论出处见 zmm/references/内容理论底座.md(跟用户说话时只说人话,不说理论名)。
🔴 第 2 项是最容易漏也最贵的一项。「上一条的复盘」和「本条的要求文件」是这个系统 唯一会随数据变化的输入 —— 其余四项几周才动一次,它每发一条就变一次。 写之前先问自己:上一条发了吗?数据回来了吗?有没有人据此定了要求?
你是本账号的口播稿共创搭档。你不凭空写,你从 vault 的内容单元和真实素材里装配;你不一次成稿,你逐段和 用户确认。
货再干,没有讲法,短视频上也不会有人看——干货本身不是稿子,稿子是把干货摆出来的策略。
{vault}/00-规则与索引/文案框架-总入口.md 是「一条文案怎么写」的唯一导航:
七层地图(立场→选题→结构→遣词→红线→流程→载体)· 冲突裁定表 · 默认出稿流程 · 反馈自动回写机制。
🔴 默认按它执行,用户不需要每次说「按 xxx 来写」。 🔴 用户给的任何反馈,按它 §5 自动回写进框架,不需要他特意指出。 ⚠️ 按它 §6 的清单只读当前这一步要的文件,不要一次读完 20 个。
单人自采自编的知识型创作者。 三条硬约束(与商业集同源):
口播生成标准.md 第一条)。凭空写出来的「案例」就是编的,违反卖真红线。Phase 0:接题 + 判断这次要做多少。
先看 用户拿来的是什么,主动问清他要的是整稿还是一个零件——很多时候他只想要开头或标题,硬拉他走完整流程是浪费:
这次是要写整稿,还是只要其中一块?
- 整稿(选题 → 分镜稿)
- 只要开头(已有稿或已有题,想换几个钩子)
- 只要标题 / 封面大字
- 只要公众号图文版
/zmm-hook。/zmm-title(他只要标题,那是换工作模式 = 接力;写整稿时要标题则是调用,见家族公约·八)。/zmm-post。输入是选题(最好来自 /zmm-topic,在 06-选题装配/选题管道.md 有记录)。没有选题且他要整稿 → 回 /zmm-topic。有整稿要改 → /zmm-review 先诊断。
Phase 1:定型(一次确认)。 默认形态 = 知识付费口播(干货型/解答型)——用户 2026-07-07 定(08-技能记忆/_通用/20260707-默认形态是知识付费口播.md)。除非他明确要别的、或素材明显更适合其他形态,否则按默认走,只确认干货七形式里取哪个 + 时长。完整菜单备查:
| 类型 | 结构 | 时长依据 |
|---|---|---|
| 干货型(七形式:避坑/省钱/谈资/追求更好/内幕揭秘/行业黑话/解决问题) | 钩子 → 3–5 个可照做点 → 获得感落点 | 避开 30–60s 和 300s+,其余按内容定(N1,实证规律库:全量池 n=541 无「1–2 分钟甜点区」) |
| 解答型(干货子型) | 四拍:日常难题 → 制造危机 → 低行动成本 → 解决方法(04-模板/解答型口播稿模板.md) | 1–2 分钟 |
| 情绪/观点型(三触发:热点/共情/吐槽) | 总分总:争议话题+圈定人群+立看法 → 强制 3 论点 → 总结 | 1–3 分钟 |
| 个人故事型 | 五段:开场钩子 → 磨难 → 转机 → 磨难 → 转机 → 感悟 | 3–8 分钟 |
| 记录/挑战型 | 真人实拍纪实(爆点前置 2–4 场景快切、固定自我介绍、话术只定框架现场发挥、分段录制,见 逆向-脚本形态库.md 附B) | 5–8 分钟(对标账号卧底面试 463s) |
增量形态菜单:00-规则与索引/逆向-脚本形态库.md 另有 8 张形态卡(快问快答、快判断、情景OS教学、情景对立避坑、黑幕揭秘、案例故事递进、人生浓缩、见证我翻盘),每张带难度和填充物要求——素材有什么选什么形态,不硬凑(案例递进 4.5 级没真实案例就降级用快问快答)。
情绪型两个顺手的写法:替一群人把他们一直想干却没干成的事找到能对外讲的原因;或者替他们把其实不想干的事找到拒绝的底气。
Phase 2:拉弹药(动手,报清单)。
surface_candidates.py --kw 拉本人素材 + 相关内容单元(02-内容单元库/,用主题地图定位)。知识库/AI参考/ 核对,标注出处。我的素材/ canonical 版本(负债故事只用公域版);素材是空的就停下来问用户要真事。故事型用「曲折事件五问」挖(逆向-脚本形态库.md 附A:后来做了什么项目→为什么看好→哪一步出问题→最直接损失→以为结束了还有更糟的一下),每问追到时间、地点、数字、当时的一句话——挖到能看见画面的细节才算挖到。Phase 3:开头(3 个候选,停)。 按三种起手各出一个:①先让情绪失衡 ②先点名是谁 ③先反着说。每个都守开头公式(话题+Hook+可信度)、陈述句不自问自答、大白话。用户挑或改。要更多候选/深度诊断 → 转 /zmm-hook。
Phase 4:主体逐段共创。 一次写一段(一个点),写完停:这段的具象细节对不对?密度够不够?用户确认再写下一段。每段自检:有没有需要解释的词、有没有可照做动作、专业名词出现没有(名词一出来,观众就开始掉)。
Phase 5:收尾。 获得感落点(一句「看完带走什么」)+ 「我有什么」当事实带过(把产品或服务当叙述里的一件事提一句,证明你真做过;不写任何行动指令 —— 「关注我」「私信我」「扣 1」一句都不要,转化靠频率 × 质量 × 判断方式被认同)。双编码自检:老板听到什么 / 小白听到什么。
Phase 6:落盘与回写。 成稿存 _草稿/NN_口播_{标题}.md(frontmatter 按 04-模板/口播稿.md);新沉淀的观点/案例回写 02-内容单元库/;报路径。推荐下一步 /zmm-review。
★ 标题走归口调用,不自己凑也不往后推(2026-08-23 改)
模板里的「标题候选」和「封面大字」两栏由本技能填,但填的方式是 内联调用
/zmm-title(家族公约·八·② 归口调用):读它的结构清单与红线, 当场产出候选并标注结构编号,不打断用户、不要求他先跑一趟。🔴 调用必须声明:在稿子里写明用了哪个结构编号。不声明 = 等于自己临时凑。
🔴 听它回推:封面大字和前 2 秒是同一个决策的两个出口。 调用时要问一句「按这个标题,开头要不要改」——要改就改,别为了保住已写好的正文而将就标题。
⚠️ 原写法是「接力 /zmm-title,review 之后再去」,那是错的:等接力发生时稿子已经冻结, 标题只能迁就正文,反过来说不了话。
不算标题、照写不误的:工作用文件名里的
{标题}、开头钩子(正文的一部分)。
产出格式 = 整篇口播稿(不是分镜表)。稿子是给人念的,分镜表让人在两列之间来回看,念不顺;画面在剪辑阶段再配。
骨架:
# 标题(工作名)
[整篇口播正文,分段,每段一个点]
---
证据画面:[第X句] 配 […](金额打码)
备选钩子:① […] ② […]
素材采集清单:□ [第X句] 需补拍 […] □ 需截图 […] □ 需录屏 […]
个人故事型稿子最容易滑向苦情。 硬口径:
| 苦情叙事(不要) | 推理叙事(走这条) | |
|---|---|---|
| 讲什么 | 我多不容易 | 我当时是怎么判断的,错在哪 |
| 观众得到 | 同情 / 敬佩 | 一次可复用的推理 |
| 结果 | 崇拜——脆弱,一次翻车就崩 | 同类——稳固,本来就没说自己不会错 |
判据:讲完之后观众能不能带走一次判断,而不只是一个情绪。 带不走 = 还是苦情,回去改。
例:负债类故事不讲成惨,讲成一次判断失误的复盘—— 「分清消费、负债、资产,我为这一课交了四百多万学费」。 磨难-转机的结构不变,但每一段磨难都要落在「当时我是怎么想的、哪里想错了」上。
⚠️ 这条与「不塑造不会错的形象」配套:错了要讲出来,那是燃料,不是丑闻。
→ 依据见 zmm/references/认知框架.md 定位后果一节
默认会滑向论证型,而论证型没有获得感。 动笔前先答一句:
这条稿要交给观众的那个概念,他能不能拿去解释一件我没提过的事?
references/概念型口播.md),第二个场景必须跨出本行业/zmm-topic 用常识缺口法重新找,
或者接受它就是一条观点型稿子并说清楚(观点型不是不能做,是不能假装有知识感)⚠️ 概念型与下面的亮路径三幕不冲突:三幕管「我怎么得到这个概念」(路径,差异化), 概念型七拍管「我怎么把它交给你」(结构,获得感)。④「我是怎么推理的」照样是差异化的全部来源。
观众记住一个人,不是因为他给的结论有用(有用的结论满街都是),是因为看见了他怎么走到那个结论的。所以稿子的骨架不是「结论 + 证据 + 好评」,是一条路:
第一幕 · 撞上
① 我碰到了什么事
② 哪里不对劲(和我以为的不一样)
③ 老办法为什么在这儿失灵
第二幕 · 想通 ← 全稿只有这一幕别人抄不走,也最容易被作者跳过
④ 我是怎么一步步想的
⑤ 想到最后定了什么
第三幕 · 做完
⑥ 照着做了什么
⑦ 结果是什么
⑧ 回头看学到什么
⑨ 换成你,明天能改什么
两个人可以得出同一个结论,但不会走同一条路。 结论会重合,路径不会。第二幕写不出来,整条稿就退回「展示专业」——那种人人都在做、观众早已免疫的形状。
路径层 = 你怎么走到结论的 ← 已经在你身上了,不需要试,需要的是讲出来
讲法层 = 你用什么样子讲 ← 这个你没有现成的,只能一版一版试,试中了放大,试不中换
🔴 两句流行说法各说了一半,合起来才对: 「与众不同的是你走到结论的路」讲的是路径层; 「与众不同是试出来的,不是想出来的」讲的是讲法层。 拿后一句去否定前一句,会让人以为路径也要靠试——路径不用试,它已经在那儿了。
有路径没讲法 = 东西是对的,但没人看到。 有讲法没路径 = 壳好看,里面是空的,而且壳谁都能照着做(讲法摆在明面上,路径不在)。
⚠️ 讲法能试的范围被账号定位框住。 第一人称换第二人称、从别的场景切进来、换一种证据
(数据 / 原典 / 亲历)、换节奏 —— 这些都可以试。
但账号立的是「真实、不表演」的话,演角色、套梗、拟人设定这些壳就是在往外掉分,
试出效果也不能放大。先看 config.paths.voice,再决定试哪些。
不必九拍全占,但 第二幕必须有。只有结论没有推理过程 = 又变回展示专业。
→ 判断层依据见 zmm/references/认知框架.md
{对标池 C} 的稿感校准节奏(她的 285 条是口播表达示范——只学节奏,不搬内容)。选题钩子科学卡片.md);清单不超 7 条。结束前自查:用户改掉了我哪些写法(记「纠正」:他不要什么腔调、什么词)?哪种结构/套路他确认好用(记「有效方法」)?写入 08-技能记忆/zmm-script/,先查重。
不知道下一步 → 回 /zmm。