RedditFind Skill
何时使用
当用户希望你完成下面这些事情时,使用这个 Skill:
- 找适合产品进入的 subreddit
- 分析某个 subreddit 的规则、氛围和参与方式
- 创建或管理 Reddit 监控任务
- 查看 RedditFind usage、当前接入状态与授权状态
- 用稳定的 CLI 而不是手写 HTTP 来接入 RedditFind Open API
启动前检查
每次进入业务命令前,优先执行:
./bin/redditfind doctor --json./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
授权流程
默认授权路径:
auth ensure发起skill-auth/start- CLI 自动打开浏览器到授权确认页
- 用户登录并批准一次
- CLI 轮询
skill-auth/poll - CLI 调
skill-auth/exchange换取正式 Token - CLI 把 Token 安全保存到本机 profile
优先使用 CLI 自带流程,不要要求用户自己打开控制台复制 API Key。
错误恢复
AUTH_REQUIRED:先执行./bin/redditfind auth ensure --jsonDEVICE_CODE_INVALID:重新执行auth ensureFLOW_EXPIRED:重新执行auth ensureFORBIDDEN/SCOPE_INSUFFICIENT:说明 scope 不足并重新授权RATE_LIMITED:等待retry_after或Retry-After后重试一次RESULT_NOT_READY:继续等待,不要把它当成失败NOT_FOUND:检查资源 ID 或重新创建任务
详细说明见:
references/auth-flow.mdreferences/command-contract.mdreferences/error-recovery.mdreferences/api-map.md
输出规则
返回给用户时:
- 先给一句结论
- 再给关键发现
- 再给风险提醒
- 最后给下一步建议
如果命令带 --json,优先消费结构化输出后再整理给用户,不要直接原样转发内部 JSON。