技能介绍

解决什么问题

做多平台资料收集时，工程师通常会给每个平台写一段一次性脚本：处理登录态、搜索参数、翻页和失败重试，时间一长就成了一堆没人敢动的胶水代码。Agent Reach 把这类访问收敛成一张路由表，覆盖 15 个平台与多后端，按任务意图（搜索、社交、招聘、开发、网页、视频、金融）指向具体的命令文档，避免重复造轮子。

核心机制

路由表：search、social、career、dev、web、video、finance 七类意图分别对应 references/ 下的文档；表外的需求先用 opencli list 查已有适配器，再用 opencli --help 确认公开命令。
体检先行：对小红书、Reddit、B 站、Twitter、Facebook、Instagram 这类需要登录态的平台，动手前先跑 agent-reach doctor --json，按返回的 active_backend 选择命令组。
失败处理：按 references 中记录的重试链处理，而不是猜测命令参数。
调研组合：全网调研任务组合多平台并行采集，例如 Exa 搜索加 Twitter/Reddit 看讨论，再加小红书/B 站看中文场景。
版本自检：完成一次较大的调研后顺手跑 agent-reach check-update，发现新版本只在收尾汇报里提示一条，不中断当前任务，也不重复提醒同一版本。

适用边界与注意点

active_backend: null 只表示 Doctor 没有做实时验证（为避免触发浏览器 Cookie 读取或远端写入），不代表后端不存在；任务明确需要该平台时，按对应 reference 的只读命令手动验证，并以实际非空内容验收。
Twitter 的 Cookie 只供 Doctor 检查配置是否齐全，不会设置当前 Shell。直接运行 twitter 前，必须在子进程环境中显式提供 TWITTER_AUTH_TOKEN 和 TWITTER_CT0，且不得在日志或命令回显中暴露值。
小红书方面，Agent Reach 不替用户登录，也不读取浏览器 Cookie；它依赖用户自己控制的 Chrome 会话，没有现成会话时改用 Cookie-Editor 手工导出后配置存量工具。
发现适配器只证明命令存在，不证明登录态或目标内容可用，所以只在任务明确需要该平台时才执行只读命令。
工作区规则：不要在 agent workspace 创建文件，临时输出放 /tmp/，持久数据放 ~/.agent-reach/。