@optima-chat/optima-agent 0.5.11 → 0.6.0

package/.claude/settings.local.json

@@ -77,7 +77,15 @@
       "Bash(chmod:*)",
       "Bash(npm whoami:*)",
       "Bash(tsx test-scripts/test-headless-progress.ts:*)",
-      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)"
+      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)",
+      "Bash(git describe:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(./scripts/test-headless.sh:*)",
+      "Bash(./scripts/test-headless-simple.sh:*)",
+      "Bash(env)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/instagram/SKILL.md

@@ -0,0 +1,295 @@
+---
+name: instagram
+description: Instagram influencer marketing and content research. Use when user needs to find Instagram creators (Instagram网红/博主/KOL), analyze Instagram Reels (短视频/Reels/热门视频), research influencer profiles (主页分析/账号数据), or competitive analysis (竞品分析/对手研究).
+---
+
+# Instagram - Influencer Marketing & Content Research
+
+## 典型场景
+
+当用户说：
+- "帮我找Instagram博主" / "找美妆网红" → `scout instagram reels "美妆"` 通过内容找创作者
+- "分析XX的Instagram账号" / "@username数据怎么样" → `scout instagram profile @username`
+- "搜索瑜伽相关的Reels" → `scout instagram reels "yoga" --limit 30`
+- "这个Reel为什么火" + URL → `scout instagram reel-insights <url>`
+- "看看XX发了什么内容" → `scout instagram creator-reels @username`
+
+### 场景决策表
+
+| 用户需求 | 推荐命令 | 关键参数 |
+|---------|---------|---------|
+| 找网红合作 | `instagram reels "关键词"` 再 `profile` 分析候选人 | `--min-plays` 筛选高播放 |
+| 账号质量评估 | `instagram profile @username` | 看 followers/following 比例、验证状态 |
+| 内容策略研究 | `instagram reels "话题"` + `reel-insights` | 分析高播放 Reels 的共同点 |
+| 竞品分析 | `instagram profile @competitor` + `creator-reels` | 看他们的内容策略和表现 |
+| 网红内容审查 | `instagram creator-reels @username --limit 30` | 评估内容质量和一致性 |
+
+## 核心命令
+
+### 1. 分析账号 - `scout instagram profile`
+
+**用途**：评估网红账号质量和可信度
+
+```bash
+scout instagram profile @username
+scout instagram profile beautyguru  # 可以不加 @
+```
+
+**返回数据**：
+- `username`, `fullName` - 账号信息
+- `followers`, `following`, `totalPosts` - **关键**，判断账号规模和活跃度
+- `verified` - **重要**，平台认证
+- `isPrivate` - 是否私密（私密账号无法合作）
+- `category` - 账号分类（Beauty, Fashion, Fitness 等）
+- `biography`, `externalUrl` - 个人简介和联系方式
+
+**质量判断**：
+- **followers/following 比例**：
+  - >10:1 = 优质账号（1M粉丝，10K关注）
+  - 2-10:1 = 正常账号
+  - <2:1 = 可能互粉或买粉
+- **verified = true** = 平台认证，可信度高
+- **totalPosts**：
+  - >500 = 老账号，内容稳定
+  - 100-500 = 正常
+  - <100 = 新账号或不活跃
+- **category 匹配** = 品类契合度
+
+### 2. 搜索 Reels - `scout instagram reels`
+
+**用途**：找话题相关的内容和创作者
+
+```bash
+# 找瑜伽相关的 Reels
+scout instagram reels "yoga" --limit 30
+
+# 找高播放的咖啡 Reels
+scout instagram reels "coffee" --min-plays 100000 --limit 20
+```
+
+**返回数据**：
+- `creator` - 创作者信息（username, fullName）
+- `plays`, `likes`, `comments` - 互动数据
+- `caption` - 标题文案
+- `url` - Reel 链接
+
+**分析逻辑**：
+- **plays 数据** - 有时为 null（Instagram 不总是显示播放数）
+- **likes/plays >3%** = 高互动（如果有 plays 数据）
+- **caption 长度** - 长文案（>100 字）通常是教程型，短文案是快消费
+- **从搜索结果中找到多个创作者** → 用 `profile` 分析他们
+
+### 3. 获取创作者 Reels - `scout instagram creator-reels`
+
+**用途**：看某个网红发了什么内容，评估内容质量
+
+```bash
+scout instagram creator-reels @username --limit 30
+```
+
+**返回数据**：
+- `reels` - Reel 列表
+  - `shortcode` - Reel ID
+  - `plays`, `likes`, `comments` - 互动数据
+  - `caption` - 文案
+  - `url` - 链接
+
+**分析用途**：
+1. **评估内容一致性** - 看最近 20-30 个 Reels 的主题是否聚焦
+2. **计算平均互动** - 避免只看单个爆款，要看整体表现
+3. **找爆款内容** - 找 likes 最高的几个，用 `reel-insights` 深入分析
+4. **发布频率** - 最近 30 个 Reels 的时间跨度，判断更新频率
+
+**质量判断**：
+- **一致性高**（同一品类）= 垂直网红，受众精准
+- **一致性低**（各种话题都发）= 泛娱乐，转化率低
+- **平均 likes 稳定** = 粉丝忠诚度高
+- **平均 likes 波动大** = 依赖算法推荐，不稳定
+
+### 4. Reel 深度分析 - `scout instagram reel-insights`
+
+**用途**：分析爆款 Reel 的成功要素
+
+```bash
+scout instagram reel-insights "https://instagram.com/reel/ABC123/"
+```
+
+**返回数据**：
+- `reel` - 完整数据（plays, likes, comments, shares）
+- `transcript` - **关键**，视频字幕/语音识别
+- `comments` - Top 评论，提取用户反馈
+
+**分析重点**：
+1. **Transcript 分析**：
+   - 前 3-5 秒说了什么（Hook）
+   - 有无明确的 CTA（call to action）
+   - 教程型 vs 娱乐型
+2. **Comments 分析**：
+   - 正面/负面情感比例
+   - 是否有"Where to buy"等购买意向
+   - 用户标记朋友 = 传播潜力
+3. **互动率**：
+   - likes/plays >5% = 优秀
+   - comments/plays >0.5% = 高互动
+
+## 工作流程
+
+### 流程1：找网红合作
+
+```bash
+# 1. 搜索相关内容，找到活跃创作者
+scout instagram reels "fitness workout" --min-plays 50000 --limit 30
+# 记录高表现创作者的 username
+
+# 2. 分析候选网红的账号
+scout instagram profile @candidate1
+scout instagram profile @candidate2
+# 看 followers, verified, category
+
+# 3. 审查他们的内容质量
+scout instagram creator-reels @candidate1 --limit 30
+# 看内容一致性、平均互动
+
+# 4. 分析他们的爆款内容
+scout instagram reel-insights "https://instagram.com/reel/xxx"
+# 学习他们的内容风格
+
+# 5. 建立合作候选名单
+```
+
+### 流程2：内容策略研究
+
+```bash
+# 1. 找话题下的高表现 Reels
+scout instagram reels "coffee making" --min-plays 100000 --limit 20
+
+# 2. 深入分析前 5 个爆款
+scout instagram reel-insights "reel_url_1"
+scout instagram reel-insights "reel_url_2"
+# ...
+
+# 3. 提取共同模式：
+# - Hook 怎么做的
+# - 视觉风格
+# - 文案长度
+# - 音乐选择（从 URL 访问）
+
+# 4. 应用到自己的内容策略
+```
+
+### 流程3：竞品分析
+
+```bash
+# 1. 分析竞品账号整体情况
+scout instagram profile @competitor
+
+# 2. 获取他们的所有 Reels
+scout instagram creator-reels @competitor --limit 50
+
+# 3. 分析他们的爆款（找 likes 最高的）
+scout instagram reel-insights "竞品爆款 URL"
+
+# 4. 总结他们的策略：
+# - 发布频率（从 reels 时间判断）
+# - 内容类型占比（教程/产品展示/生活方式）
+# - 互动率水平
+
+# 5. 找差异化机会
+```
+
+### 流程4：跨平台对比（Instagram vs TikTok）
+
+```bash
+# 1. Instagram 数据
+scout instagram reels "portable blender" --limit 20
+
+# 2. TikTok 数据（切换到 tiktok skill）
+scout tiktok search-videos "portable blender" --has-product --limit 20
+
+# 3. 对比：
+# - 内容数量（哪个平台更活跃）
+# - 平均互动（哪个平台效果好）
+# - 商业化程度（TikTok 通常更高）
+# - 受众差异（Instagram 更高端/年长）
+
+# 4. 决策内容策略
+```
+
+## 数据解读关键
+
+### 账号质量评分
+
+| 指标 | 优秀 | 良好 | 一般 | 差 |
+|------|------|------|------|-----|
+| followers/following | >10:1 | 5-10:1 | 2-5:1 | <2:1 |
+| verified | ✓ | - | - | - |
+| totalPosts | >500 | 200-500 | 100-200 | <100 |
+| isPrivate | false | - | - | true |
+
+**决策**：
+- verified = true 优先考虑（可信度高）
+- followers/following <2:1 谨慎（可能买粉）
+- totalPosts <100 且 followers >10K = 红旗（可能刷数据）
+- isPrivate = true 无法合作（内容不可见）
+
+### Reel 表现评估
+
+**互动率基准**（如果有 plays 数据）：
+- likes/plays >5% = 优秀
+- likes/plays 3-5% = 良好
+- likes/plays 1-3% = 一般
+- likes/plays <1% = 差
+
+**评论率**：
+- comments/plays >0.5% = 高互动
+- comments/plays 0.2-0.5% = 正常
+- comments/plays <0.2% = 低互动
+
+**没有 plays 数据时**：
+- 看 likes 绝对值，与创作者 followers 对比
+- likes/followers >5% = 优秀
+- likes/followers 2-5% = 良好
+- likes/followers <2% = 一般
+
+### 内容策略判断
+
+**从 creator-reels 结果判断**：
+
+1. **内容类型分布**：
+   - 教程类（caption 长，有步骤）
+   - 产品展示（caption 短，突出视觉）
+   - 生活方式（个人化，情感向）
+
+2. **发布频率**：
+   - 每天 1+ 条 = 高频（需要团队支持）
+   - 每周 3-5 条 = 正常
+   - 每周 <3 条 = 低频（可能兼职）
+
+3. **互动稳定性**：
+   - 标准差小 = 粉丝忠诚，算法稳定
+   - 标准差大 = 依赖单个爆款，不稳定
+
+## Instagram vs TikTok 差异
+
+| 维度 | Instagram | TikTok |
+|------|-----------|--------|
+| 内容风格 | 更精致、高端 | 更真实、接地气 |
+| 受众年龄 | 25-40 岁为主 | 18-30 岁为主 |
+| 商业化 | 品牌合作为主 | 带货链接更直接 |
+| 内容生命周期 | 更长（会被重新推荐） | 更短（趋势性强） |
+| 算法特点 | 看重粉丝关系 | 看重新鲜感 |
+
+**策略建议**：
+- **品牌建设** → Instagram（高端受众，长期价值）
+- **快速带货** → TikTok（年轻受众，冲动消费）
+- **跨平台** → 内容需要调整风格，不能直接搬运
+
+## 重要提醒
+
+1. **plays 数据不总是有**：Instagram 不是所有 Reels 都显示播放数，这很正常
+2. **没有 plays 时用 likes**：用 likes/followers 比例评估表现
+3. **limit 最大 60**：reels 搜索最多返回 60 个结果
+4. **Private 账号**：无法获取内容，合作前确认账号是 public
+5. **跨 Skill 联动**：
+   - Instagram 找网红 → profile 评估 → TikTok 对比
+   - Instagram 发现内容 → scout 验证产品市场 → scout supplier-search 找供应商