@optima-chat/optima-agent 0.9.11 → 0.9.13

package/.claude/skills/twitter/SKILL.md

@@ -1,302 +1,302 @@
----
-name: twitter
-description: "Twitter/X 趋势发现和社交媒体洞察。当用户需要搜索推文（Twitter搜索/搜推特/搜X）、查看 Twitter 热门趋势（Twitter趋势/热搜/trending）、查看 Twitter 用户资料（Twitter用户/推特账号/@某人）、分析推文详情（推文分析/tweet详情）、查看推文评论（推文评论/回复）、查看用户粉丝（粉丝列表/followers）、查看热门推文（top tweets/热门推文）、获取视频转录（推文视频/transcript）、或查看 Twitter 社区（Twitter社区/community）时使用此技能。"
----
-
-# Twitter/X - 趋势发现与社交媒体洞察
-
-所有命令使用 `scout twitter` 前缀。双 API 源：TikHub（搜索/趋势/评论）+ ScrapeCreators（用户推文/转录/社区）。
-
----
-
-## 快速选择：我该用哪个命令？
-
-| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
-|---------|---------|---------|---------|
-| **发现热门趋势** | `trends` | — | 一键聚合趋势榜+关键词搜索 |
-| **搜索相关推文** | `search "关键词"` | `tweet <id>` | 搜索→深入看详情 |
-| **查看热搜榜** | `trending` | — | Twitter 实时热门话题 |
-| **了解某个账号** | `profile <用户名>` | `top-tweets` + `followers` | 主页→热门推文→粉丝 |
-| **分析特定推文** | `tweet <tweetId>` | `comments` | 推文详情→评论分析 |
-| **社区调研** | `community <url>` | `community-tweets` | 社区信息→社区内容 |
-
----
-
-## 典型场景
-
-当用户说：
-- "Twitter 上什么火" / "推特热搜" → `scout twitter trending`
-- "搜一下 Twitter 上关于XX的讨论" → `scout twitter search "XX"`
-- "看看这个 Twitter 账号" / "@某人" → `scout twitter profile <用户名>`
-- "分析这条推文" + tweet ID → `scout twitter tweet <tweetId>`
-- "看看推文评论" → `scout twitter comments <tweetId>`
-- "这个账号的粉丝都是谁" → `scout twitter followers <用户名>`
-- "这个账号最火的推文" → `scout twitter top-tweets <用户名>`
-- "这条视频说了什么" → `scout twitter transcript "<url>"`
-- "看看这个 Twitter 社区" → `scout twitter community "<url>"`
-- "这个品类在 Twitter 上有趋势吗" → `scout twitter trends "品类关键词"`
-
----
-
-## URL 解析 - Twitter/X 链接处理
-
-用户可能直接贴 Twitter 链接，按以下规则处理：
-
-| URL 特征 | 提取内容 | 调用命令 |
-|----------|---------|---------|
-| `x.com/用户名/status/数字` | tweetId (数字) | `scout twitter tweet <tweetId>` |
-| `x.com/用户名` (无 /status) | 用户名 | `scout twitter profile <用户名>` |
-| `x.com/i/communities/数字` | 完整 URL | `scout twitter community "<url>"` |
-| `twitter.com/...` | 同上规则 | 同上 |
-
-**示例**：
-```bash
-# 推文链接 → 提取 tweetId
-# https://x.com/AnthropicAI/status/2034302152945144166
-scout twitter tweet 2034302152945144166
-
-# 用户主页 → 提取用户名
-# https://x.com/AnthropicAI
-scout twitter profile AnthropicAI
-
-# 社区链接 → 传完整 URL
-scout twitter community "https://x.com/i/communities/1926186499399139650"
-```
-
----
-
-## 核心命令
-
-### 🔥 第一层：趋势发现
-
-#### 1. 趋势发现（旗舰命令） - `scout twitter trends`
-
-一键聚合热搜榜 + 关键词搜索，用于趋势预判。
-
-```bash
-scout twitter trends "wireless earbuds"
-scout twitter trends "AI agents"
-scout twitter trends
-```
-
-**参数**：
-- `[keyword]`：搜索关键词（可选，不传则只返回热搜榜）
-- `-f, --format`：输出格式 `json|text`（默认: json）
-
-**返回数据**：
-- `trends`：Twitter 实时热搜话题列表
-- `searchResults`：关键词搜索结果（仅传 keyword 时）
-
-#### 2. 热搜榜 - `scout twitter trending`
-
-查看 Twitter 实时热门话题。
-
-```bash
-scout twitter trending
-```
-
-**返回数据**：`name`（话题名）、`tweetCount`（推文数）、`context`（话题分类）
-
-#### 3. 搜索推文 - `scout twitter search`
-
-按关键词搜索全 Twitter。
-
-```bash
-scout twitter search "coffee maker"
-scout twitter search "standing desk" --type Latest
-scout twitter search "AI tools" --type Top
-```
-
-**参数**：
-- `<keyword>`：搜索关键词（必填）
-- `-t, --type`：搜索类型 `Top|Latest|People|Photos|Videos`（默认: Top）
-- `-f, --format`：输出格式
-
-**返回数据**：推文列表，含 `text`、`author`（screenName + name）、`likes`、`retweets`、`views`、`createdAt`
-
----
-
-### 👤 第二层：账号分析
-
-#### 4. 用户资料 - `scout twitter profile`
-
-查看 Twitter 用户主页信息。
-
-```bash
-scout twitter profile AnthropicAI
-scout twitter profile elonmusk
-```
-
-**返回数据**：`name`、`screenName`、`followers`、`following`、`tweetCount`、`verified`、`description`、`location`、`website`
-
-#### 5. 用户热门推文 - `scout twitter top-tweets`
-
-获取用户最热门的推文（ScrapeCreators 源）。
-
-```bash
-scout twitter top-tweets AnthropicAI
-```
-
-**返回数据**：推文列表（按热度排序），含完整互动数据
-
-**注意**：返回的是用户最热门的推文，不是最新推文。
-
-#### 6. 用户粉丝 - `scout twitter followers`
-
-获取用户粉丝列表及详细信息。
-
-```bash
-scout twitter followers AnthropicAI
-```
-
-**返回数据**：`followersCount`（总粉丝数）、`followers[]`（粉丝列表，含 screenName、followers、description）、`hasMore`、`cursor`
-
----
-
-### 💬 第三层：推文深度分析
-
-#### 7. 推文详情 - `scout twitter tweet`
-
-获取单条推文的完整数据。
-
-```bash
-scout twitter tweet 2034302152945144166
-```
-
-**返回数据**：`text`、`likes`、`retweets`、`replies`、`quotes`、`bookmarks`、`views`、`author`、`createdAt`
-
-#### 8. 推文评论 - `scout twitter comments`
-
-获取推文的回复/评论。
-
-```bash
-scout twitter comments 2034302152945144166
-```
-
-**返回数据**：`comments[]`（评论列表，含 text、author、likes）、`cursor`（分页）
-
-#### 9. 视频转录 - `scout twitter transcript`
-
-获取视频推文的文字转录（AI 驱动，速度较慢）。
-
-```bash
-scout twitter transcript "https://x.com/user/status/123456"
-```
-
-**返回数据**：`transcript`（转录文本）
-
-**注意**：仅视频推文有效，非视频推文返回空。
-
----
-
-### 🏘️ 第四层：社区洞察
-
-#### 10. 社区信息 - `scout twitter community`
-
-获取 Twitter 社区的详细信息。
-
-```bash
-scout twitter community "https://x.com/i/communities/1926186499399139650"
-```
-
-**返回数据**：`name`、`description`、`memberCount`、`joinPolicy`、`rules[]`、`createdAt`
-
-#### 11. 社区推文 - `scout twitter community-tweets`
-
-获取社区内的推文列表。
-
-```bash
-scout twitter community-tweets "https://x.com/i/communities/1926186499399139650"
-```
-
-**返回数据**：推文列表（含完整互动数据 + 作者信息）
-
----
-
-## 典型工作流
-
-### 趋势预判：从 Twitter 话题到商机
-
-```bash
-# 1. 一键发现趋势（热搜 + 关键词搜索）
-scout twitter trends "portable blender"
-
-# 2. 深入分析热门推文的评论
-scout twitter comments <tweetId>
-
-# 3. 跨平台验证
-scout search "portable blender" --limit 10          # Amazon 市场验证
-scout reddit trends "portable blender"               # Reddit 趋势对比
-scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
-```
-
-### 账号分析流程
-
-```bash
-# 1. 查看目标账号主页
-scout twitter profile AnthropicAI
-
-# 2. 看最火推文
-scout twitter top-tweets AnthropicAI
-
-# 3. 看粉丝质量
-scout twitter followers AnthropicAI
-
-# 4. 深入分析某条推文
-scout twitter tweet <tweetId>
-scout twitter comments <tweetId>
-```
-
-### 竞品社媒分析
-
-```bash
-# 1. 搜索竞品推文
-scout twitter search "竞品品牌" --type Top
-
-# 2. 看竞品账号
-scout twitter profile 竞品账号
-
-# 3. 分析竞品最火推文
-scout twitter top-tweets 竞品账号
-```
-
----
-
-## 数据解读参考
-
-### 推文表现判断
-
-| 指标 | 高互动 | 中等 | 低互动 |
-|------|--------|------|--------|
-| Views | >100K | 10K-100K | <10K |
-| Likes/Views | >3% | 1-3% | <1% |
-| RT/Views | >1% | 0.3-1% | <0.3% |
-| Replies/Likes | >10% | 3-10% | <3% |
-
-### 账号质量判断
-
-| 指标 | 优秀 | 良好 | 一般 |
-|------|------|------|------|
-| 粉丝数 | >100K | 10K-100K | <10K |
-| 推文互动率 | >5% | 1-5% | <1% |
-| 粉丝/关注比 | >10:1 | 3:1-10:1 | <3:1 |
-
-### 商机信号识别
-
-| Twitter 信号 | 含义 | 下一步 |
-|-------------|------|--------|
-| 热搜话题与品类相关 | 大众关注度高 | 趋势确认 + Amazon 验证 |
-| 高 views 产品推文 | 产品有传播力 | 分析评论反馈 |
-| KOL 推荐某产品 | 意见领袖背书 | 看粉丝反应 + 供应商 |
-| 社区高频讨论某需求 | 垂直需求明确 | 精准选品机会 |
-
----
-
-## 重要提醒
-
-1. **screenName 大小写敏感**：使用正确的 Twitter 用户名（如 `AnthropicAI` 而非 `anthropicai`）
-2. **tweetId 纯数字**：从推文 URL 中提取数字 ID（如 `2034302152945144166`）
-3. **社区 URL 完整传入**：社区命令需要传完整的 `https://x.com/i/communities/...` URL
-4. **视频转录较慢**：transcript 使用 AI 生成，响应时间可能较长
-5. **热门推文非最新**：`top-tweets` 返回的是用户最热门推文，不是最新发布的
-6. **跨 Skill 联动**：Twitter 发现趋势 → Reddit 验证讨论 → scout search Amazon 验证 → scout supplier-search 找供应商
+---
+name: twitter
+description: "Twitter/X 趋势发现和社交媒体洞察。当用户需要搜索推文（Twitter搜索/搜推特/搜X）、查看 Twitter 热门趋势（Twitter趋势/热搜/trending）、查看 Twitter 用户资料（Twitter用户/推特账号/@某人）、分析推文详情（推文分析/tweet详情）、查看推文评论（推文评论/回复）、查看用户粉丝（粉丝列表/followers）、查看热门推文（top tweets/热门推文）、获取视频转录（推文视频/transcript）、或查看 Twitter 社区（Twitter社区/community）时使用此技能。"
+---
+
+# Twitter/X - 趋势发现与社交媒体洞察
+
+所有命令使用 `scout twitter` 前缀。双 API 源：TikHub（搜索/趋势/评论）+ ScrapeCreators（用户推文/转录/社区）。
+
+---
+
+## 快速选择：我该用哪个命令？
+
+| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
+|---------|---------|---------|---------|
+| **发现热门趋势** | `trends` | — | 一键聚合趋势榜+关键词搜索 |
+| **搜索相关推文** | `search "关键词"` | `tweet <id>` | 搜索→深入看详情 |
+| **查看热搜榜** | `trending` | — | Twitter 实时热门话题 |
+| **了解某个账号** | `profile <用户名>` | `top-tweets` + `followers` | 主页→热门推文→粉丝 |
+| **分析特定推文** | `tweet <tweetId>` | `comments` | 推文详情→评论分析 |
+| **社区调研** | `community <url>` | `community-tweets` | 社区信息→社区内容 |
+
+---
+
+## 典型场景
+
+当用户说：
+- "Twitter 上什么火" / "推特热搜" → `scout twitter trending`
+- "搜一下 Twitter 上关于XX的讨论" → `scout twitter search "XX"`
+- "看看这个 Twitter 账号" / "@某人" → `scout twitter profile <用户名>`
+- "分析这条推文" + tweet ID → `scout twitter tweet <tweetId>`
+- "看看推文评论" → `scout twitter comments <tweetId>`
+- "这个账号的粉丝都是谁" → `scout twitter followers <用户名>`
+- "这个账号最火的推文" → `scout twitter top-tweets <用户名>`
+- "这条视频说了什么" → `scout twitter transcript "<url>"`
+- "看看这个 Twitter 社区" → `scout twitter community "<url>"`
+- "这个品类在 Twitter 上有趋势吗" → `scout twitter trends "品类关键词"`
+
+---
+
+## URL 解析 - Twitter/X 链接处理
+
+用户可能直接贴 Twitter 链接，按以下规则处理：
+
+| URL 特征 | 提取内容 | 调用命令 |
+|----------|---------|---------|
+| `x.com/用户名/status/数字` | tweetId (数字) | `scout twitter tweet <tweetId>` |
+| `x.com/用户名` (无 /status) | 用户名 | `scout twitter profile <用户名>` |
+| `x.com/i/communities/数字` | 完整 URL | `scout twitter community "<url>"` |
+| `twitter.com/...` | 同上规则 | 同上 |
+
+**示例**：
+```bash
+# 推文链接 → 提取 tweetId
+# https://x.com/AnthropicAI/status/2034302152945144166
+scout twitter tweet 2034302152945144166
+
+# 用户主页 → 提取用户名
+# https://x.com/AnthropicAI
+scout twitter profile AnthropicAI
+
+# 社区链接 → 传完整 URL
+scout twitter community "https://x.com/i/communities/1926186499399139650"
+```
+
+---
+
+## 核心命令
+
+### 🔥 第一层：趋势发现
+
+#### 1. 趋势发现（旗舰命令） - `scout twitter trends`
+
+一键聚合热搜榜 + 关键词搜索，用于趋势预判。
+
+```bash
+scout twitter trends "wireless earbuds"
+scout twitter trends "AI agents"
+scout twitter trends
+```
+
+**参数**：
+- `[keyword]`：搜索关键词（可选，不传则只返回热搜榜）
+- `-f, --format`：输出格式 `json|text`（默认: json）
+
+**返回数据**：
+- `trends`：Twitter 实时热搜话题列表
+- `searchResults`：关键词搜索结果（仅传 keyword 时）
+
+#### 2. 热搜榜 - `scout twitter trending`
+
+查看 Twitter 实时热门话题。
+
+```bash
+scout twitter trending
+```
+
+**返回数据**：`name`（话题名）、`tweetCount`（推文数）、`context`（话题分类）
+
+#### 3. 搜索推文 - `scout twitter search`
+
+按关键词搜索全 Twitter。
+
+```bash
+scout twitter search "coffee maker"
+scout twitter search "standing desk" --type Latest
+scout twitter search "AI tools" --type Top
+```
+
+**参数**：
+- `<keyword>`：搜索关键词（必填）
+- `-t, --type`：搜索类型 `Top|Latest|People|Photos|Videos`（默认: Top）
+- `-f, --format`：输出格式
+
+**返回数据**：推文列表，含 `text`、`author`（screenName + name）、`likes`、`retweets`、`views`、`createdAt`
+
+---
+
+### 👤 第二层：账号分析
+
+#### 4. 用户资料 - `scout twitter profile`
+
+查看 Twitter 用户主页信息。
+
+```bash
+scout twitter profile AnthropicAI
+scout twitter profile elonmusk
+```
+
+**返回数据**：`name`、`screenName`、`followers`、`following`、`tweetCount`、`verified`、`description`、`location`、`website`
+
+#### 5. 用户热门推文 - `scout twitter top-tweets`
+
+获取用户最热门的推文（ScrapeCreators 源）。
+
+```bash
+scout twitter top-tweets AnthropicAI
+```
+
+**返回数据**：推文列表（按热度排序），含完整互动数据
+
+**注意**：返回的是用户最热门的推文，不是最新推文。
+
+#### 6. 用户粉丝 - `scout twitter followers`
+
+获取用户粉丝列表及详细信息。
+
+```bash
+scout twitter followers AnthropicAI
+```
+
+**返回数据**：`followersCount`（总粉丝数）、`followers[]`（粉丝列表，含 screenName、followers、description）、`hasMore`、`cursor`
+
+---
+
+### 💬 第三层：推文深度分析
+
+#### 7. 推文详情 - `scout twitter tweet`
+
+获取单条推文的完整数据。
+
+```bash
+scout twitter tweet 2034302152945144166
+```
+
+**返回数据**：`text`、`likes`、`retweets`、`replies`、`quotes`、`bookmarks`、`views`、`author`、`createdAt`
+
+#### 8. 推文评论 - `scout twitter comments`
+
+获取推文的回复/评论。
+
+```bash
+scout twitter comments 2034302152945144166
+```
+
+**返回数据**：`comments[]`（评论列表，含 text、author、likes）、`cursor`（分页）
+
+#### 9. 视频转录 - `scout twitter transcript`
+
+获取视频推文的文字转录（AI 驱动，速度较慢）。
+
+```bash
+scout twitter transcript "https://x.com/user/status/123456"
+```
+
+**返回数据**：`transcript`（转录文本）
+
+**注意**：仅视频推文有效，非视频推文返回空。
+
+---
+
+### 🏘️ 第四层：社区洞察
+
+#### 10. 社区信息 - `scout twitter community`
+
+获取 Twitter 社区的详细信息。
+
+```bash
+scout twitter community "https://x.com/i/communities/1926186499399139650"
+```
+
+**返回数据**：`name`、`description`、`memberCount`、`joinPolicy`、`rules[]`、`createdAt`
+
+#### 11. 社区推文 - `scout twitter community-tweets`
+
+获取社区内的推文列表。
+
+```bash
+scout twitter community-tweets "https://x.com/i/communities/1926186499399139650"
+```
+
+**返回数据**：推文列表（含完整互动数据 + 作者信息）
+
+---
+
+## 典型工作流
+
+### 趋势预判：从 Twitter 话题到商机
+
+```bash
+# 1. 一键发现趋势（热搜 + 关键词搜索）
+scout twitter trends "portable blender"
+
+# 2. 深入分析热门推文的评论
+scout twitter comments <tweetId>
+
+# 3. 跨平台验证
+scout search "portable blender" --limit 10          # Amazon 市场验证
+scout reddit trends "portable blender"               # Reddit 趋势对比
+scout supplier-search "便携式榨汁机" --limit 10      # 1688 供应商
+```
+
+### 账号分析流程
+
+```bash
+# 1. 查看目标账号主页
+scout twitter profile AnthropicAI
+
+# 2. 看最火推文
+scout twitter top-tweets AnthropicAI
+
+# 3. 看粉丝质量
+scout twitter followers AnthropicAI
+
+# 4. 深入分析某条推文
+scout twitter tweet <tweetId>
+scout twitter comments <tweetId>
+```
+
+### 竞品社媒分析
+
+```bash
+# 1. 搜索竞品推文
+scout twitter search "竞品品牌" --type Top
+
+# 2. 看竞品账号
+scout twitter profile 竞品账号
+
+# 3. 分析竞品最火推文
+scout twitter top-tweets 竞品账号
+```
+
+---
+
+## 数据解读参考
+
+### 推文表现判断
+
+| 指标 | 高互动 | 中等 | 低互动 |
+|------|--------|------|--------|
+| Views | >100K | 10K-100K | <10K |
+| Likes/Views | >3% | 1-3% | <1% |
+| RT/Views | >1% | 0.3-1% | <0.3% |
+| Replies/Likes | >10% | 3-10% | <3% |
+
+### 账号质量判断
+
+| 指标 | 优秀 | 良好 | 一般 |
+|------|------|------|------|
+| 粉丝数 | >100K | 10K-100K | <10K |
+| 推文互动率 | >5% | 1-5% | <1% |
+| 粉丝/关注比 | >10:1 | 3:1-10:1 | <3:1 |
+
+### 商机信号识别
+
+| Twitter 信号 | 含义 | 下一步 |
+|-------------|------|--------|
+| 热搜话题与品类相关 | 大众关注度高 | 趋势确认 + Amazon 验证 |
+| 高 views 产品推文 | 产品有传播力 | 分析评论反馈 |
+| KOL 推荐某产品 | 意见领袖背书 | 看粉丝反应 + 供应商 |
+| 社区高频讨论某需求 | 垂直需求明确 | 精准选品机会 |
+
+---
+
+## 重要提醒
+
+1. **screenName 大小写敏感**：使用正确的 Twitter 用户名（如 `AnthropicAI` 而非 `anthropicai`）
+2. **tweetId 纯数字**：从推文 URL 中提取数字 ID（如 `2034302152945144166`）
+3. **社区 URL 完整传入**：社区命令需要传完整的 `https://x.com/i/communities/...` URL
+4. **视频转录较慢**：transcript 使用 AI 生成，响应时间可能较长
+5. **热门推文非最新**：`top-tweets` 返回的是用户最热门推文，不是最新发布的
+6. **跨 Skill 联动**：Twitter 发现趋势 → Reddit 验证讨论 → scout search Amazon 验证 → scout supplier-search 找供应商