@optima-chat/optima-agent 0.9.3 → 0.9.4

package/.claude/skills/channels/SKILL.md

@@ -31,7 +31,6 @@ description: "社交渠道管理。接入/管理 Telegram、WhatsApp、Discord
 - "关掉 Telegram" → `channels accounts disable telegram store`
 - "重新开启 Telegram" → `channels accounts enable telegram store`
 - "删除 Telegram 渠道" → `channels accounts remove telegram store`
-- "帮我绑定 Telegram" → `channels bind generate`
 - "查看我的绑定" → `channels bind list`
 - "解绑 Telegram" → `channels bind remove --platform telegram --account-id store --platform-uid 123456`
 - "给用户发通知" → `channels send --user-id <id> --text "消息内容"`
@@ -46,7 +45,6 @@ description: "社交渠道管理。接入/管理 Telegram、WhatsApp、Discord
 | 查看渠道列表 | `channels accounts list` | 显示所有账号及状态 |
 | 启用/禁用渠道 | `channels accounts enable/disable` | 不删除配置，只是暂停 |
 | 删除渠道 | `channels accounts remove` | 永久删除，需重新配置 |
-| 绑定社交账号 | `channels bind generate` | 生成绑定码，用户在社交 App 发给 bot |
 | 查看绑定 | `channels bind list` | 显示当前用户绑定的社交账号 |
 | 解绑 | `channels bind remove` | 需要指定 platform、account-id、platform-uid |
 | 发送通知 | `channels send` | 发到用户所有已绑定渠道 |
@@ -130,21 +128,17 @@ channels accounts add line --account-id store \
 channels status
 ```
 
-## 场景6：绑定社交账号
+## 场景6：社交账号自动绑定
 
-**流程**: 生成绑定码 → 用户在社交 App 发给 bot
+**无需 CLI 操作**。商家只需给 bot 发送任意消息，bot 会：
 
-```bash
-# 1. 生成绑定码（默认当前登录用户）
-channels bind generate
-# 输出: { "code": "BIND-A3X7K9", "expiresIn": 300 }
+1. 自动回复一条授权链接（形如 `https://auth.optima.onl/api/v1/oauth/device?user_code=XXX-YYY`）
+2. 商家点开链接在手机浏览器登录并授权
+3. bot 发送 "✅ 授权成功" 消息，之后商家可以直接问任何业务问题
 
-# 2. 告诉用户：
-# "请在 Telegram 给 @YourBot 发送: BIND-A3X7K9（5分钟内有效）"
+链接 10 分钟内有效。超过 14 天未活跃，bot 会要求重新授权。
 
-# 3. 确认绑定
-channels bind list
-```
+**开发者运维**：如需强制解绑某条绑定，用 `channels bind remove`（现有命令不变）。
 
 ## 场景7：发送通知
 
@@ -185,7 +179,6 @@ channels accounts enable <platform> <accountId>
 channels accounts disable <platform> <accountId>
 
 # 绑定管理
-channels bind generate [--user-id <id>]
 channels bind list [--user-id <id>]
 channels bind remove --platform <p> --account-id <a> --platform-uid <uid>
 

package/.claude/skills/video-edit/SKILL.md

@@ -0,0 +1,255 @@
+---
+name: video-edit
+description: "文本驱动的口播视频剪辑（带 AI 二次审片）。用于：剪口播 / 剪 talking head / 删卡顿停顿 / 删 NG 重复 / 给视频加中文字幕 / 视频质量审核。触发：用户上传一段口播视频说'帮我剪一下'/'去掉卡顿'/'剪成短视频'/'加字幕'，或要求'剪辑'/'剪片'/'cut'/'review'/'字幕'/'subtitle'。"
+---
+
+# Video-Edit Skill — 文本驱动的口播视频剪辑
+
+帮商家把原始口播视频（讲产品、讲品牌故事、TikTok / 小红书内容）剪成可发布的短视频。**核心理念：转写只是线索，业务语境决定取舍**。
+
+## Global Rules（违反会出脏片）
+
+1. **业务语境优先于声学检测**
+   开剪前必问 / 必确认：(a) 视频用在哪个平台（TikTok/小红书/IG/详情页），(b) 钩子（hook）是什么，(c) 目标时长。**不知道这三件事就不要开始剪**——`video-edit` 只删卡顿不删废话；废话要靠 AI 在 cut_proposal.md 里自己判断。
+
+2. **Claude 必须自己做语义审片，两关都过才交付**
+   `video-edit cut` 出片只是声学层；交付前 **Claude 自己**还要做一关：
+   - 把成片转写一遍（再调 `video-edit subtitle` 拿 subs.ass 或单独转写）
+   - 抓"预期落空 / 语法断裂 / 重复 NG / 不完整句"等声学检测**永远抓不到的**问题
+   - 抓到 → 改 cut_proposal.md → 重新 cut → 重新审，直到通过
+
+3. **模型名 / 服务名不出现在用户回复里**
+   状态、进度、错误统一用"剪辑中 / 转写中 / 审片中 / 字幕生成中"。`faster-whisper`、`ffmpeg`、`Microsoft YaHei` 这些字眼**不要回显给用户**。
+
+4. **Anti-fabrication**
+   `video-edit` 只有 5 个命令：`analyze` / `cut` / `review` / `subtitle` / `both`。其他 flag 不要凭印象拼。每个命令只接 1 个位置参数：视频文件路径。
+
+## 工作目录约定
+
+不需要全局 git 仓库。每个视频自己带 `<video_stem>.work/` 目录存中间产物：
+
+```
+/home/aiuser/<workspace>/
+├── input.mp4                   # 用户上传的源视频
+├── input.work/                 # video-edit 自动创建
+│   ├── audio.wav
+│   ├── transcript.json         # word-level 转写
+│   ├── silences.json           # 静音检测
+│   ├── cut_proposal.md         # ⭐ Claude 在这里编辑
+│   ├── review_report.md        # review 命令产出
+│   └── subs.ass                # subtitle 命令产出（可手改）
+├── input_edited.mp4            # cut 输出
+└── input_edited_subbed.mp4     # subtitle 输出
+```
+
+## 五命令工作流
+
+```mermaid
+flowchart LR
+    A[1. analyze] --> B[2. 编辑 proposal]
+    B --> C[3. cut]
+    C --> D[4. review]
+    D -->|有 HARD issues| B
+    D -->|通过| E[5. subtitle]
+```
+
+### Step 1：先问业务语境
+
+**Anti-pattern**：用户说"剪一下" → AI 直接跑 `analyze` → 出片不对路。
+
+**正确做法**：先 ask user（用 AskUserQuestion 或自然语言）：
+
+```
+我帮你剪。开始前确认几件事：
+1. 视频投在哪？（TikTok / 小红书 / IG / 商品详情页）
+2. 钩子是什么？（前 3 秒要让用户停下来的那句话）
+3. 目标时长？（15s / 30s / 60s）
+```
+
+如果用户说"你看着办" → 用平台默认（TikTok 30s + 强钩子在前 3s）+ 立刻执行，**不要再回问**。
+
+### Step 2：analyze（声学预处理）
+
+```bash
+video-edit analyze "/home/aiuser/<workspace>/input.mp4"
+```
+
+输出：
+- `<workspace>/input.work/cut_proposal.md` ← Claude 编辑这个
+- `<workspace>/input.work/transcript.json`、`silences.json`、`audio.wav`
+
+⚠️ 如果 `cut_proposal.md` 已存在，命令**不会覆盖**（保留你之前的编辑）。重新生成要先 `rm cut_proposal.md`。
+
+### Step 3：编辑 cut_proposal.md（这步是 Claude 干的活）
+
+读 proposal，每行是一个"短语单元"（300ms 静音分组），格式：
+
+```
+00:01.234 - 00:03.456  (2.22s)  [0.50s!]  这个保留单元的原文
+```
+
+**在要删的行首加 `#`**（保存即可）。判定标准：
+
+| 该删 | 该留 |
+|---|---|
+| NG / 重复 take（"我说一下啊...呃我说一下..."）| 完整业务点 |
+| 跑题闲聊（"对...那个..."）| 钩子句、卖点句 |
+| 嗯啊呃等填充词独占的短语 | 转折句、call-to-action |
+| 与平台/钩子/时长目标冲突的内容 | 与目标对齐的内容 |
+
+**业务原则**：宁可短不可冗。30 秒目标 → 优先压到 25-28 秒留呼吸空间。
+
+### Step 4：cut（出片）
+
+```bash
+video-edit cut "/home/aiuser/<workspace>/input.mp4"
+```
+
+输出 `<workspace>/input_edited.mp4`。
+
+### Step 5：review（声学层质量检查）
+
+```bash
+video-edit review "/home/aiuser/<workspace>/input.mp4"
+```
+
+输出 `<workspace>/input.work/review_report.md`，分两类问题：
+
+| 类别 | 含义 | 处理 |
+|---|---|---|
+| **HARD** | 残留静音 / 切到字中间 / 输出有重复内容 | **必须修**，回到 Step 3 改 proposal 重剪 |
+| **WARN** | 能量突变 / 语速异常 / 语音占比低 | 评估后决定 |
+
+报告底部三种判定：
+- `[OK] ALL CLEAR` → 进入 Step 5（字幕）
+- `[OK] NO HARD ISSUES` → 看 WARN，决定是否要修
+- `[FAIL] HARD ISSUES` → 必须回 Step 3
+
+### Step 5.5：⭐ Claude 自己做语义审片（声学检测抓不到的）
+
+`review` 是声学层。**Claude 在交付前必须自己做语义层**：
+
+1. 让转写跑一遍成片，或用 subtitle 命令产出 `subs.ass` 后读它
+2. 把 `cut_proposal.md` 里**保留的短语序列**和**成片转写**对比
+3. 检查这些**声学检测查不出**的问题：
+   - **预期落空**："我跟你讲三个特点。第一是..." 但成片只剩两个特点
+   - **语法断裂**：句子被砍到主语没了 / 宾语没了
+   - **逻辑跳跃**：Step A 直接跳 Step C，Step B 被剪掉
+   - **指代失效**："这个" / "那种" 的指代物被剪掉
+   - **重复语义**：同一意思用不同词说了两遍都被保留
+
+抓到任何一条 → 回 Step 3 改 proposal → 重剪 → 重审。**两关都过才交付**。
+
+### Step 6：subtitle（烧字幕）
+
+```bash
+video-edit subtitle "/home/aiuser/<workspace>/input.mp4"
+```
+
+行为：
+- 自动转写成片 → 智能分段（标点 / 词间 gap / 14 字 / 3s 多策略）→ 写 `subs.ass`
+- **如果 `subs.ass` 已存在则跳过生成**（保留 Claude 或用户的文字修正），直接重烧
+- 输出 `<workspace>/input_edited_subbed.mp4`（如果传的是 `_edited.mp4` 则去掉 `_edited` 后缀）
+
+修字幕：直接编辑 `subs.ass` 然后重跑 `subtitle` 命令即可。
+
+## 典型场景
+
+### 场景 1：TikTok 30s 短视频（最常见）
+
+```
+用户："帮我剪成 TikTok 30 秒"
+
+Claude 流程：
+1. 上传视频到 /home/aiuser/work/raw.mp4
+2. video-edit analyze → 读 cut_proposal.md
+3. 找钩子（最有冲击力的开场）放最前，删跑题、删 NG，目标 25-28s
+4. video-edit cut → 看产出
+5. video-edit review → 处理 HARD issues
+6. 自己审一遍语义 → 确认逻辑通顺
+7. video-edit subtitle → 烧字幕
+8. 给用户：raw_edited_subbed.mp4
+```
+
+### 场景 2：详情页 PDP 视频（节奏稍慢）
+
+```
+用户："剪个商品详情页用的视频，1 分钟内"
+
+Claude 流程：
+- 钩子可以稍弱（用户已有购买意向才会看 PDP）
+- 重点保留产品参数 / 使用场景 / 信任背书
+- review WARN: pace-slow 可以容忍（PDP 容许喘息）
+- 字幕字体可以大一点（修改 subs.ass 里 Fontsize）
+```
+
+### 场景 3：纯字幕需求（不剪）
+
+```
+用户："这个视频不用剪，帮我加个字幕"
+
+直接 video-edit subtitle "/path/to/video.mp4"
+跳过 analyze / cut / review。
+```
+
+### 场景 4：剪完用户要再调（迭代）
+
+```
+用户："开头那段还是不要了"
+
+不要重跑 analyze（会丢之前的 proposal 编辑）。
+做法：
+1. 直接编辑现有的 cut_proposal.md，把开头几行加上 #
+2. video-edit cut
+3. video-edit review
+4. video-edit subtitle（subs.ass 已存在会复用，可能要 rm 重生成）
+```
+
+## 决策表：什么时候用什么命令
+
+| 用户场景 | 命令序列 |
+|---|---|
+| 完整剪一支带字幕成片 | analyze → 编辑 proposal → cut → review → 自己审 → subtitle |
+| 只剪不要字幕 | analyze → 编辑 proposal → cut → review → 自己审 |
+| 只加字幕 | subtitle |
+| 用户说"你帮我直接剪好" | both（autocut，不编辑 proposal） → review → 自己审 → subtitle |
+| 二次调整（已剪过一次） | 改 cut_proposal.md → cut → review → 自己审 → 重 subtitle（可能要 rm subs.ass） |
+
+`both` 用法是 `analyze + cut` 一把跑（不给 Claude 编辑 proposal 的机会），**不推荐**——业务语境会丢。仅当用户明确说"你直接剪不用问"时用。
+
+## 卓越标准（这是好成片的判定）
+
+- **开场 3 秒内出钩子** —— TikTok / 小红书第一关
+- **节奏密度 ≥ 80%** —— review 的 speech_ratio 不应低于 80%
+- **逻辑闭环** —— 所有"我说三个" / "首先...其次...最后"的承诺都要兑现
+- **句子完整** —— 主谓宾不缺，不出现切到字中间
+- **重复 take 删干净** —— review 的 `repeated-content` 必为 0
+- **字幕断行自然** —— 标点处断，不在词中间断
+
+## 常见错误（不要犯）
+
+### ❌ 错误 1：不问业务语境直接剪
+**症状**：剪完用户说"这不是我要的感觉"
+**正确**：开剪前 3 个问题（平台/钩子/时长）至少要问到，或从用户已有信息推断+告知
+
+### ❌ 错误 2：跳过自己的语义审片
+**症状**：交付的成片有逻辑断裂、指代失效但 review 显示通过
+**正确**：声学 review 通过 ≠ 可以交付。Claude 必须自己再读转写
+
+### ❌ 错误 3：重剪时重跑 analyze
+**症状**：用户的 cut_proposal.md 编辑全丢
+**正确**：迭代时直接改 `cut_proposal.md`，不要碰 analyze
+
+### ❌ 错误 4：subs.ass 修改后没保留
+**症状**：用户说"字幕里那个字打错了我改了"，下次 subtitle 又被覆盖
+**正确**：subs.ass 已存在时命令会跳过生成。如果要全重新生成，先 `rm`
+
+### ❌ 错误 5：把 ffmpeg / faster-whisper 写进给用户的回复
+**症状**：用户："为什么这么慢？" Claude："faster-whisper 转写 small 模型..."
+**正确**："正在分析音频和转写文字，大约需要 X 秒"
+
+## 相关工具
+
+- **ffmpeg skill** — 如果用户要的是非剪辑类音视频处理（合成 BGM、压缩、缩略图、格式转换），转 ffmpeg skill
+- **video-gen skill** — 如果用户要 AI 生成视频（不是已有素材剪辑），转 video-gen skill
+- **markdown-pdf skill** — 如果用户要把 review_report.md 导出 PDF