AI Skill 大全

OpenCLI 适配器自动修复

opencli 命令因站点改版报错时,读诊断信息定位根因、改 adapter 源码并重试,验证通过后再提 issue 到上游。

功能与用途

平时能用的 opencli 命令突然抓不到数据或找不到元素,多半是网站改了 DOM、接口或响应结构。它会先排除「空数据不等于坏了」的情况(换个关键词、看 Chrome 里是否正常、识别软 404),确认是代码问题后再用 OPENCLI_DIAGNOSTIC=1 拿到诊断 JSON,按错误码分类原因,用 opencli browser 现场探查新版页面,只改 RepairContext 指定的那一个 adapter 文件并重试,最多三轮。前提是装好 opencli、gh CLI 并登录。

适用场景

  • DOM 变更元素缺失修复:网站改版导致选择器失效报 SELECTOR 错误时,现场探查新 DOM 并更新适配器中的元素定位。
  • 接口字段变动调试:网络请求路径或返回数据格式变更导致空结果时,拦截分析接口网络包并重写解析提取逻辑。
  • 加载等待与超时修复:目标页面增加懒加载或加载逻辑变更导致超时时,动态调整适配器的等待条件与状态判断。

适用人群

  • 维护 opencli 适配器的开发者
  • 依赖 opencli 抓数但站点一改版就断的自动化工程师
  • 开源 CLI 项目的维护者

使用步骤

  1. 先确认失败不是假故障:换关键词或换入口重试、在正常 Chrome 标签页里看数据是否可见、识别软 404,只有多次复现才进入修复。
  2. 跑 OPENCLI_DIAGNOSTIC=1 opencli <site> <command> 2>diagnostic.json,从标记之间解析出 RepairContext JSON。
  3. 读诊断里的 error 码、adapter 源码和页面快照,按 SELECTOR / EMPTY_RESULT / API_ERROR / TIMEOUT / PAGE_CHANGED 分类根因。
  4. 用 opencli browser open、state、click、network 现场探查新版页面,只修改 RepairContext.adapter.sourcePath 指向的那一个文件,保持 columns 和返回结构不变。
  5. 正常模式重跑命令验证,通过后再提交上游 GitHub issue;三轮修不好就停下汇报已尝试的内容。

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
专业
版本
main
最近更新
2026-09-14
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through diagnosing the failure via OPENCLI_DIAGNOSTIC, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.

使用前准备

  • 已安装 opencli 且 opencli doctor 通过,Chrome 已登录目标站点
  • 如需提 issue 还需安装并登录 gh CLI。

依赖与权限

  • 读取用户主动提供的内容

同类 Skill