@optima-chat/optima-agent 0.9.11 → 0.9.13

package/.claude/skills/reddit/SKILL.md

@@ -1,277 +1,277 @@
----
-name: reddit
-description: "Reddit 趋势发现和商机预判。当用户需要从 Reddit 发现趋势（Reddit趋势/Reddit热门/Reddit话题）、搜索 Reddit 帖子（Reddit搜索/搜Reddit）、查看 subreddit 版块（版块/社区/subreddit）、分析 Reddit 评论（Reddit评论/帖子评论）、查看 Reddit 广告（Reddit广告/竞品广告）、或预判商机（趋势预判/商机发现/市场信号）时使用此技能。"
----
-
-# Reddit - 趋势发现与商机预判
-
-所有命令使用 `scout reddit` 前缀。
-
----
-
-## 快速选择：我该用哪个命令？
-
-| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
-|---------|---------|---------|---------|
-| **发现商机趋势** | `trends "关键词"` | — | 一键聚合全站热帖+多版块分析 |
-| **搜索 Reddit 话题** | `search "关键词"` | `comments` | 全站搜索→深入看评论 |
-| **监控特定版块** | `subreddit <名称>` | `subreddit-info` | 看热帖+版块数据 |
-| **版块内精准搜索** | 通过 API: `/subreddit/:name/search` | — | 在特定版块搜关键词 |
-| **分析帖子讨论** | `comments <url>` | — | 看用户真实反馈和痛点 |
-| **竞品广告情报** | `ads "关键词"` | — | 看竞品在 Reddit 投了什么广告 |
-
----
-
-## 典型场景
-
-当用户说：
-- "Reddit 上什么火" / "Reddit 趋势" → `scout reddit trends "关键词"`
-- "搜一下 Reddit 上关于XX的讨论" → `scout reddit search "XX"`
-- "看看 r/BuyItForLife" → `scout reddit subreddit BuyItForLife`
-- "这个版块有多少人" → `scout reddit subreddit-info BuyItForLife`
-- "看看这个帖子的评论" + Reddit URL → `scout reddit comments "<url>"`
-- "竞品在 Reddit 打了什么广告" → `scout reddit ads "产品关键词" -i RETAIL_AND_ECOMMERCE`
-- "这个品类有没有商机" / "市场趋势" → `scout reddit trends "品类关键词"`
-
----
-
-## URL 解析 - Reddit 链接处理
-
-用户可能直接贴 Reddit 链接，按以下规则处理：
-
-| URL 特征 | 提取内容 | 调用命令 |
-|----------|---------|---------|
-| `reddit.com/r/名称/comments/...` | 完整帖子 URL | `scout reddit comments "<url>"` |
-| `reddit.com/r/名称` | subreddit 名称 | `scout reddit subreddit <名称>` |
-| `redd.it/短链接` | 完整 URL | `scout reddit comments "https://redd.it/..."` |
-
-**示例**：
-```bash
-# 帖子链接 → 获取评论
-scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/best_backpack/"
-
-# 版块链接 → 获取热帖
-# https://www.reddit.com/r/Entrepreneur
-scout reddit subreddit Entrepreneur
-```
-
----
-
-## 核心命令
-
-### 🔥 第一层：趋势发现
-
-#### 1. 趋势发现（旗舰命令） - `scout reddit trends`
-
-一键聚合全站搜索 + 多版块热帖分析，用于预判商机。
-
-```bash
-scout reddit trends "wireless earbuds"
-scout reddit trends "portable blender"scout reddit trends "home office" --subreddits "BuyItForLife,Entrepreneur,smallbusiness" -t month
-```
-
-**参数**：
-- `<query>`：搜索关键词（必填）
-- `--subreddits`：逗号分隔的版块名（默认: BuyItForLife,shutupandtakemymoney,Entrepreneur,smallbusiness）
-- `-t, --timeframe`：时间范围 `all|day|week|month|year`（默认: week）
-- `-f, --format`：输出格式 `json|text`（默认: json）
-
-**返回数据**：
-- `globalResults`：全站 Top 帖子（sort=top，找历史表现最好的讨论）
-- `subredditResults`：每个版块的热帖（sort=hot，找当前势头）+ 版块信息（订阅者数、分类）
-
-**分析重点**：
-1. 全站 Top 帖 = 已验证的用户兴趣（高 score = 广泛共鸣）
-2. 版块热帖 = 正在发酵的需求（hot = 当前势头）
-3. 评论数高 = 话题争议性/参与度强
-4. 跨版块重复出现的话题 = 强趋势信号
-
-#### 2. 全站搜索 - `scout reddit search`
-
-按关键词搜索全 Reddit。
-
-```bash
-scout reddit search "coffee maker"scout reddit search "standing desk" -s top -t month
-scout reddit search "protein powder" -s comment_count -t week
-```
-
-**参数**：
-- `-s, --sort`：排序 `relevance|new|top|comment_count`（默认: top）
-- `-t, --timeframe`：时间范围 `all|day|week|month|year`（默认: week）
-- `-f, --format`：输出格式 `json|text`
-
-**返回数据**：帖子列表，含 `title`、`subreddit`、`author`、`score`、`numComments`、`permalink`
-
----
-
-### 📊 第二层：版块分析
-
-#### 3. 版块热帖 - `scout reddit subreddit`
-
-获取特定版块的帖子列表。
-
-```bash
-scout reddit subreddit BuyItForLifescout reddit subreddit Entrepreneur --sort top --timeframe week
-scout reddit subreddit smallbusiness --sort rising
-```
-
-**参数**：
-- `<name>`：版块名（不加 r/）
-- `-s, --sort`：排序 `best|hot|new|top|rising`（默认: hot）
-- `-t, --timeframe`：时间范围（**仅 sort=top 时有效**，其他 sort 值会被忽略）
-- `-f, --format`：输出格式
-
-**推荐版块**（商机发现）：
-
-| 版块 | 订阅者 | 方向 |
-|------|--------|------|
-| r/BuyItForLife | 3.6M | 耐用消费品需求 |
-| r/shutupandtakemymoney | 496K | 冲动消费/新奇产品 |
-| r/Entrepreneur | 5.1M | 创业趋势/商业模式 |
-| r/smallbusiness | 2.4M | 中小企业需求/痛点 |
-| r/ProductHunting | — | 产品发现 |
-| r/Gadgets | — | 科技产品趋势 |
-| r/cooltools | — | 工具和装备 |
-
-#### 4. 版块信息 - `scout reddit subreddit-info`
-
-查看版块的订阅者数、分类、描述等。
-
-```bash
-scout reddit subreddit-info BuyItForLifescout reddit subreddit-info Entrepreneur
-```
-
-**返回数据**：`name`、`subscribers`、`advertiserCategory`、`description`、`createdAt`
-
-**注意**：`weeklyActiveUsers` 和 `weeklyContributions` 可能为 null（API 限制）。
-
----
-
-### 💬 第三层：深度分析
-
-#### 5. 帖子评论 - `scout reddit comments`
-
-获取帖子的评论列表，用于分析用户真实反馈。
-
-```bash
-scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/..."```
-
-**返回数据**：`post`（帖子详情）+ `comments`（评论列表，含 author、body、score）+ `hasMore`
-
-**分析重点**：
-1. 高 score 评论 = 社区共识
-2. 产品推荐评论 = 真实用户口碑
-3. 抱怨/吐槽评论 = 未满足的需求（商机）
-4. "I wish..." / "Why doesn't..." = 产品创意来源
-
----
-
-### 📢 第四层：竞品广告情报
-
-#### 6. 广告搜索 - `scout reddit ads`
-
-搜索 Reddit 上的广告投放，了解竞品营销策略。
-
-```bash
-scout reddit ads "earbuds"scout reddit ads "coffee" -i RETAIL_AND_ECOMMERCE
-```
-
-**参数**：
-- `<query>`：搜索关键词
-- `-i, --industries`：行业筛选（可选）
-- `-f, --format`：输出格式
-
-**行业选项**：`RETAIL_AND_ECOMMERCE`, `TECH_B2B`, `TECH_B2C`, `GAMING`, `HEALTH_AND_BEAUTY`, `CONSUMER_PACKAGED_GOODS`, `FINANCIAL_SERVICES`, `EDUCATION`, `ENTERTAINMENT`, `EMPLOYMENT`, `AUTO`, `TRAVEL`, `REAL_ESTATE`
-
-**返回数据**：广告列表（最多 30 条），含 `headline`、`body`、`industry`、`budgetCategory`（LOW/MEDIUM/HIGH）、`objective`、`profileName`
-
-**分析重点**：
-1. HIGH 预算广告 = 该品类有大玩家在投入
-2. 多个广告主同一品类 = 市场竞争激烈
-3. 广告文案中的卖点 = 市场验证过的 USP
-4. CONVERSIONS 目标 = 直接带货型广告
-
----
-
-## 典型工作流
-
-### 趋势预判：从 Reddit 话题到商机
-
-```bash
-# 1. 一键发现趋势（全站 + 多版块聚合）
-scout reddit trends "portable blender"
-# 2. 看到感兴趣的帖子，深入分析评论
-scout reddit comments "https://www.reddit.com/r/..."
-
-# 3. 看竞品在 Reddit 的广告投放
-scout reddit ads "portable blender" -i RETAIL_AND_ECOMMERCE
-
-# 4. 跨平台验证
-scout search "portable blender" --limit 10          # Amazon 市场验证
-scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
-```
-
-### 版块深耕：监控特定社区
-
-```bash
-# 1. 了解版块基本情况
-scout reddit subreddit-info BuyItForLife
-# 2. 看当前热帖
-scout reddit subreddit BuyItForLife --sort hot
-# 3. 搜索特定品类讨论
-scout reddit search "backpack" -s top -t month
-# 4. 分析高互动帖子评论
-scout reddit comments "<帖子URL>"
-```
-
-### 竞品广告分析
-
-```bash
-# 1. 搜索品类广告
-scout reddit ads "wireless earbuds" -i RETAIL_AND_ECOMMERCE
-# 2. 分析广告文案卖点 → 提炼差异化方向
-# 3. 结合 Reddit 用户讨论发现未满足需求
-scout reddit search "wireless earbuds problem" -s top -t month
-```
-
----
-
-## 数据解读参考
-
-### 帖子热度判断
-
-| 指标 | 高关注 | 中等 | 低关注 |
-|------|--------|------|--------|
-| Score | >500 | 50-500 | <50 |
-| 评论数 | >100 | 20-100 | <20 |
-| Upvote Ratio | >0.90 | 0.70-0.90 | <0.70 |
-
-### 版块活跃度判断
-
-| 订阅者数 | 规模 |
-|----------|------|
-| >1M | 超大社区，趋势信号强 |
-| 100K-1M | 活跃社区，垂直价值高 |
-| 10K-100K | 小众社区，精准需求 |
-| <10K | 新兴/冷门社区 |
-
-### 商机信号识别
-
-| Reddit 信号 | 含义 | 下一步 |
-|------------|------|--------|
-| 多帖问 "best X for Y" | 品类有需求但用户迷茫 | Amazon 选品验证 |
-| 高 score 吐槽帖 | 现有产品痛点明确 | 差异化产品机会 |
-| "I wish..." 高频出现 | 未被满足的需求 | 产品创新方向 |
-| 版块 rising 帖子暴涨 | 新兴趋势正在形成 | 快速入场窗口 |
-| 竞品广告 HIGH 预算 | 品类利润空间大 | 成本分析 + 供应商 |
-
----
-
-## 重要提醒
-
-1. **timeframe 限制**：`subreddit` 命令的 `--timeframe` 只在 `--sort top` 时有效，其他排序方式传 timeframe 会被自动忽略
-2. **广告数量上限**：`ads` 命令最多返回 30 条广告，无分页
-3. **评论分页**：单次最多返回 ~95 条评论，`hasMore=true` 表示还有更多
-4. **trends 命令成本**：每次调用消耗多个 API credit（1 + 2×版块数），默认 4 个版块 = 9 credits
-5. **版块名大小写敏感**：使用正确的大小写（如 `BuyItForLife` 而非 `buyitforlife`）
-6. **跨 Skill 联动**：Reddit 发现趋势 → scout search Amazon 验证 → scout supplier-search 找供应商 → TikTok/抖音验证社媒热度
+---
+name: reddit
+description: "Reddit 趋势发现和商机预判。当用户需要从 Reddit 发现趋势（Reddit趋势/Reddit热门/Reddit话题）、搜索 Reddit 帖子（Reddit搜索/搜Reddit）、查看 subreddit 版块（版块/社区/subreddit）、分析 Reddit 评论（Reddit评论/帖子评论）、查看 Reddit 广告（Reddit广告/竞品广告）、或预判商机（趋势预判/商机发现/市场信号）时使用此技能。"
+---
+
+# Reddit - 趋势发现与商机预判
+
+所有命令使用 `scout reddit` 前缀。
+
+---
+
+## 快速选择：我该用哪个命令？
+
+| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
+|---------|---------|---------|---------|
+| **发现商机趋势** | `trends "关键词"` | — | 一键聚合全站热帖+多版块分析 |
+| **搜索 Reddit 话题** | `search "关键词"` | `comments` | 全站搜索→深入看评论 |
+| **监控特定版块** | `subreddit <名称>` | `subreddit-info` | 看热帖+版块数据 |
+| **版块内精准搜索** | 通过 API: `/subreddit/:name/search` | — | 在特定版块搜关键词 |
+| **分析帖子讨论** | `comments <url>` | — | 看用户真实反馈和痛点 |
+| **竞品广告情报** | `ads "关键词"` | — | 看竞品在 Reddit 投了什么广告 |
+
+---
+
+## 典型场景
+
+当用户说：
+- "Reddit 上什么火" / "Reddit 趋势" → `scout reddit trends "关键词"`
+- "搜一下 Reddit 上关于XX的讨论" → `scout reddit search "XX"`
+- "看看 r/BuyItForLife" → `scout reddit subreddit BuyItForLife`
+- "这个版块有多少人" → `scout reddit subreddit-info BuyItForLife`
+- "看看这个帖子的评论" + Reddit URL → `scout reddit comments "<url>"`
+- "竞品在 Reddit 打了什么广告" → `scout reddit ads "产品关键词" -i RETAIL_AND_ECOMMERCE`
+- "这个品类有没有商机" / "市场趋势" → `scout reddit trends "品类关键词"`
+
+---
+
+## URL 解析 - Reddit 链接处理
+
+用户可能直接贴 Reddit 链接，按以下规则处理：
+
+| URL 特征 | 提取内容 | 调用命令 |
+|----------|---------|---------|
+| `reddit.com/r/名称/comments/...` | 完整帖子 URL | `scout reddit comments "<url>"` |
+| `reddit.com/r/名称` | subreddit 名称 | `scout reddit subreddit <名称>` |
+| `redd.it/短链接` | 完整 URL | `scout reddit comments "https://redd.it/..."` |
+
+**示例**：
+```bash
+# 帖子链接 → 获取评论
+scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/best_backpack/"
+
+# 版块链接 → 获取热帖
+# https://www.reddit.com/r/Entrepreneur
+scout reddit subreddit Entrepreneur
+```
+
+---
+
+## 核心命令
+
+### 🔥 第一层：趋势发现
+
+#### 1. 趋势发现（旗舰命令） - `scout reddit trends`
+
+一键聚合全站搜索 + 多版块热帖分析，用于预判商机。
+
+```bash
+scout reddit trends "wireless earbuds"
+scout reddit trends "portable blender"scout reddit trends "home office" --subreddits "BuyItForLife,Entrepreneur,smallbusiness" -t month
+```
+
+**参数**：
+- `<query>`：搜索关键词（必填）
+- `--subreddits`：逗号分隔的版块名（默认: BuyItForLife,shutupandtakemymoney,Entrepreneur,smallbusiness）
+- `-t, --timeframe`：时间范围 `all|day|week|month|year`（默认: week）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：
+- `globalResults`：全站 Top 帖子（sort=top，找历史表现最好的讨论）
+- `subredditResults`：每个版块的热帖（sort=hot，找当前势头）+ 版块信息（订阅者数、分类）
+
+**分析重点**：
+1. 全站 Top 帖 = 已验证的用户兴趣（高 score = 广泛共鸣）
+2. 版块热帖 = 正在发酵的需求（hot = 当前势头）
+3. 评论数高 = 话题争议性/参与度强
+4. 跨版块重复出现的话题 = 强趋势信号
+
+#### 2. 全站搜索 - `scout reddit search`
+
+按关键词搜索全 Reddit。
+
+```bash
+scout reddit search "coffee maker"scout reddit search "standing desk" -s top -t month
+scout reddit search "protein powder" -s comment_count -t week
+```
+
+**参数**：
+- `-s, --sort`：排序 `relevance|new|top|comment_count`（默认: top）
+- `-t, --timeframe`：时间范围 `all|day|week|month|year`（默认: week）
+- `-f, --format`：输出格式 `json|text`
+
+**返回数据**：帖子列表，含 `title`、`subreddit`、`author`、`score`、`numComments`、`permalink`
+
+---
+
+### 📊 第二层：版块分析
+
+#### 3. 版块热帖 - `scout reddit subreddit`
+
+获取特定版块的帖子列表。
+
+```bash
+scout reddit subreddit BuyItForLifescout reddit subreddit Entrepreneur --sort top --timeframe week
+scout reddit subreddit smallbusiness --sort rising
+```
+
+**参数**：
+- `<name>`：版块名（不加 r/）
+- `-s, --sort`：排序 `best|hot|new|top|rising`（默认: hot）
+- `-t, --timeframe`：时间范围（**仅 sort=top 时有效**，其他 sort 值会被忽略）
+- `-f, --format`：输出格式
+
+**推荐版块**（商机发现）：
+
+| 版块 | 订阅者 | 方向 |
+|------|--------|------|
+| r/BuyItForLife | 3.6M | 耐用消费品需求 |
+| r/shutupandtakemymoney | 496K | 冲动消费/新奇产品 |
+| r/Entrepreneur | 5.1M | 创业趋势/商业模式 |
+| r/smallbusiness | 2.4M | 中小企业需求/痛点 |
+| r/ProductHunting | — | 产品发现 |
+| r/Gadgets | — | 科技产品趋势 |
+| r/cooltools | — | 工具和装备 |
+
+#### 4. 版块信息 - `scout reddit subreddit-info`
+
+查看版块的订阅者数、分类、描述等。
+
+```bash
+scout reddit subreddit-info BuyItForLifescout reddit subreddit-info Entrepreneur
+```
+
+**返回数据**：`name`、`subscribers`、`advertiserCategory`、`description`、`createdAt`
+
+**注意**：`weeklyActiveUsers` 和 `weeklyContributions` 可能为 null（API 限制）。
+
+---
+
+### 💬 第三层：深度分析
+
+#### 5. 帖子评论 - `scout reddit comments`
+
+获取帖子的评论列表，用于分析用户真实反馈。
+
+```bash
+scout reddit comments "https://www.reddit.com/r/BuyItForLife/comments/1s6eg5r/..."```
+
+**返回数据**：`post`（帖子详情）+ `comments`（评论列表，含 author、body、score）+ `hasMore`
+
+**分析重点**：
+1. 高 score 评论 = 社区共识
+2. 产品推荐评论 = 真实用户口碑
+3. 抱怨/吐槽评论 = 未满足的需求（商机）
+4. "I wish..." / "Why doesn't..." = 产品创意来源
+
+---
+
+### 📢 第四层：竞品广告情报
+
+#### 6. 广告搜索 - `scout reddit ads`
+
+搜索 Reddit 上的广告投放，了解竞品营销策略。
+
+```bash
+scout reddit ads "earbuds"scout reddit ads "coffee" -i RETAIL_AND_ECOMMERCE
+```
+
+**参数**：
+- `<query>`：搜索关键词
+- `-i, --industries`：行业筛选（可选）
+- `-f, --format`：输出格式
+
+**行业选项**：`RETAIL_AND_ECOMMERCE`, `TECH_B2B`, `TECH_B2C`, `GAMING`, `HEALTH_AND_BEAUTY`, `CONSUMER_PACKAGED_GOODS`, `FINANCIAL_SERVICES`, `EDUCATION`, `ENTERTAINMENT`, `EMPLOYMENT`, `AUTO`, `TRAVEL`, `REAL_ESTATE`
+
+**返回数据**：广告列表（最多 30 条），含 `headline`、`body`、`industry`、`budgetCategory`（LOW/MEDIUM/HIGH）、`objective`、`profileName`
+
+**分析重点**：
+1. HIGH 预算广告 = 该品类有大玩家在投入
+2. 多个广告主同一品类 = 市场竞争激烈
+3. 广告文案中的卖点 = 市场验证过的 USP
+4. CONVERSIONS 目标 = 直接带货型广告
+
+---
+
+## 典型工作流
+
+### 趋势预判：从 Reddit 话题到商机
+
+```bash
+# 1. 一键发现趋势（全站 + 多版块聚合）
+scout reddit trends "portable blender"
+# 2. 看到感兴趣的帖子，深入分析评论
+scout reddit comments "https://www.reddit.com/r/..."
+
+# 3. 看竞品在 Reddit 的广告投放
+scout reddit ads "portable blender" -i RETAIL_AND_ECOMMERCE
+
+# 4. 跨平台验证
+scout search "portable blender" --limit 10          # Amazon 市场验证
+scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
+```
+
+### 版块深耕：监控特定社区
+
+```bash
+# 1. 了解版块基本情况
+scout reddit subreddit-info BuyItForLife
+# 2. 看当前热帖
+scout reddit subreddit BuyItForLife --sort hot
+# 3. 搜索特定品类讨论
+scout reddit search "backpack" -s top -t month
+# 4. 分析高互动帖子评论
+scout reddit comments "<帖子URL>"
+```
+
+### 竞品广告分析
+
+```bash
+# 1. 搜索品类广告
+scout reddit ads "wireless earbuds" -i RETAIL_AND_ECOMMERCE
+# 2. 分析广告文案卖点 → 提炼差异化方向
+# 3. 结合 Reddit 用户讨论发现未满足需求
+scout reddit search "wireless earbuds problem" -s top -t month
+```
+
+---
+
+## 数据解读参考
+
+### 帖子热度判断
+
+| 指标 | 高关注 | 中等 | 低关注 |
+|------|--------|------|--------|
+| Score | >500 | 50-500 | <50 |
+| 评论数 | >100 | 20-100 | <20 |
+| Upvote Ratio | >0.90 | 0.70-0.90 | <0.70 |
+
+### 版块活跃度判断
+
+| 订阅者数 | 规模 |
+|----------|------|
+| >1M | 超大社区，趋势信号强 |
+| 100K-1M | 活跃社区，垂直价值高 |
+| 10K-100K | 小众社区，精准需求 |
+| <10K | 新兴/冷门社区 |
+
+### 商机信号识别
+
+| Reddit 信号 | 含义 | 下一步 |
+|------------|------|--------|
+| 多帖问 "best X for Y" | 品类有需求但用户迷茫 | Amazon 选品验证 |
+| 高 score 吐槽帖 | 现有产品痛点明确 | 差异化产品机会 |
+| "I wish..." 高频出现 | 未被满足的需求 | 产品创新方向 |
+| 版块 rising 帖子暴涨 | 新兴趋势正在形成 | 快速入场窗口 |
+| 竞品广告 HIGH 预算 | 品类利润空间大 | 成本分析 + 供应商 |
+
+---
+
+## 重要提醒
+
+1. **timeframe 限制**：`subreddit` 命令的 `--timeframe` 只在 `--sort top` 时有效，其他排序方式传 timeframe 会被自动忽略
+2. **广告数量上限**：`ads` 命令最多返回 30 条广告，无分页
+3. **评论分页**：单次最多返回 ~95 条评论，`hasMore=true` 表示还有更多
+4. **trends 命令成本**：每次调用消耗多个 API credit（1 + 2×版块数），默认 4 个版块 = 9 credits
+5. **版块名大小写敏感**：使用正确的大小写（如 `BuyItForLife` 而非 `buyitforlife`）
+6. **跨 Skill 联动**：Reddit 发现趋势 → scout search Amazon 验证 → scout supplier-search 找供应商 → TikTok/抖音验证社媒热度