| 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 等）或说"录屏转口播""视频转口播稿"。
- 提取音频：
ffmpeg -i "<视频路径>" -vn -acodec libmp3lame -q:a 2 "/tmp/录屏音频_$(date +%s).mp3" -y
- 语音转文字：三级降级（详见
references/transcription.md）
- 硅基流动 API（免费，秒级）→ whisper-cli（本地快）→ Python whisper（最准）
- 转录结果保存为
output/transcript-YYYY-MM-DD.md，自动进入素材模式
Pre-B：URL 队列预处理
触发：用户说"根据链接改写""链接内容改写""改写文档"。
- 读取队列：检查
<cwd>/url.md，找第一个 - [ ] 且后面有 URL 的行
- 抓取内容：根据平台自动选择方法（参考 laohan-xiazai 路由）
- 抖音：移动端 UA → iesdouyin.com
- B站：opencli bilibili
- 其他：Jina Reader / agent-reach
- 内容保存为
output/content-YYYY-MM-DD.md，进入素材模式
- 完成后更新队列：将 url.md 中对应行改为
- [x] URL 关键词 ✅ YYYY-MM-DD
Pre-C：热点转译预处理
触发：用户说"找选题""写一篇""热点""不知道拍什么""想做个视频"。
从热点中提炼原创选题，生成大纲后进入大纲模式。详见 references/yuanchuang-method.md。
- 获取热点：检查
output/热点-YYYY-MM-DD.md 是否已存在
- 不存在 → 先调用
/laohan-redian 抓取
- 筛选候选：AI 相关关键词匹配 + 间接相关打捞 → 交叉验证排序 → top 3-5
- 读热点内容：用 opencli / agent-reach 抓正文，提炼核心争议/情绪/数据
- 三个必答题（详见 yuanchuang-method.md）：
- ① 跟 AI 有关系吗？② 我有真实经历吗？③ 路人为什么要在意？
- 三个都通过 → 选题成立。否则回 Step 1 扩大范围
- 选角度：反常识性 > 情绪共鸣 > 场景包装（角度库见 yuanchuang-method.md）
- 生成标题：两句话标题（第一句主题+冲突，第二句态度+情绪），<30字
- 输出大纲到
output/outline-YYYY-MM-DD.md，展示给用户确认
- 用户确认后进入大纲模式
环境检测
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：风格选择（强制，不可跳过）
在执行任何创作动作之前，必须先让用户选择写作风格。不选择不执行。
执行方式：
- 读取
references/styles/ 目录下所有 .md 文件
- 列出所有可用风格，格式如下：
请选择本次口播稿的写作风格：
1. 通用 — 观点型/热点评论/行业分析，使用 style.md 默认规则
2. 教程型（五层模型）— 工具教程/操作指南，style.md + 五层结构+六要素+自检清单
请输入编号或名称。
- 等待用户选择。用户不选择 → 不执行后续任何步骤，循环等待
- 用户选择后：
- 通用：直接使用 style.md 作为唯一规则，不加载额外风格文件
- 教程型或其他：只读取对应的
references/styles/<选择>.md 文件，不加载 style.md。风格文件完全自包含，内部已含结构规则+语言质量规则+技法+自检清单
- 默认不选：没有"默认选项"，每次触发都必须选择。防止风格混用
新增风格：往 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（无损事实层）：
- 素材信息表（来源/标题/作者/日期/时长）
- 黄金开局钩子（痛点场景+渴望结果+核心冲突）
- 结构化模块（按逻辑拆分为独立模块，编号标注）
- 断言台账（每个可验证的事实单独列出）
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：选题确认（动笔前必须完成，不可跳过）
- 选择内容模式：对照 style.md 第〇节判断模式 A（教程型）还是模式 B（观点型）
- 选 A 信号：涉及具体工具/操作/配置/流程/对比测试
- 选 B 信号：行业观点/新闻/深度思考/人物故事
- 锁定主题：大纲/整理结果中的一句话主题 = 全篇锚点，不准自换
- 判断素材类型：对照 style.md 第十一节素材类型适配表
- 黄金开局钩子：锁定痛点场景+渴望结果+核心冲突
- （教程型专用）可操作步骤清单：模式 A 时从素材中提取观众能跟着做的步骤
Step 3：规划（不写稿，不可跳过）
以 Step 2 锁定的论点为锚，输出以下规划：
- 一句话论点
- 内容模式 + 素材类型
- （教程型）操作步骤规划：步骤骨架，标注每步用哪个素材数据
- 核心主题贯穿规划：标题关键词在正文中出现 ≥5 个位置
- 精华筛选：必须包含 / 选择性包含 / 跳过的内容
- 场景规划：1个核心生活场景 + 代入式互动点
- 改写策略：comprehensive（默认）/ angle / structure / depth
- 目标读者
- 技法选配：骨架 #1-#4 全选 + 反常识钩子 + 必选 #15/#18/#19 + 横向对比 ≥1 + 动态 3-4 条
- 结构错位方案：原序 vs 叙述序，重合度 <60%
- 金句/比喻处理：保留引用 or 替换（替换必须 ≥ 原版冲击力）
- 增量点：≥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：输出口播初稿
- 口播稿写入
output/script-YYYY-MM-DD.md
封面提示词不在本 skill 范围。chuangzuo 的职责止于「确定来源 + 创作口播初稿」。封面由独立 skill laohan-fengmianqiuzhi 在后续流程（违规检查、校准评分通过、标题锁定后）单独产出。
Post-A：NotebookLM 幻灯片（可选，用户要求时执行）
用户要求生成幻灯片时，基于 script.md 用 NotebookLM 生成 PNG 图片：
mkdir -p <script.md所在目录>/slidescp script.md <script.md所在目录>/slides/script.mdnlm notebook create "<标题>PPT"nlm source add NOTEBOOK_ID --file <script.md所在目录>/slides/script.mdecho "y" | nlm slides create NOTEBOOK_ID --language zh-CN --length default- 轮询等待 completed（30秒间隔，最多20轮）
nlm download slide-deck --notebook NOTEBOOK_ID -o <script.md所在目录>/slides/<标题>.pdfpdftoppm -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
"把这个录屏视频转成口播稿"
"根据链接改写""链接内容改写""改写文档"
"找选题""写一篇""不知道拍什么""热点""想做个视频"
/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 的职责）
