Reddit Pipeline
告诉它你的产品品类，自动帮你搜帖子、找缺口、写回复、去 AI 味——最后给你一份按优先级排列的帖子链接 + 可直接复制粘贴的回复文案。脚本 main.py 负责前三步（搜帖→缺口分析→回复生成），第四步去 AI 味在会话中按内联规则完成。搭子配置见 config.yaml。
能力边界
能做什么
- 按产品品类搜索 Reddit 高热度帖子并返回链接
- 分析帖子的讨论缺口（哪些功能被提到了、哪些没被提到）
- 基于缺口生成营销回复文案
- 对回复文案去 AI 味，使其读起来更像真人
- 按热度和缺口机会将帖子分为两个梯队排列优先级
不能做什么
- 不能代发帖：本 skill 没有 Reddit 账号集成，只输出文案，你需手动粘贴
- 不覆盖非消费品品类：品类限定于实体消费品（电子产品、家居、美妆等），金融产品、B2B 软件、抽象概念等品类效果不佳。
执行流程
按以下顺序执行，每一步都对应后续章节的细节：
- 取 API Key：检查
~/.cue/config.json是否已配置。缺失时按「鉴权」流程引导用户提供，再继续。 - 品类确认：确认用户提供了产品品类。未提供时按「引导话术 > 未提供品类」引导。
- 品类预处理：把品类翻成 Reddit 惯用词；冷门品类先向用户预警。详见「品类预处理」。
- 扣点确认：向用户说明预估积分消耗，确认后再运行脚本。详见「积分与确认」。
- 运行脚本：执行
main.py，搜帖→筛选最近 3 篇→缺口分析→回复生成。详见「运行方式」。 - 去 AI 味：对每篇回复按内联规则手动去 AI 味。详见「去 AI 味」。
- 交付报告：按梯队呈现结果，告知本次积分消耗。详见「输出交付」。
任一步异常按「异常处理」章节对号入座。
鉴权
脚本按 ~/.cue/config.json → 环境变量 CUE_API_KEY → config.yaml 的顺序读取 Cue API Key。运行脚本前，按以下流程确认 key 就绪。任何时候都不要编造或猜测 key。
- 检查是否已配置。 检查
~/.cue/config.json是否已有api_key。有则直接进入后续流程，不要回读、不要回显用户已配好的 Key。 - 缺失则引导用户获取。 若没有，按「引导话术 > 缺少 API Key」提示用户前往 Cue 平台注册获取。在拿到 key 之前不要运行脚本。
- 收到 key 后由你写入配置文件。 用户把 key 发给你后，用下面的方式合并写入
~/.cue/config.json（保留文件里已有的字段，如base，不要整个覆盖）：
bash
NEW_CUE_KEY='用户给的key' python3 - <<'PY'
import json, os, pathlib
p = pathlib.Path.home() / ".cue" / "config.json"
d = json.loads(p.read_text()) if p.exists() else {}
d["api_key"] = os.environ["NEW_CUE_KEY"]
p.write_text(json.dumps(d, ensure_ascii=False))
print("已写入 ~/.cue/config.json")
PY
写入后不回读、不回显该 Key。配好之后用户不需要再提供，main.py 每次都从 ~/.cue/config.json 读取。
4. 鉴权失败时。 若脚本报 HTTP 401/403，说明 key 无效或过期。提示用户重新前往 Cue 平台生成新 key，不要反复用同一个失效 key 重跑。
> Cue API Key：cuecue.cn 注册获取。
> API Key 只能由用户本人创建：Agent 不代生成；用户提供后即写入配置文件，之后不再回读或回显。
可以试试这样问
- 「帮我在 Reddit 上找电动牙刷的潜在客户」
- 「机械键盘怎么做 Reddit 营销」
- 「车载行车记录仪，搜帖并写回复」
- 「便携移动电源」
一个品类词就能跑，说得越具体，搜到的帖子越准。如果用户给的是模糊描述（如「帮我做营销」），按「引导话术 > 未提供品类」引导其补充具体品类。
品类预处理
用户给的品类名，Reddit 上不一定这么叫——中文品类尤其容易和 Reddit 惯用词对不上。跑脚本前（步骤 3）先做三件事，避免为一个搜不出东西的品类白烧搭子2/3 的积分：
- 翻译：把品类转成 Reddit 惯用表达。例：
- 「筋膜枪」→massage gun
- 「行车记录仪」→dash cam
- 「充电宝」→power bank
- 「XX 平替」→XX alternative/XX dupe - 兜底：拿不准就给用户 2-3 个候选词，或升到上位品类（「XX 专用配件」→「XX」），让用户挑一个。
- 冷门预警：判断这词大概率搜不到时（非日常用品、极小众品类、太新的概念），先跟用户说明「这类在 Reddit 讨论少，可能搜不到，要不要换个更常见的说法」，用户拍板后再跑，不要直接消耗积分。
> 日常消费品、用户给的就是通用词时，翻译一下直接跑即可，不必啰嗦；只有存疑时才需要向用户确认。
引导话术
当用户触发本技能但缺少必要信息时，按以下场景引导。语气亲和自然。
未提供品类
> 技能已就绪 ✅ 这个技能能帮你在 Reddit 上做全流程营销——自动搜帖子、分析讨论缺口、生成回复文案、去掉 AI 味道，最后给你一份按优先级排列的帖子链接 + 可直接粘贴的回复 📊
>
> 告诉我你的产品品类就行，比如：
> - "电动牙刷"
> - "车载行车记录仪"
> - "便携式移动电源"
>
> 品类越具体，搜到的帖子越精准 🎯
缺少 API Key
> 跑这个流程需要调用 Cue 平台的深度搜索服务，得先配置一下 API Key 🔑
>
> 👉 在 cuecue.cn 免费注册获取 API key（新账号送 500 积分，每天再免费送 10 分）。
> 👉 把 key 发给我就行，我帮你配置好，之后就不用再给了。
积分耗尽
> 你的 Cue 积分不足，本次任务未能启动。两个办法：
> 1. 邀请好友得 500 积分（推荐）：打开 https://cuecue.cn/ ，点击页面左下角「获取专属邀请链接」，分享给好友——好友加入后你再得 500 积分。
> 2. 直接充值：前往 cuecue.cn/pay 订阅（首次充值有优惠）；或等次日免费额度。
积分与确认
本技能每次运行会消耗 Cue 平台积分（调用三个搭子）。整条链路的积分感知由你来贯穿：
积分政策：新账号送 500 积分，每天再免费送 10 分，邀请新用户激活后再送 500 积分。积分用完后按「引导话术 > 积分耗尽」处理。
- 执行前确认：识别到有效品类、API Key 就绪后，运行脚本前向用户说明并请其确认：
> 本次预计消耗约 10-20 个 Cue 积分（搭子1 搜索 + 最近 3 篇帖子的缺口分析与回复生成），是否继续？
等用户明确确认后再运行脚本；用户未确认不要运行。
-
执行后告知：脚本运行完毕后，积分已由 Cue 平台自动扣除。
-
脚本中途失败：若脚本在搭子1 阶段失败（未搜到帖子），几乎没有积分消耗。若在搭子2/3 阶段失败（部分帖子已处理），对应的搭子调用已扣分，无法返还。
-
积分不足：按「引导话术 > 积分耗尽」主动给出拿积分最快的路径（邀请好友 / 充值 / 等次日免费额度）。不要只丢错误码，也不要重试。
运行方式
本 skill 有两种运行方式：
- 通过智能体调用（推荐）：在支持安装 skill 的智能体（如 WorkBuddy、CodeBuddy 等）中触发本 skill，直接告诉它产品品类，agent 会按「执行流程」自动完成搜帖 → 缺口分析 → 回复生成 → 去 AI 味 → 交付报告，无需手动敲命令。
- 命令行直接运行：在 skill 目录下手动执行脚本（调试或批量场景）：
python main.py "产品品类"
可选参数（命令行方式适用）：
| 参数 | 说明 |
|---|---|
-q, --quiet |
脚本不打印中间进度，仅输出最终结果（agent 场景不建议用，会看不到过程） |
-w N, --workers N |
并行线程数（默认 3） |
-o PATH, --output PATH |
结果保存到文件 |
--inspect |
查看搭子配置（不消耗积分） |
-h, --help |
显示帮助 |
示例：
# 基础用法
python main.py "电动牙刷"
# 静默模式 + 保存结果
python main.py -q "机械键盘" -o result.md
# 限制并行数
python main.py -w 3 "便携式移动电源"
# 查看搭子配置（不消耗积分）
python main.py --inspect
去 AI 味
脚本输出的回复文案由搭子3（AI）生成，直接使用有 AI 写作痕迹。对每篇回复按以下内联规则手动去 AI 味：
- 删 AI 高频词：删掉"此外 / 然而 / 因此 / 同时 / 总之 / 综上所述 / 值得注意的是 / 首先 / 其次 / 最后"等连接词和结构化标记
- 删空话套话：删掉"无缝 / 强大 / 赋能 / 颠覆 / 意义重大 / 不容错过"等宣传腔
- 去公式化："不是 A 而是 B"直接写成 B；删掉"希望对你有所帮助"式结尾；三段式罗列改成自然句子
- 加人味：用第一人称（"我用了两个月，最明显的是..."），补一个具体的使用体验或细节，允许承认不完美（"我也不是专家""就我个人感觉"）
- 口语化收尾：最后一句用短句、具体的话收尾，不要总结升华
处理完自检：无残留连接词和套话，读起来像真人在 Reddit 回帖。
输出交付
成功时按固定报告模板交付，保证每次输出格式一致、可直接复制使用。
报告模板
## Reddit 营销回复报告
### 第一梯队（立即参与）
**1. {标题}**
- 链接：{url}
- Cue 对话：{cue_url}
- 回复文案（已去 AI 味）：
{文案}
**2. ...**
### 第二梯队（本周完成）
...
交付规则
- 每篇帖子展示 4 要素：标题、链接、Cue 对话链接、去 AI 味后的回复文案。
- Cue 对话链接：取脚本为每篇帖子输出的
Cue 对话:链接（指向该帖在 Cue 上的分析对话，用户可回网页端查看完整推理或继续追问）。必须取自脚本实际输出，禁止编造 conv_id；脚本未给出该链接时省略此要素，不要拼假链接。 - 部分失败：成功的帖子正常交付；失败的帖子在报告末尾单独列出（标题 + 失败原因），并询问用户是否重试。
- 告知积分：提醒用户本次调用消耗的积分已由 Cue 平台自动扣除。
- 交付后闭环：
- 建议用户从第一梯队第 1 篇开始试
- 发之前自检：回复有没有带产品链接、是不是太像广告、有没有遵守 sub 规则
- 邀请用户发完反馈结果，可帮忙进一步调整语气或角度
- 告知本次消耗的积分，并给出继续用的理由：同一个品类可以过段时间重跑（帖子会更新，能挖到新缺口），或换个品类接着跑——品类越具体，搜到的帖子越准
异常处理
| 场景 | 处理 |
|---|---|
| 未配置 API Key | 按「鉴权」流程引导用户提供 Key，收到后由你写入 ~/.cue/config.json。任务未发起，不扣积分。 |
| 品类为空 | 按「引导话术 > 未提供品类」引导。任务未发起，不扣积分。 |
| 搭子1 返回空（未搜到帖子） | 告知用户该品类未找到合适帖子，建议换关键词或拓宽品类。几乎不扣积分。 |
| 搭子2/3 部分帖子失败 | 成功的帖子正常交付；失败的帖子标注为处理失败。已调用的搭子已扣分。 |
| 网络超时 / 连接中断 | 脚本内置容错：已收到部分内容视为部分成功。告知用户实际完成情况，询问是否重试失败的帖子。 |
积分不足（INSUFFICIENT_CREDITS） |
按「引导话术 > 积分耗尽」主动给出拿积分最快的路径。不要重试。 |
FAQ
Q：回复被删了 / 账号被 shadowban 了怎么办？
A：Reddit 对自我推广（self-promotion）极其敏感，常见触发原因：每条回复都带产品链接、新账号只发推广、没遵守 subreddit 自推广规则。建议：别每条都带链接，先给有信息量的回答；先养号（正常评论、投票、发帖积累 karma）再慢慢掺入推广；进 sub 先读它的自推广规则（很多要求「约 10 条正常参与对应 1 条推广」）；已被 shadowban 的号很难救，建议换号、别再犯同样错误。
Q：回复发出去没人理 / 被 downvote？
A：常见原因：回复太像广告、没正面回答 OP 的问题、发在太老或太冷的帖子上。建议：优先回高热度、一周内、且你确实能贡献价值的帖子（脚本输出的梯队已排好优先级）；回复要有具体信息量，别只夸产品；偶尔被 downvote 正常，换角度重试即可。
Q：帖子太久远了，还能回吗？
A：Reddit 帖子约 6 个月后归档锁定，无法评论或投票；即使没归档，太老的帖子活跃度也很低。建议优先回一周内的帖子，搭子1 会优先返回高热度近期帖。
Q：一天发几条合适？会不会被判 spam？
A：没有统一标准，但新账号短时间密集发推广容易被全站过滤。建议：新号先正常活动几天积累信誉；推广回复一天控制在个位数、分散在不同 sub；推广内容占比保持低位。
Q：积分扣了，但没看到结果 / 结果为空？
A：先看脚本输出的成功/失败统计。搭子1 没搜到帖子几乎不扣分；部分帖子在搭子2/3 失败则对应积分已扣、结果里会标注失败。
Q：脚本报 401/403？
A：API Key 无效或过期。去 cuecue.cn 重新生成 key，把新 key 发给 AI 助手帮你重新配置，别反复用失效 key 重跑。
Q：搜到的帖子太少 / 不相关？
A：品类关键词越具体越准。试试更具体的关键词，或换个角度拓宽品类（如「电动牙刷」换成「声波牙刷」「oral-b 平替」）。
