laohan-chuangzuo

name	laohan-chuangzuo
description	统一创作引擎，负责确定来源+创作口播初稿（不含封面提示词，封面由 laohan-fengmianqiuzhi 独立产出）。支持录屏视频(音频提取→转录)、URL队列(抓取→整理)、热点转译(选题→大纲)、结构化大纲、原始文本、自由主题六种输入。其他 skill 的写作环节统一调用本 skill。Use when 用户说"写口播稿""帮我写""录屏转口播""视频转口播稿""找选题""写一篇""热点""想做个视频""根据链接改写""改写文档""不知道拍什么"。
version	1.2.0

统一创作引擎

所有涉及口播稿写作统一调用本 skill。一份方法论，一个入口。

核心理念

一份方法论、一个入口——所有写作走同一个管线，避免不同入口产出质量参差不齐。素材先整理（Layer A/B）再写稿，确保口播稿建立在结构化理解之上，而非对原始素材的直接改写。

不适用场景

• 纯文本摘要/总结 → 用 summarize skill，不走创作流程
• 翻译 → 直接翻译，不需要口播稿格式
• 学术论文/技术文档写作 → 输出格式是口播稿，不适合正式文档

知识来源（唯一正本，symlink 到 OpenClaw workspace）

• 写作规则：references/style.md → ~/.openclaw/workspace-writer/knowledge/style.md（富贵 style.md v3.2）
• 整理方法：references/skill.md → ~/.openclaw/workspace-reviewer/knowledge/skill.md（进宝 skill.md v3.5）
• 转录方法：references/transcription.md（音频提取 + 语音转文字三级降级）
• 热点转译法：references/yuanchuang-method.md（转译选题法 + 角度库 + 标题公式 + 数据基准）
• 写作风格目录：references/styles/（每份 .md 是一种写作结构框架，Step -1 强制选择）

GitHub 上是实体文件（拷贝），本地用 symlink 自动同步。

输入模式

模式	输入	触发场景	内部处理
大纲模式	结构化大纲文件	热点转译后、外部传入	跳过整理，从 Step 2 开始
素材模式	原始文本/转录稿	录屏转录后、URL抓取后	先 Layer A/B 整理，再写稿
自由模式	主题关键词 或 无输入	用户直接调用	先生成大纲→确认→写稿

前置处理（将各种输入转化为三种模式）

Pre-A：录屏预处理

触发：用户提供了视频文件（mp4/mov 等）或说"录屏转口播""视频转口播稿"。

1. 提取音频：ffmpeg -i "<视频路径>" -vn -acodec libmp3lame -q:a 2 "/tmp/录屏音频_$(date +%s).mp3" -y
2. 语音转文字：三级降级（详见 references/transcription.md）
   • 硅基流动 API（免费，秒级）→ whisper-cli（本地快）→ Python whisper（最准）
3. 转录结果保存为 output/transcript-YYYY-MM-DD.md，自动进入素材模式

Pre-B：URL 队列预处理

触发：用户说"根据链接改写""链接内容改写""改写文档"。

1. 读取队列：检查 <cwd>/url.md，找第一个 - [ ] 且后面有 URL 的行
   • 没有待处理 → 告诉用户"队列为空"，结束
2. 抓取内容：根据平台自动选择方法（参考 laohan-xiazai 路由）
   • 抖音：移动端 UA → iesdouyin.com
   • B站：opencli bilibili
   • 其他：Jina Reader / agent-reach
3. 内容保存为 output/content-YYYY-MM-DD.md，进入素材模式
4. 完成后更新队列：将 url.md 中对应行改为 - [x] URL 关键词 ✅ YYYY-MM-DD

Pre-C：热点转译预处理

触发：用户说"找选题""写一篇""热点""不知道拍什么""想做个视频"。

从热点中提炼原创选题，生成大纲后进入大纲模式。详见 references/yuanchuang-method.md。

1. 获取热点：检查 output/热点-YYYY-MM-DD.md 是否已存在
   • 不存在 → 先调用 /laohan-redian 抓取
2. 筛选候选：AI 相关关键词匹配 + 间接相关打捞 → 交叉验证排序 → top 3-5
3. 读热点内容：用 opencli / agent-reach 抓正文，提炼核心争议/情绪/数据
4. 三个必答题（详见 yuanchuang-method.md）：
   • ① 跟 AI 有关系吗？② 我有真实经历吗？③ 路人为什么要在意？
   • 三个都通过 → 选题成立。否则回 Step 1 扩大范围
5. 选角度：反常识性 > 情绪共鸣 > 场景包装（角度库见 yuanchuang-method.md）
6. 生成标题：两句话标题（第一句主题+冲突，第二句态度+情绪），<30字
7. 输出大纲到 output/outline-YYYY-MM-DD.md，展示给用户确认
8. 用户确认后进入大纲模式

环境检测

STYLE_FILE = 检测顺序：
  1. <当前工作目录>/templates/style.md      ← 用户定制版（优先）
  2. <skill安装目录>/references/style.md    ← 标准版（symlink 到 OpenClaw）

ORGANIZE_FILE = <skill安装目录>/references/skill.md  ← 标准版（symlink 到 OpenClaw）

OUTPUT_DIR = <当前工作目录>/output/           ← 自动创建

执行清单（每步完成后打勾）

• Step -1: 风格选择（强制，不可跳过）
• Pre-A/B/C: 前置处理（如需）
• Step 0: 判断输入模式（大纲/素材/自由）
• Step 1: [素材模式] Layer A/B 整理
• Step 1.5: [自由模式] 生成大纲→用户确认
• Step 2: 选题确认（模式A/B选择+主题锁定）
• Step 3: 规划（12项，不可跳过）
• Step 4: 写口播稿
• Step 5: 质量检查（6关）
• Step 6: 通过/重试
• Step 7: 输出口播初稿（封面提示词不在本 skill 范围，由独立 skill laohan-fengmianqiuzhi 在后续流程产出）
• Post-A: [可选] NotebookLM 幻灯片

---

Step -1：风格选择（强制，不可跳过）

在执行任何创作动作之前，必须先让用户选择写作风格。不选择不执行。

执行方式：

1. 读取 references/styles/ 目录下所有 .md 文件
2. 列出所有可用风格，格式如下：

请选择本次口播稿的写作风格：

1. 通用 — 观点型/热点评论/行业分析，使用 style.md 默认规则
2. 教程型（五层模型）— 工具教程/操作指南，style.md + 五层结构+六要素+自检清单

请输入编号或名称。

3. 等待用户选择。用户不选择 → 不执行后续任何步骤，循环等待
4. 用户选择后：
   • 通用：直接使用 style.md 作为唯一规则，不加载额外风格文件
   • 教程型或其他：只读取对应的 references/styles/<选择>.md 文件，不加载 style.md。风格文件完全自包含，内部已含结构规则+语言质量规则+技法+自检清单
5. 默认不选：没有"默认选项"，每次触发都必须选择。防止风格混用

新增风格：往 references/styles/ 目录添加新 .md 文件即可，自动被发现。不需要修改本文件。

---

Step 0：判断输入模式

检查输入参数：

• 大纲模式：输入是 Markdown 文件，含 ## 核心论点 或 ## 论证路径 等大纲结构 → 跳到 Step 2
• 素材模式：输入是长文本（转录稿/网页抓取内容），无大纲结构 → 执行 Step 1
• 自由模式：无输入文件 或 只有主题关键词 → 执行 Step 1.5

Step 1：素材模式 — Layer A/B 整理

读 references/skill.md（进宝 Layer A/B v3.5），对原始素材执行：

Layer A（无损事实层）：

1. 素材信息表（来源/标题/作者/日期/时长）
2. 黄金开局钩子（痛点场景+渴望结果+核心冲突）
3. 结构化模块（按逻辑拆分为独立模块，编号标注）
4. 断言台账（每个可验证的事实单独列出）

Layer B（衍生加工层）： 5. 可操作步骤提取（教程型素材必填，非教程型标注"不适用"） 6. 痛点映射（观众的真实痛点→素材能解决哪个） 7. 延伸思考（反常识发现、跨域连接、可执行收获） 8. 核心选题提炼（一句话主题+标题底子+裁剪建议） 9. 教程型质量预评分（模式A时执行，6维度打分）

整理完成后，输出到 output/organize-YYYY-MM-DD.md，进入 Step 2。

Step 1.5：自由模式 — 生成大纲

无素材时，基于用户提供的主题（或交互询问）生成大纲：

# [两句话标题，＜30字]

## 核心论点（一句话）
[全篇围绕这一个论点]

## 论证路径
1. [切入点]
2. [递进]
3. [收束]

## 关键素材/数据/场景
- [素材点1]
- [素材点2]

## 内容模式
[模式A 教程型 / 模式B 观点型]

输出到 output/outline-YYYY-MM-DD.md，展示给用户确认后再进入 Step 2。

Step 2：选题确认（动笔前必须完成，不可跳过）

1. 选择内容模式：对照 style.md 第〇节判断模式 A（教程型）还是模式 B（观点型）
   • 选 A 信号：涉及具体工具/操作/配置/流程/对比测试
   • 选 B 信号：行业观点/新闻/深度思考/人物故事
2. 锁定主题：大纲/整理结果中的一句话主题 = 全篇锚点，不准自换
3. 判断素材类型：对照 style.md 第十一节素材类型适配表
4. 黄金开局钩子：锁定痛点场景+渴望结果+核心冲突
5. （教程型专用）可操作步骤清单：模式 A 时从素材中提取观众能跟着做的步骤

Step 3：规划（不写稿，不可跳过）

以 Step 2 锁定的论点为锚，输出以下规划：

1. 一句话论点
2. 内容模式 + 素材类型
3. （教程型）操作步骤规划：步骤骨架，标注每步用哪个素材数据
4. 核心主题贯穿规划：标题关键词在正文中出现 ≥5 个位置
5. 精华筛选：必须包含 / 选择性包含 / 跳过的内容
6. 场景规划：1个核心生活场景 + 代入式互动点
7. 改写策略：comprehensive（默认）/ angle / structure / depth
8. 目标读者
9. 技法选配：骨架 #1-#4 全选 + 反常识钩子 + 必选 #15/#18/#19 + 横向对比 ≥1 + 动态 3-4 条
10. 结构错位方案：原序 vs 叙述序，重合度 <60%
11. 金句/比喻处理：保留引用 or 替换（替换必须 ≥ 原版冲击力）
12. 增量点：≥2 处独立判断（新信息/新视角/新类比/新领域连接）

Step 4：写口播稿

按规划写稿。硬性要求：

• 固定开场白："你有没有这种感觉，"（8字固定），5秒内给锚点。教程型允许替换为专用钩子
• 第一行 # 标题（≤30字，模式A「动词+工具/场景+结果」，模式B「主题句+情绪句」）
• 严格遵循 style.md 所有规则
• 对照 Step 3 技法选配执行

写稿时同步自检：

• 关键节奏点 ≤15 字，短句比例 ≥60%
• 转场用 style.md 转场句式库，禁"首先其次最后"
• 标点：冒号→逗号，双引号→「」，「---」做句末停顿
• #19 签名互动"是不是有点意思"自然融入 3-5 次
• 至少 4 种废话感元素
• 节奏快慢交替：开头拉满→缓冲→加速→缓冲→结尾加速→减速

Step 5：质量检查

E. 内容底线（命中 = 不通过）：

• 素材覆盖度 ≥80%（对照整理结果模块列表）
• 有明确反常识论点
• 结尾行动号召源自素材可执行精华
• 标题核心词出现 ≥5 次
• 核心主题贯穿全文，无偏离段落
• 有 ≥1 个核心生活场景
• 时长预估：教程型 350-1200 字（约 1.5-5 分钟）

E2. 教程型专用（模式 A 时执行）：

• 有 ≥1 个明确操作步骤
• 有操作前后对比
• 标题含工具名+动作词
• 结尾有资源钩子 + 收藏引导 + 互动引导 + 行动式结尾

D. 原创性检查（命中 = 不通过）：

• 老韩增量 ≥2 处，无空泛总结
• 引用原话 ≤2 处，伪装成自己的 → 不通过
• 「我实测」类声明可溯源到素材

A. 正则检查（命中 = 不通过）：

• 模板连接词：首先/其次/总而言之/综上所述
• AI 填充：值得注意的是/毋庸置疑/显而易见
• 空洞大词：至关重要/开创性的/赋能/抓手/赛道（非比喻）
• 禁词：意味着什么|本质上|换句话说|不可否认|不难发现|作为一个|让我们|不妨|试想一下|值得一提的是

B. 禁区检查（禁用词+禁用标点+禁用结构，按 style.md 第九节）

B2. AI味检查（命中 = 不通过）：

• 体制化开头：不可否认/众所周知/在当今的时代/随着...的发展
• 空心强化：真正地/不得不说/坦率地说
• 三连排比：连续 3+ 相同句式
• 冒号堆砌：一段内 >3 个「：」后接列表
• 过度总结：由此可见/这充分说明/这告诉我们
• 假设复数："我们都知道"/"每个人都会"（应用"你"单数）

C. 技法检查：

• 骨架 #1-#4 全部体现
• 反常识钩子是全文核心论点
• #15 回环呼应：结尾照应开头
• #18 框架命名：名称出现 ≥3 次（如使用）
• #19 签名互动："是不是有点意思" 3-5 次
• 横向对比 ≥1 次
• 技法总计 ≥7 条
• 废话感 ≥4 种

Step 6：通过/重试

• ✅ 全部通过 → Step 7
• ❌ 不通过 → 第1次重试换角度，第2次重试换结构，仍不通过回 Step 3 重新规划（最多2轮）

Step 7：输出口播初稿

1. 口播稿写入 output/script-YYYY-MM-DD.md

封面提示词不在本 skill 范围。chuangzuo 的职责止于「确定来源 + 创作口播初稿」。封面由独立 skill laohan-fengmianqiuzhi 在后续流程（违规检查、校准评分通过、标题锁定后）单独产出。

---

Post-A：NotebookLM 幻灯片（可选，用户要求时执行）

用户要求生成幻灯片时，基于 script.md 用 NotebookLM 生成 PNG 图片：

1. mkdir -p <script.md所在目录>/slides
2. cp script.md <script.md所在目录>/slides/script.md
3. nlm notebook create "<标题>PPT"
4. nlm source add NOTEBOOK_ID --file <script.md所在目录>/slides/script.md
5. echo "y" | nlm slides create NOTEBOOK_ID --language zh-CN --length default
6. 轮询等待 completed（30秒间隔，最多20轮）
7. nlm download slide-deck --notebook NOTEBOOK_ID -o <script.md所在目录>/slides/<标题>.pdf
8. pdftoppm -png -r 200 <script.md所在目录>/slides/<标题>.pdf <script.md所在目录>/slides/slide

输出到 <script.md所在目录>/slides/slide-*.png

依赖：nlm CLI v0.5.25 + poppler

输出路径

output/
├── transcript-YYYY-MM-DD.md    ← Pre-A 录屏转录结果
├── content-YYYY-MM-DD.md       ← Pre-B URL 抓取内容
├── 热点-YYYY-MM-DD.md          ← Pre-C 热点简报
├── organize-YYYY-MM-DD.md      ← Step 1 整理结果（素材模式）
├── outline-YYYY-MM-DD.md       ← Step 1.5 大纲（自由模式/热点模式）
├── script-YYYY-MM-DD.md        ← Step 7 口播初稿（本 skill 唯一终产物）
└── (cover-prompts 不在此产出，由 laohan-fengmianqiuzhi 独立 skill 后续生成)

如果 output/ 不存在，自动创建。

依赖

依赖	用途	安装方式
ffmpeg	音频提取（Pre-A）	brew install ffmpeg
硅基流动 API Key	语音转文字（Pre-A，优先）	注册 siliconflow.cn
whisper.cpp	本地语音转文字（Pre-A，备选）	brew install whisper.cpp
nlm CLI + poppler	NotebookLM 幻灯片（Post-A）	pip install notebooklm-mcp-cli && brew install poppler
opencli	热榜/搜索（Pre-C）	npm install -g @jackwener/opencli

Pre-A/B/C 按需依赖，不使用对应模式时无需安装。

触发方式

# 录屏模式（传入视频文件）
/laohan-chuangzuo /path/to/recording.mp4
"把这个录屏视频转成口播稿"

# URL 队列模式
"根据链接改写""链接内容改写""改写文档"

# 热点转译模式
"找选题""写一篇""不知道拍什么""热点""想做个视频"

# 大纲模式（传入大纲文件）
/laohan-chuangzuo output/outline-YYYY-MM-DD.md

# 素材模式（传入原始文本文件）
/laohan-chuangzuo output/transcript.md
/laohan-chuangzuo output/content.md

# 自由模式（直接触发或给主题）
/laohan-chuangzuo
/laohan-chuangzuo "Claude Code 配置技巧"
"帮我写""写口播稿"

注意事项

• style.md 是通用模式的唯一写作规则来源。选择其他风格时，风格文件完全自包含，不需要加载 style.md
• 风格文件（references/styles/）是完全自包含的写作规范，每次创作前必须选择一个风格。通用模式无额外文件，直接用 style.md；其他模式只读对应风格文件
• skill.md 是唯一的整理方法来源，Layer A/B 规则以该文件为准
• 热点转译法详见 references/yuanchuang-method.md（转译案例+角度库+标题公式+数据基准）
• 转录技术详见 references/transcription.md（音频提取+三级降级）
• 二创脱敏规则（style.md 第十节）：素材来自他人内容时执行；原创内容（热点转译/自由模式）跳过
• 本 skill 不负责获取热点（那是 laohan-redian 的职责）
• 本 skill 不负责平台特定下载（那是 laohan-xiazai 的职责）