智能体远程控制台
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2fd890c9/agent-reach-20260801,然后把该技能接入 WorkBuddy 以便调用 Agent-Reach 的 CLI。
技能介绍
要解决的问题
Agent-Reach 的能力原本散落在 GitHub 仓库的 README 和命令行里:你得先自己判断仓库有没有 clone、依赖装没装好、某个报错到底该改代理还是改 User-Agent。这个技能把「从零到跑通一条命令」的流程固定下来,让 Agent 在本地直接调用 ./main,而不是每次靠猜去复现安装问题。
核心能力
- 部署与更新:仓库不存在时完整 clone 到
$HOME/tools/Agent-Reach;已存在则git pull拉到最新,随后按requirements.txt补齐缺失依赖。 - CLI 调用:透传参数给入口脚本,如
./main --help、./main run --config config.yaml、./main list-models。用户没给参数时先回 help,避免盲跑。 - 结果回传:统一返回
stdout、stderr、退出码;若命令产出了报告或文件,额外返回路径列表(如$HOME/tools/Agent-Reach/output/result.json)。 - 失败诊断:分阶段捕获日志——clone 失败先
ping github.com查网络与仓库权限;pip install失败返回错误日志末 20 行;./main非零退出时汇总stderr并建议加--verbose;执行超过 120 秒强制终止并回传已有输出。
错误码与 FAQ
文档内置结构化错误码,替代纯自然语言的 Troubleshooting:
- 通用类:
AR-1001输入非法、AR-1002超时、AR-1003认证失败(检查AGENT_REACH_API_KEY)、AR-1004频率限制、AR-1005网络异常(跑agent-reach doctor)、AR-2001平台不可用、AR-2002代理配置错误(看~/.agent-reach/config.yaml)。 - 平台类:
AR-3001Twitter 缺undici依赖、AR-3002B 站 IP 被封需配代理、AR-3003Reddit 被限流、AR-3004微信内容抓取需--engine camoufox。
配套 FAQ.md 按场景给出症状、根因、解法与预防措施,可用 agent-reach faq --keyword "403" 检索。
适用边界
前置条件是本机有 git、Python 3.8+、pip,且能访问 github.com。它只负责把 Agent-Reach 拉起来并执行命令,不改写仓库代码,也不替目标平台管理账号与 Cookie。超时上限固定 120 秒,长任务请自行缩小输入规模或改由定时任务驱动。
使用场景
- 首次接入时本地没有 Agent-Reach 仓库,需要自动 clone 到 $HOME/tools/Agent-Reach、装好依赖并验证入口 ./main 可执行。
- 准备执行 ./main run --config config.yaml 抓取任务,但不确定必填参数,先跑 ./main --help 确认选项再填参。
- pip install 退出码非 0,需要技能返回完整安装日志末段,定位是哪个依赖缺失或哪条命令报错。
- 某次 ./main 调用超过 120 秒仍无响应,需要强制终止进程并拿回已产生的部分输出,判断是卡在网络上还是任务规模。
适合人员
- 负责把开源 Agent-Reach 接入内部 Agent 平台的后端工程师:不想再手写 clone、装依赖、捕获日志的胶水代码。
- 常跑多平台抓取、偶尔被 B 站封 IP 或 Twitter 限流拦下的数据工程师:想按 AR-3002 / AR-3004 等错误码快速找解法。
- 在 WorkBuddy 里给 Agent 编排工具链的技术负责人:要求技能稳定执行,失败时能给出结构化的退出码与日志路径。
- 要把脚本化任务做到可复现、可交接的自动化测试工程师:想靠明确的退出码、stdout/stderr 与产物路径做回归判断。