@optima-chat/optima-agent 0.9.6 → 0.9.7

package/.claude/skills/wechat/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: wechat
-description: "微信视频号视频下载 + metadata。使用场景：下载微信视频号视频(下载视频号/微信视频/weixin.qq.com/sph/...)、查看视频号 metadata(视频号信息/作者/话题/点赞)。使用 scout wechat 命令。当前仅覆盖视频号(Channels)，未来可扩展到公众号/小程序。"
+description: "微信视频号视频下载与 metadata 查询。使用场景：下载视频号/微信视频/weixin.qq.com/sph/ 链接，或查看视频号信息/作者/话题/点赞。使用 scout wechat 命令。"
 ---
 
 # 微信 - 视频号视频下载与 metadata
@@ -26,7 +26,7 @@ description: "微信视频号视频下载 + metadata。使用场景：下载微
 - "下载这个视频号" + 链接 → `scout wechat fetch <url>`
 - "下载微信视频" + 链接 → `scout wechat fetch <url>`
 - "看看这个视频号的信息" / "这个视频号谁发的" → `scout wechat metadata <url>`
-- 用户直接贴 `weixin.qq.com/sph/xxx` 或 `channels.weixin.qq.com/.../sph?id=xxx` → 默认走 `fetch`
+- 用户直接贴 `weixin.qq.com/sph/xxx` 或 `channels.weixin.qq.com/.../sph?id=xxx`，无其他说明 → 默认走 `metadata`（避免误烧 TikHub 额度；用户明确说"下载"/"保存"才走 `fetch`）
 
 ---
 
@@ -41,7 +41,7 @@ description: "微信视频号视频下载 + metadata。使用场景：下载微
 | 裸 exportId(10 位短码) | `Azn5HYOeb0` |
 
 ```bash
-# 三种都行
+# 三种都行（以下示例用 fetch 演示 URL 形态；实际用哪个命令看场景，默认 metadata）
 scout wechat fetch https://weixin.qq.com/sph/Azn5HYOeb0
 scout wechat fetch "https://channels.weixin.qq.com/finder-preview/pages/sph?id=Azn5HYOeb0"
 scout wechat fetch Azn5HYOeb0
@@ -95,6 +95,7 @@ scout wechat metadata https://weixin.qq.com/sph/Azn5HYOeb0
 **何时用 metadata 而不是 fetch**:
 - 用户问"这视频谁发的""讲什么的""多少赞" → 用 metadata
 - 用户要"下载""视频文件""保存下来" → 用 fetch
+- 用户只贴链接、没说要做什么 → 默认 metadata（见典型场景第 4 条）
 
 ---
 
@@ -108,7 +109,7 @@ scout wechat metadata https://weixin.qq.com/sph/Azn5HYOeb0
    - `502` — TikHub / CDN / decrypt server 上游失败(短期重试可能恢复)
    - `503` — backend 没配解密服务(SRE 还没部署)
    - `500` — 其它内部异常
-5. **视频是一次性签名链接**:`fetch` 内部 pipeline 必须一气呵成,不要尝试缓存中间结果
+5. **videoUrl 是一次性签名链接**:`fetch` pipeline 必须一气呵成拿到后立刻返回,不要中间缓存;只直接返回给当前用户,不要存储或转发给第三方系统(链接很快失效)
 6. **scope 限定**:这个 skill 只管视频号(Channels),不要用它处理公众号文章 / 小程序 / 朋友圈
 
 ---
@@ -122,10 +123,10 @@ scout wechat metadata https://weixin.qq.com/sph/Azn5HYOeb0
 ```
 
 ```bash
-scout wechat fetch https://weixin.qq.com/sph/Azn5HYOeb0 --format json
+scout wechat fetch https://weixin.qq.com/sph/Azn5HYOeb0
 ```
 
-返回 JSON 后,把 `videoUrl` 给用户(可点开播放/右键下载),并用 metadata 简述视频内容(标题/作者/时长)。
+返回 JSON 后,以 Markdown 链接格式展示 `videoUrl`（如 `[点击播放/下载](<实际 videoUrl>)`），并列出标题、作者昵称、时长。
 
 ### 用户问"这视频啥情况"
 
@@ -137,9 +138,9 @@ scout wechat fetch https://weixin.qq.com/sph/Azn5HYOeb0 --format json
 scout wechat metadata https://weixin.qq.com/sph/Azn5HYOeb0
 ```
 
-只取 metadata 简介给用户,不消耗 S3 / 解密资源。
+列出标题、作者昵称、时长、话题、点赞数给用户，不消耗 S3 / 解密资源。
 
-### 用户给的是 exportId(纯字符串)
+### 用户给的是 exportId 且只想看信息
 
 ```
 用户:看下 Azn5HYOeb0 这个视频号
@@ -149,7 +150,19 @@ scout wechat metadata https://weixin.qq.com/sph/Azn5HYOeb0
 scout wechat metadata Azn5HYOeb0
 ```
 
-直接传短码,命令内部识别。
+直接传短码，命令内部识别。
+
+### 用户给的是 exportId 且要下载
+
+```
+用户:下载 Azn5HYOeb0
+```
+
+```bash
+scout wechat fetch Azn5HYOeb0
+```
+
+直接传短码，命令内部识别。
 
 ### 出错怎么办
 

package/dist/src/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,IAAI,MAAM,CA0KxC"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,IAAI,MAAM,CA2KxC"}

package/dist/src/system-prompt.js

@@ -34,7 +34,8 @@ export function getSystemPrompt() {
 - **product-page** - 商品详情页配置
 - **gen** - 图像/视频/语音生成
 - **markdown-pdf** - Markdown 转 PDF（文档导出、报告生成）
-- **ffmpeg** - 音视频处理（格式转换、压缩、提取音频）
+- **ffmpeg** - 音视频**精确操作**（截取指定时间段、压缩、格式转换、提取音频、生成缩略图、拼接）—— 仅当用户明确说具体操作时用
+- **video-edit** - 🎬 **口播/talking-head 视频智能剪辑**（自动转写 → 删卡顿停顿/NG/废话 → 烧字幕）。**用户给已有视频说"剪一下/帮我剪辑/去卡顿/变流畅/剪短点/加字幕"等模糊指令时首选**，优先级高于 ffmpeg
 - **ads** - Google Ads 广告投放
 - **scout** - Amazon 选品调研
 - **reddit** - Reddit 趋势发现与商机预判

package/dist/src/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;IACzD,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,MAAM;CAChB,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;aASI,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+JvB,CAAC;AACF,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/system-prompt.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qEAAqE;AACrE,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;IACzD,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,MAAM;CAChB,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;aASI,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKvB,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",