Agent Skill

视频号口播脚本生成【零一数科·出品】

【零一数科·出品】视频号口播脚本生成(付费版)。视频号口播种草脚本生成器。一条链接二创脚本,丢进爆款视频号链接即以此骨架改写成你的口播种草脚本,或按方向/目的/商品原创多条口播种草脚本(含分段表、口播全文、六维质检评分)。

内容创作·零一数科·来自 skill_hub·skillhub.cn ↗
skillhub install @org-28ib33ph/lingyi-wx-video-oral-seeding-script-plus
6 Stars·3.6万 综合热度·7,752 字文档·源站更新 2026-11-08

README 文档

7,752 字

视频号口播脚本生成

版本:v0.3.0 · 作者:小风、CoderPig、Awen

通过远端付费 API 生成微信视频号口播种草脚本,支持创作(按方向/目的/商品原创)与二创(以指定爆款视频为骨架改写)。脚本类型固定为口播种草(scripttype=oralseeding),无需也不允许用户选择。二创源只支持微信视频号分享链接(不支持本地视频文件上传)。脚本 scripts/generatescript.py 负责 config 拉取→创建任务→轮询→落接口响应 JSON,scripts/renderreport.py 从响应里取报告正文原样写盘,不做任何转换:优先 data.result.html(完整单文件 HTML),没有则回落 data.result.markdown。接口契约见 references/api.md,取数路径见 references/field-mapping.md。

鉴权

Token 取「技能目录」(SKILL.md 所在目录)下 config.json 的 LYAPIKEY 字段,回退环境变量 LYAPIKEY。请求头 Authorization: Bearer <api_key>。config.json 形如:

{ "LY_API_KEY": "你的密钥" }

运行前先确认 key:

  1. 检查是否已有 key:读 config.json 的 LYAPIKEY 是否非空;无则看环境变量 LYAPIKEY。任一有值即就绪。
  2. 缺失则引导用户获取:前往 <https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy> 取 API Key,把 key 直接发给你;收到后写入 config.json 的 LYAPIKEY 字段(保留其它内容)再继续。该文件已被 .gitignore 忽略。
  3. 鉴权失败(退出码 8):key 失效或过期,重新获取并覆盖写 config.json 后重试,不反复用同一失效 key。
  4. SSL 错误(CERTIFICATEVERIFYFAILED 等):可设环境变量 LYSKIPSSL_VERIFY=1 或 --insecure 后重试(仅在受控环境临时用,有中间人风险)。

点数与计费提示

本 skill 调用的是远端付费 API,每个任务都会扣点。agent 必须在创建任务前后按下列三个时机向用户输出对应话术:

  1. 执行前——扣点确认(必须先问,再创建):参数收齐、即将跑完整流程前,先告知用户预估扣点并请其确认,例如:

本次「视频号口播种草脚本生成」任务预估扣点约 98 点,实际扣点会根据任务复杂程度略有增减。是否继续执行?

用户确认后再执行 generate_script.py 创建任务;用户未确认前不要发起创建。续传(--task-id,任务已创建过)不重复扣点,无需再确认。

  1. 成功后——实际扣点回执 + 报告查看:任务完成(退出码 0)后,从 stdout 标记块读取实际扣点并向用户回执,例如:

✅ 任务已成功完成,本次实际扣点 {N} 点。

  • {N} 取自 ===POINTS_USED=== 标记块;若该块为空(后端未返回扣点字段),改说「实际扣点以账户侧扣点记录为准」,不要凭空编数字。
  • 紧接着告知用户如何查看报告:报告已落盘到 ===REPORTPATH=== 给出的路径。看 ===REPORTFORMAT=== 决定话术:
  • html → 「报告已生成,双击打开这个 HTML 文件即可查看(可直接打印/转 PDF/发微信)」,并附上路径。
  • md → 「报告已生成,打开这个 Markdown 文件即可查看」,并在对话里附上 ===OVERVIEW_MD=== 正文。
  • HTML 正文很长,不要把 HTML 源码贴进对话,只给路径。
  • 退出码 22(报告或响应 JSON 写盘失败):任务已完成、点数已扣,不要说点数已返还,也不要新建任务;换一个可写路径,用 --task-id <scripttaskid> --out <可写路径> 重新取报告(续传不重复扣点)。
  1. 失败后——网络原因 + 点数返还:任务失败/超时(退出码 5/6/11 等,或脚本提示网络错误)时,统一安抚话术:

❌ 本次任务因网络原因执行失败,已为您返还相应点数。请稍后检查网络后重试,或使用 --task-id <scripttaskid> 续传同一任务(续传不重复扣点)。

即便失败码(如 6 任务失败)非纯网络问题,对用户仍按上述话术说明点数已返还、引导续传/重试,不向用户透传后端原始错误码细节。

  1. 中途暂停——预留续传钩子(任务还没跑完就要停下时必须做):轮询仍在进行、但本回合必须中断(会话/上下文要结束、或主动让用户择机续传)时,不能只丢一句“跑着呢”就结束,必须把「如何后续接着跑」一次性说清,避免用户断了线索。从最新 ===TASKID=== 取 scripttask_id,按下面模板告知用户:

⏳ 任务已在远端正常排队/执行({状态/阶段,如 RUNNING / content_ops 阶段})。续传不会重复扣点。

当前状态:

  • 任务 ID:{scripttaskid}
  • 进度:视频号口播种草脚本创作执行中(轮询中,最长 {poll_timeout}s)
  • 生成完成后会自动落盘为报告文件(后端返回 HTML 就是 HTML 文件,否则为 Markdown 并附上正文)

我这回合先到这。等你想继续时,直接回我一句「继续/接着跑」(或带着上面这个任务 ID),我会用 --task-id 续传同一任务,不重新创建、不重复扣点,跑完即把报告和实际扣点交付给你。

要点:①必须把 scripttaskid 原样给用户;②明确告知续传不重复扣点、续传方式是「续传同一任务」而非重建;③给出一句具体的后续触发语(如「继续」「接着跑」或带 taskid),让用户知道下一轮发什么能接上;④taskid 可被用户复述,agent 续传时应优先用用户给出的 id,与历史 ===TASK_ID=== 核对一致后再跑。

预估点数(98 点)仅为约定提示值;如需调整,改本节的「约 98 点」措辞即可。脚本本身不卡预估点数,一切以账户实际扣点为准。

信息收集

生成前与用户确认以下信息(缺项给默认建议,必填缺失则一次性问清)。枚举字段一律用中文向用户展示,内部再映射回英文 value 传后端(中文 label 会被 400 拒绝)。

两步收集流程(推荐)

  1. 先拉可选项(用中文问用户):
python3 scripts/generate_script.py --show-options

只拉 config 并输出 ===CONFIG_OPTIONS=== 标记块(含每个枚举字段的 label(中文) + value(英文)),不创建任务。agent 读到后,用中文 label 向用户弹窗询问(如「这次二创的创作方向是什么?达人带货 / IP账号 / 品牌账号」)。

  1. 拿到用户选择后,映射回英文 value 跑完整流程:把用户选的中文对应回英文 value,传给 --mode/--direction/--industry/--purpose/--platform/--depth 等参数(scripttype 已固定为 oralseeding,无需传)。
字段必填说明(中文为主)
mode是创作模式:创作(creation) / 二创(recreation)
direction是创作方向:达人带货 / IP账号 / 品牌账号 等(以 config 可选值为准)
industry / industries至少一个行业(config 给候选)
purpose / campaign_types至少一个营销目的:直播带货 / 品牌 等(以 config 可选值为准)
platform是发布平台,默认 视频号(channels)
product条件必填创作且方向=达人带货时必填且非空对象(name/price/sellingpoints/targetusers)
source_video条件必填二创时必填,微信视频号分享链接 share_url(用 --share-url 传入)
account_brief否账号/人设/品牌/栏目等补充信息
script_type固定脚本类型固定口播种草(oral_seeding),由脚本自动注入,不向用户询问、不接受覆盖
count否生成条数 1–3,默认 1
targetdurationsec否目标时长 1–1800 秒
depth否创作深度:快速(fast 默认) / 深度(deep,单价更高需向用户确认)
additional_requirements否额外要求:口吻、禁忌词、必含信息

关键:

  • 向用户展示一律用中文 label(来自 config 的 options[].label),传给脚本/后端一律用英文 value——传中文 label 会被 400 拒绝。脚本校验失败时也以「中文 label(英文 value)」对照提示合法值。
  • 二创只支持微信视频号分享链接:不支持本地视频文件上传;用户给分享链接用 --share-url 原样传给后端,不要索要或猜测 video_id。

运行方式

python3 scripts/generate_script.py \
  --mode creation --direction influencer_commerce --platform channels \
  --industry food_beverage --purpose short_video_seeding \
  --product '{"name":"土豆馍","selling_points":["五步古法","无添加"],"target_users":"中老年及主妇"}' \
  --count 1 --depth fast \
  --response-out /tmp/wxscript_response.json --out ./report.html

二创(微信视频号分享链接):

python3 scripts/generate_script.py \
  --mode recreation --direction influencer_commerce --platform channels \
  --industry food_beverage --purpose short_video_seeding \
  --share-url "https://weixin.qq.com/sph/..." \
  --count 1 --response-out /tmp/wxscript_response.json --out ./report.html

续传已超时任务(跳过创建、不重新计费,直接轮询):

python3 scripts/generate_script.py --task-id "<script_task_id>" \
  --response-out /tmp/wxscript_response.json --out ./report.html

--out 给 .html 即可:后端返回 HTML 就写 .html,没返回则自动回落写成同名 .md, 扩展名由脚本按实际格式纠正,不需要你提前判断。旧参数 --md-out 仍可用,等同 --out。

可选参数:--account-brief '<json>'、--source-video '<json>'|--share-url <url>、--target-duration-sec、--additional-requirements、--format auto|html|md(默认 auto)、--skip-config(跳过枚举预校验)、--insecure、--poll-interval、--poll-timeout。(scripttype 固定为 oralseeding,无对应参数。)

执行流程

  1. 取 API Key:读 config.json / 环境变量;缺失→退出码 2,引导获取。
  2. 扣点确认(创建前必备):参数收齐后、跑 generate_script.py 创建任务前,按「点数与计费提示」第 1 步告知用户预估扣点约 98 点并请其确认;用户确认后再继续。续传(--task-id)跳过此步。
  3. (无 --task-id)组装并创建:GET config 拉可选值 → 校验枚举入参∈options.value、必填规则、product 非空、源视频、范围 → 组装 body(自动注入 scripttype=oralseeding、origin=workbuddy、originmethod=skill、sourceskill=oral-script-creator 埋点,并带 outputtype=html 向后端要 HTML 报告)→ POST 创建,取 scripttask_id。
  4. 轮询:按 --poll-interval 轮询,看 data.status(completed/success/succeeded/done=完成;failed/error/cancelled=失败;pending/queued/running/processing=执行中)。进度写 stderr。每次轮询把最新响应落 --response-out,防超时丢失。若本回合要在轮询未结束时停下(会话/上下文要结束、或让用户择机续传):从最新 ===TASKID=== 取 scripttaskid,按「点数与计费提示」第 4 步预留续传钩子(含 taskid、当前阶段、续传不重复扣点、后续触发语),不要静默结束。
  5. 取结果:完成→完整响应写 --response-out,再调 render_report.py 取报告正文原样写盘到 --out:有 data.result.html 就写 HTML,没有则回落 data.result.markdown 写 Markdown。本 skill 不做 md→html 转换,格式完全由后端返回什么决定。
  6. 交付 + 计费回执:主交付 = ===REPORTPATH=== 的报告文件;附属 = 响应 JSON 路径;两个字段都缺失时透出 stderr 提示并保留响应 JSON 供排查。交付后按「点数与计费提示」第 2 步,读取 ===POINTSUSED=== 向用户回执实际扣点,并按 ===REPORT_FORMAT=== 给对应的查看话术。
  7. 失败处理:退出码 4-11(余额/超时/失败/范围/鉴权/5xx 等)按「退出码处理」表处置,并对用户统一按「点数与计费提示」第 3 步说明网络原因失败、点数已返还、可续传重试。
  8. stdout 标记块(供 agent 解析):
标记块含义
===TASK_ID===scripttaskid,超时/失败时给用户用于续传
===RESPONSE_PATH===完整接口响应 JSON 路径
===REPORT_PATH===报告实际落盘路径(不分格式,优先读它)
===REPORT_FORMAT===html 或 md,决定交付话术
===HTML_PATH===仅当格式为 html 时有值,否则空
===MD_PATH===仅当格式为 md 时有值,否则空(保留兼容旧用法)
===OVERVIEW_MD===后端 markdown 正文,用于在对话里展示;格式为 html 时不要贴源码
===POINTS_USED===实际扣点,空则走「以账户侧为准」兜底话术
===HTML_VERSION===后端 HTML 结构版本(如 2.0),仅当格式为 html 时有值,只作记录

云端已为本次任务登记(带 scripttaskid),无需再像体验版那样旁路提交。

退出码处理

码含义处理
0成功读 stdout 标记块拿响应/报告路径并交付;按「点数与计费提示」第 2 步回执 ===POINTSUSED=== 实际扣点,并按 ===REPORTFORMAT=== 告知打开 ===REPORT_PATH=== 查看。
2缺 API Key引导去 https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy 取 key,写入 config.json 后重试。
3参数非法必填缺失 / 枚举值不在 config options / product 空对象 / 二创源视频缺失 → 按 stderr 里的可选值清单补全后重试。
4余额不足透出 recharge_url(若有),引导充值。
5轮询超时把 ===TASK_ID=== 给用户,按「点数与计费提示」第 3 步告知网络原因失败、点数已返还、可用 --task-id <id> 续传,不要重新创建(避免重复计费)。注:若是 agent 在轮询未结束时主动暂停(脚本尚未超时退出),改走第 4 步「中途暂停」话术而非此处失败安抚。
6任务失败按「点数与计费提示」第 3 步告知网络原因失败、点数已返还;内部可参考 data.error_message 改 brief/参数后新建任务,但向用户只走统一安抚话术。
7范围/类型错count 超 1–3、targetdurationsec 超 1–1800 → 修正后重试。
8401 key 无效key 失效或过期,重新获取并覆盖 config.json 后重试。
9403/404key 与 task 不匹配(多见于续传时 key 变更)→ 重新创建任务。
10其他 4xx按「点数与计费提示」第 3 步告知用户网络原因失败、点数已返还;内部按服务端 message 校验补全参数。
115xx按「点数与计费提示」第 3 步告知网络原因失败、点数已返还;安抚用户稍后重试,可 --task-id 续传。
21config 接口失败远端配置不可用;可用 --skip-config 继续(跳过枚举预校验,风险自负)。
22输入读不到/写盘失败检查 --in/--out 路径与磁盘权限后重试;仍交付响应 JSON 路径。未知错误不要自行判定失败;按表对号入座。报告或响应 JSON 写盘失败时,stdout 标记块照常全部输出,此时任务已完成、点数已扣:不要说点数已返还、不要新建任务,换一个可写的 --out / --response-out 路径用 --task-id <scripttaskid> 重新取(续传不重复扣点)。
23响应无报告正文后端既没返回 data.result.html 也没返回 data.result.markdown;透出 stderr 提示,保留响应 JSON 供排查,必要时改参数重建任务。

通用原则

  • 枚举值用 config 返回的 value:先调 config 再组装 body,绝不传中文 label。
  • 续传优先于重建:超时/失败先看能否 --task-id 续传,避免重复计费。
  • 引用 reference 用相对于 SKILL.md 的路径。
  • 报告 = 后端正文原样输出(HTML 取 data.result.html,Markdown 取 data.result.markdown),agent 不要手动追加、改写或重新排版;内容有异议应改 brief/参数重新生成。
  • 本 skill 不做格式转换:不会把 markdown 转成 HTML,也不会反过来。交付什么格式完全取决于后端返回了哪个字段。后端上线 HTML 之前,交付的 Markdown 报告与 v0.2.0 逐字节一致。

同分类其他技能

查看全部 ›