mcpField
O
opencli-usage

opencli-usage

github.com/jackwenerAgent 工作流30.7k21.1k 次安装2 天前更新
代码仓库

关于 opencli-usage

opencli-usage 是指导 Agent 使用 OpenCLI 的技能。它介绍命令搜索、浏览器会话、网站适配器、插件、认证与守护进程管理,并说明 JSON 输出和错误处理。

主要功能

  1. 01搜索和分页浏览命令
  2. 02查看命令帮助与输出格式
  3. 03管理 Chrome 浏览器会话
  4. 04初始化和测试网站适配器
  5. 05管理插件、认证和守护进程

适用场景

  1. 01查找适用于网站的 CLI 命令
  2. 02连接 Chrome 并检查浏览器状态
  3. 03测试网站适配器命令
  4. 04诊断认证或桥接进程状态

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jackwener/opencli --skill opencli-usage

安装后在 Claude Code 中输入/opencli-usage确认已加载。

详细介绍

OpenCLI

OpenCLI 向 Agent 提供可复用的网站适配器和直接调用 Chrome 的工具。

opencli list search
opencli list --site github --limit 20
opencli github search --help -f json

list [query] 会搜索内置工具和适配器中的命令名称与描述。 结果简洁且支持分页:{ok:true,data:{commands,total,nextOffset?}}。 传入 --offset <nextOffset> 可继续查看。使用命令帮助查看确切的输入参数。 不要对适配器目录进行硬编码,也不要将所有命令都输出到上下文中。

结果

命令默认以 JSON 格式输出:{ok:true,data:...}。执行失败会返回非零退出代码, 并在 stdout 上输出 {ok:false,error:{code,message,hint?,...}}。日志使用 stderr。 命令帮助中列出的命令支持显式使用 -f table|yaml|csv|md|plain 导出。 帮助、版本、补全和显式的 plain 导出会保留各自的格式。 浏览器跟随模式会逐行输出一个 JSON 封装。

使用错误代码和提供的候选项/键进行恢复。写入结果未知时,必须先检查状态再重复操作。 成功但结果为空与执行失败是两种不同情况。

浏览器

opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser close --session research
opencli browser chrome describe

页面命令使用 --session;原生 Chrome 方法无需会话。--profile 用于选择已连接的 Chrome 配置文件。使用 profile list 查找配置文件, 并使用 profile use <name> 设置默认配置文件。使用 doctor 诊断连接问题。 有关交互、API 证据和标签页/分组管理,请参阅 opencli-browser。

适配器和安装

opencli adapter init example/search
opencli adapter check example/search
opencli adapter test example/search --args '{"query":"hello"}'
opencli adapter status

有关实现方法,请参阅 opencli-adapter-author。adapter eject 可将官方站点适配器设为可在本地编辑; adapter reset 会移除本地覆盖。适配器测试会执行真实命令,也可能执行写入操作。

plugin list|install|update|uninstall|create 用于管理插件包。auth status 会报告网站登录状态;auth refresh 会刷新会话。daemon status|restart|stop 用于管理桥接进程。请查阅所选功能的帮助。

通过 skills list 和 skills read opencli-browser -f plain 可以查看随附的技能内容(省略 -f plain 时输出 JSON)。

评论

支持 Markdown