Agent Skills
返回列表
🤖

智能体远程控制台

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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-3001 Twitter 缺 undici 依赖、AR-3002 B 站 IP 被封需配代理、AR-3003 Reddit 被限流、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 与产物路径做回归判断。