Redditfind openclaw skill

RedditFind Skill

何时使用

当用户希望你完成下面这些事情时，使用这个 Skill：

• 找适合产品进入的 subreddit
• 分析某个 subreddit 的规则、氛围和参与方式
• 创建或管理 Reddit 监控任务
• 查看 RedditFind usage、当前接入状态与授权状态
• 用稳定的 CLI 而不是手写 HTTP 来接入 RedditFind Open API

启动前检查

每次进入业务命令前，优先执行：

1. ./bin/redditfind doctor --json
2. ./bin/redditfind auth ensure --json

如果 doctor 返回 API 不可达、配置不可写、授权已失效，先修复再继续。

核心执行规则

• 优先用 CLI，不默认手写 HTTP 请求
• discovery / overview 这类异步任务，默认优先 --wait
• 默认使用 test 环境，除非用户明确要求 live
• 不要自动扩大 scope；scope 不足时，先说明并重新走授权
• 删除监控、撤销凭证、切换到 live 时，先明确告诉用户

默认命令映射

• 找社区：./bin/redditfind discovery create --wait --json
• 社区分析：./bin/redditfind overview create --wait --json
• 创建监控：./bin/redditfind monitoring create --json
• 读取 usage：./bin/redditfind usage get --json
• 查看当前 token 身份：./bin/redditfind auth whoami --json

授权流程

默认授权路径：

1. auth ensure 发起 skill-auth/start
2. CLI 自动打开浏览器到授权确认页
3. 用户登录并批准一次
4. CLI 轮询 skill-auth/poll
5. CLI 调 skill-auth/exchange 换取正式 Token
6. CLI 把 Token 安全保存到本机 profile

优先使用 CLI 自带流程，不要要求用户自己打开控制台复制 API Key。

错误恢复

• AUTH_REQUIRED：先执行 ./bin/redditfind auth ensure --json
• DEVICE_CODE_INVALID：重新执行 auth ensure
• FLOW_EXPIRED：重新执行 auth ensure
• FORBIDDEN / SCOPE_INSUFFICIENT：说明 scope 不足并重新授权
• RATE_LIMITED：等待 retry_after 或 Retry-After 后重试一次
• RESULT_NOT_READY：继续等待，不要把它当成失败
• NOT_FOUND：检查资源 ID 或重新创建任务

详细说明见：

• references/auth-flow.md
• references/command-contract.md
• references/error-recovery.md
• references/api-map.md

输出规则

返回给用户时：

1. 先给一句结论
2. 再给关键发现
3. 再给风险提醒
4. 最后给下一步建议

如果命令带 --json，优先消费结构化输出后再整理给用户，不要直接原样转发内部 JSON。