| name | sample_writer |
| description | 简化版的文稿生成技能。能够直接读取图书/文档,提取核心论点,生成高品质、口语化的视频号/抖音读书解说文稿并输出标准 JSON 格式。 |
sample_writer - 极简视频文稿写作助手
这是一个简化版的长文档/书籍读书解说文稿生成技能。它将阅读、撰写和润色流程合并,帮助你快速产出口语化、有传播力的中文视频号/抖音文稿。
目标字数配置
本配置是本 skill 中正文成稿字数的唯一真相来源。
draft_min_chars: 1000 # 初稿最小字数
final_target_chars: 1200 # 终稿目标字数
主流程
你只需要遵循以下三个核心步骤,不需要记录复杂的覆盖台账。运行过程中的中间产物请在工作目录(项目输出的 text 文件夹)中落盘:
-
快速阅读与梳理:
- 快速浏览输入文件的核心内容(重点阅读开头、目录、核心章节和结尾)。
- 提取出全书真正试图回答的一个核心问题、作者的核心解答框架以及3个关键案例或论点。
- 将上述提取的核心提纲作为中间产物保存至
_extract.txt。
-
初稿写作(口语化):
- 依据
references/writing_guide.md 的规范,撰写一份结构清晰、大白话、适合直接口播的初稿,字数达到 draft_min_chars。
- 将初稿作为中间产物保存至
_draft_v1.txt。
-
自检与包装输出:
- 进行自我修正,去除多余废话、书面语和“AI味”词汇,并将修正后的终稿保存至
_draft_final.txt。
- 从
_draft_final.txt 生成标题、封面文案、金句、互动和转发引导,并包装为最终 JSON 写入 {output_json}。
- 确保输出的
{output_json} 能够被 Python json.loads 解析,且完全符合下面的 JSON 输出契约。
最终 JSON 输出契约
最终只输出严格的 JSON 对象,不带有任何 Markdown 标记或额外解释。
{
"source_name": "作品名称(如:自私的基因),不要带文件名后缀",
"video_titles": ["3条候选视频标题,互不重复,信息完整"],
"cover_titles": ["3条封面主标题,4到10字,短、强、易扫读"],
"cover_subtitles": ["3条封面副标题,15字以内"],
"golden_quotes": ["3条开场金句,观点鲜明,能让人停下来听"],
"comment_hook_options": ["3条评论引导,优先判断句、对照句、追问句,不像运营话术"],
"share_hook_options": ["3条转发引导,像观众看完后会自然转发的话"],
"content": "完整口播终稿,字数在 final_target_chars 左右,保留自然段落换行,不写 Markdown 标记或小标题",
"total_length": 0
}
total_length 为 content 的实际字符数。
content 必须完全口语化,保留自然段落换行,且绝对不能有小标题、Markdown 或列表格式。