# Send Reddit 主题洞察 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "reddit-topic-insight",
    "name": "Reddit 主题洞察",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/Wbule/reddit-topic-insight",
    "canonicalUrl": "https://clawhub.ai/Wbule/reddit-topic-insight",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/reddit-topic-insight",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-topic-insight",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "reference/article-types.md",
      "reference/x-tweet-template.md",
      "reference/xiaohongshu-template.md",
      "reference/wechat-template.md",
      "runs/openclaw-tips/keywords.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "reddit-topic-insight",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T02:11:17.453Z",
      "expiresAt": "2026-05-07T02:11:17.453Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-topic-insight",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=reddit-topic-insight",
        "contentDisposition": "attachment; filename=\"reddit-topic-insight-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "reddit-topic-insight"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/reddit-topic-insight"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/reddit-topic-insight",
    "downloadUrl": "https://openagent3.xyz/downloads/reddit-topic-insight",
    "agentUrl": "https://openagent3.xyz/skills/reddit-topic-insight/agent",
    "manifestUrl": "https://openagent3.xyz/skills/reddit-topic-insight/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/reddit-topic-insight/agent.md"
  }
}
```
## Documentation

### Reddit 主题洞察 Skill

从 Reddit 社区讨论中挖掘爆款内容角度，自动产出三平台（X / 小红书 / 公众号）成品内容。

### 触发条件

当用户：

提及「Reddit 研究」「Reddit 洞察」「Reddit 话题」
想从 Reddit 挖掘内容角度或爆款灵感
需要基于 Reddit 讨论产出多平台内容
使用类似「分析 Reddit 上关于 XX 的讨论」的表述

### 设计原则

原则说明确定性 → 脚本数据采集、排序去重、内容合并等确定性操作使用 Python 脚本创造性 → AI关键词设计、角度规划、内容创作等创造性操作由 AI SubAgent 完成上下文隔离SubAgent 只接收必要信息、只返回极简结果主 Agent 保护主 Agent 不读 piece 文件，避免上下文膨胀断点恢复progress.json 记录流水线进度，支持随时中断恢复

### 7 步流水线

┌─────────────────────────────────────────────────────┐
│  Step 1: 需求收集                                    │
│  初始化运行目录 + progress.json 断点恢复               │
├─────────────────────────────────────────────────────┤
│  Step 2: 关键词设计                    [AI 创造性]     │
│  5 个英文关键词：核心/同义/教程/经验/痛点               │
├─────────────────────────────────────────────────────┤
│  Step 3: 数据采集                      [Python 脚本]  │
│  reddit_collector.py → posts_raw.json               │
├─────────────────────────────────────────────────────┤
│  Step 4: 详情获取                      [Python 脚本]  │
│  reddit_detail_fetcher.py → posts_detail.json       │
├─────────────────────────────────────────────────────┤
│  Step 5: 角度规划                      [AI 创造性]     │
│  单 SubAgent → 10 个角度 × 10 种文章类型              │
├─────────────────────────────────────────────────────┤
│  Step 6: 成品生产                      [AI 创造性]     │
│  5 SubAgent × 3 轮（2+2+1）并行                      │
│  每角度 → X 推文 + 小红书笔记 + 公众号文章             │
├─────────────────────────────────────────────────────┤
│  Step 7: 合并输出                      [Python 脚本]  │
│  content_merger.py → content.md + 来源表格            │
└─────────────────────────────────────────────────────┘

### Step 1: 需求收集

详见 step-1-requirement.md

检查运行目录下是否存在 progress.json
若存在：读取进度，从中断步骤恢复
若不存在：向用户确认研究主题和目标受众
创建 runs/<topic-slug>/ 目录
初始化 progress.json

### Step 2: 关键词设计

详见 step-2-keywords.md

AI 生成 5 个英文搜索关键词，覆盖：

🎯 核心词（锚定词，必须保留）
🔄 同义词 / 近义词
📚 教程 / How-to 类
💡 经验 / 最佳实践类
😫 痛点 / 问题类

输出 → keywords.json

### Step 3: 数据采集

详见 step-3-collect.md

python3 scripts/python/reddit_collector.py \\
  --keywords-file runs/<slug>/keywords.json \\
  --output runs/<slug>/posts_raw.json \\
  --config config/default.json

### Step 4: 详情获取

详见 step-4-details.md

python3 scripts/python/reddit_detail_fetcher.py \\
  --input runs/<slug>/posts_raw.json \\
  --output runs/<slug>/posts_detail.json \\
  --config config/default.json

### Step 5: 角度规划

详见 step-5-angles.md

单 SubAgent 读取帖子摘要 → 规划 10 个不重复角度 → 匹配文章类型 → angles.json

### Step 6: 成品生产

详见 step-6-produce.md

5 个 SubAgent 分 3 轮并行（2+2+1），每角度产出三平台成品 → pieces/angle-{n}.md

### Step 7: 合并输出

详见 step-7-merge.md

python3 scripts/python/content_merger.py \\
  --pieces-dir runs/<slug>/pieces \\
  --posts-file runs/<slug>/posts_detail.json \\
  --output runs/<slug>/content.md

### 运行目录结构

每次运行产生以下文件：

runs/<topic-slug>/
├── progress.json         # 流水线进度
├── keywords.json         # 5 个关键词
├── posts_raw.json        # 原始帖子列表
├── posts_detail.json     # 帖子详情 + 评论
├── angles.json           # 10 个角度规划
├── pieces/               # 各角度成品
│   ├── angle-01.md
│   ├── angle-02.md
│   └── ...
└── content.md            # 最终合并输出

### 配置

默认配置文件：config/default.json

可选环境变量（用于 Reddit API 认证，提高速率限制）：

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret

### 脚本依赖

仅需 requests 库：

pip install requests

### 参考模板

10 种文章类型
X 推文模板
小红书笔记模板
公众号文章模板
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Wbule
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T02:11:17.453Z
- Expires at: 2026-05-07T02:11:17.453Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/reddit-topic-insight)
- [Send to Agent page](https://openagent3.xyz/skills/reddit-topic-insight/agent)
- [JSON manifest](https://openagent3.xyz/skills/reddit-topic-insight/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/reddit-topic-insight/agent.md)
- [Download page](https://openagent3.xyz/downloads/reddit-topic-insight)