视频号挂车爆单短视频脚本生成【零一数科·出品】

SKILL.md 节选

# 视频号挂车爆单短视频脚本生成
> 版本：v0.6.0 · 作者：小风、CoderPig、Awen

通过远端付费 API 生成微信视频号爆款脚本，支持**创作**（按方向/目的/商品原创）与**二创**（以指定爆款视频为骨架改写）。二创源只支持**微信视频号分享链接**（不支持本地视频文件上传）。脚本 [scripts/generate_script.py](scripts/generate_script.py) 负责 config 拉取→创建任务→轮询→落接口响应 JSON，[scripts/render_report.py](scripts/render_report.py) 直接解析响应里的 `data.result.markdown` 字段原样输出为报告。接口契约见 [references/api.md](references/api.md)，取数路径见 [references/field-mapping.md](references/field-mapping.md)。

## 鉴权

Token 取「技能目录」（SKILL.md 所在目录）下 `config.json` 的 `LY_API_KEY` 字段，回退环境变量 `LY_API_KEY`。请求头 `Authorization: <api_key>`（裸 key，不带 `Bearer`）。`config.json` 形如：

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

运行前先确认 key：

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

## 点数与计费提示

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

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

   > 本次「视频号爆款脚本生成」任务预估扣点约 **98 点**，实际扣点会根据任务复杂程度略有增减。是否继续执行？

   用户确认后再执行 `generate_script.py` 创建任务；用户未确认前**不要**发起创建。续传（`--task-id`，任务已创建过）不重复扣点，无需再确认。

2. **成功后——实际扣点回执 + 报告查看**：任务完成（退出码 0）后，从 stdout 标记块读取实际扣点并向用户回执，例如：

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

   - `{N}` 取自 `===POINTS_USED===` 标记块；若该块为空（后端未返回扣点字段），改说「实际扣点以账户侧扣点记录为准」，不要凭空编数字。
   - 紧接着告知用户如何查看报告：报告已落盘到 `===MD_PATH===` 标记块给出的路径，可直接打开该 Markdown 文件查看；同时在对话里附上报告正文（即 `===OVERVIEW_MD===` 内容）。

3. **失败后——网络原因 + 点数返还**：任务失败/超时（退出码 5/6/11 等，或脚本提示网络错误）时，统一安抚话术：

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

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

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

## 信息收集

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 6 个文件，合计 46.9 KiB