refactor(skills): merge opencli-generate into opencli-explorer (#891)

* refactor(skills): merge opencli-generate into opencli-explorer

opencli-generate was a thin wrapper over generateVerifiedFromUrl,
essentially an internal pipeline orchestration. Merge its entry point
into opencli-explorer as the automated fast path, keeping one unified
skill for adapter creation.

- Delete skills/opencli-generate/SKILL.md
- Add automated generation tip to opencli-explorer SKILL.md
- Update README/README.zh-CN skill references
- Update skill-generate.ts comment

* fix(docs): fix dead link in yaml-adapter deprecation page

Change ../../CONTRIBUTING.md to ./contributing (VitePress internal link).

Author: jackwener

README.md

@@ -81,7 +81,7 @@ Use OpenCLI directly when you want a reliable command instead of a live browser
 
 Use two different entry points depending on the task:
 
-- [`skills/opencli-generate/SKILL.md`](./skills/opencli-generate/SKILL.md): the task-level entry point for requests like "generate a CLI for this site".
+- [`skills/opencli-explorer/SKILL.md`](./skills/opencli-explorer/SKILL.md): the entry point for creating new adapters — supports both fully automated generation (`opencli generate <url>`) and manual exploration workflows.
 - [`skills/opencli-browser/SKILL.md`](./skills/opencli-browser/SKILL.md): the low-level control surface for live browsing, debugging, and manual intervention.
 
 Install the packaged skills with:
@@ -94,15 +94,14 @@ Or install only what you need:
 
 ```bash
 npx skills add jackwener/opencli --skill opencli-usage
-npx skills add jackwener/opencli --skill opencli-generate
 npx skills add jackwener/opencli --skill opencli-browser
 npx skills add jackwener/opencli --skill opencli-explorer
 npx skills add jackwener/opencli --skill opencli-oneshot
 ```
 
 In practice:
 
-- start with `opencli-generate` when the agent needs a reusable command for a site
+- start with `opencli-explorer` when the agent needs a reusable command for a site (it covers both automated and manual flows)
 - use `opencli-browser` when the agent needs to inspect or steer the page directly
 
 Available browser commands include `open`, `state`, `click`, `type`, `select`, `keys`, `wait`, `get`, `screenshot`, `scroll`, `back`, `eval`, `network`, `init`, `verify`, and `close`.

README.zh-CN.md

@@ -69,7 +69,7 @@ opencli bilibili hot --limit 5
 
 按任务类型，AI Agent 有两个不同入口：
 
-- [`skills/opencli-generate/SKILL.md`](./skills/opencli-generate/SKILL.md)：任务级入口，适合“帮我给这个网站生成 CLI”这类请求。
+- [`skills/opencli-explorer/SKILL.md`](./skills/opencli-explorer/SKILL.md)：适配器创建入口，支持全自动生成（`opencli generate <url>`）和手动探索两种流程。
 - [`skills/opencli-browser/SKILL.md`](./skills/opencli-browser/SKILL.md)：底层控制入口，适合实时操作页面、debug 和人工介入。
 
 安装全部 OpenCLI skills：
@@ -82,15 +82,14 @@ npx skills add jackwener/opencli
 
 ```bash
 npx skills add jackwener/opencli --skill opencli-usage
-npx skills add jackwener/opencli --skill opencli-generate
 npx skills add jackwener/opencli --skill opencli-browser
 npx skills add jackwener/opencli --skill opencli-explorer
 npx skills add jackwener/opencli --skill opencli-oneshot
 ```
 
 实际使用上：
 
-- 需要把某个站点收成可复用命令时，优先走 `opencli-generate`
+- 需要把某个站点收成可复用命令时，优先走 `opencli-explorer`（涵盖自动和手动两种路径）
 - 需要直接检查页面、操作页面时，再走 `opencli-browser`
 
 `browser` 可用命令包括：`open`、`state`、`click`、`type`、`select`、`keys`、`wait`、`get`、`screenshot`、`scroll`、`back`、`eval`、`network`、`init`、`verify`、`close`。

docs/developer/yaml-adapter.md

@@ -2,4 +2,4 @@
 
 > **YAML adapters are no longer supported.** All adapters now use TypeScript with the `cli()` API from `@jackwener/opencli/registry`.
 
-See [Contributing Guide](../../CONTRIBUTING.md) for how to write TypeScript adapters using the pipeline API or `func()`.
+See [Contributing Guide](./contributing) for how to write TypeScript adapters using the pipeline API or `func()`.

skills/opencli-explorer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: opencli-explorer
-description: Use when creating a new OpenCLI adapter from scratch, adding support for a new website or platform, or exploring a site's API endpoints via browser DevTools. Covers API discovery workflow, authentication strategy selection, TS adapter writing, and testing.
-tags: [opencli, adapter, browser, api-discovery, cli, web-scraping, automation]
+description: Use when creating a new OpenCLI adapter from scratch, adding support for a new website or platform, exploring a site's API endpoints via browser DevTools, or when a user asks to automatically generate a CLI for a website (e.g. "帮我生成 xxx.com 的 cli"). Covers automated generation, API discovery workflow, authentication strategy selection, TS adapter writing, and testing.
+tags: [opencli, adapter, browser, api-discovery, cli, web-scraping, automation, generate]
 ---
 
 # CLI-EXPLORER — 适配器探索式开发完全指南
@@ -13,6 +13,10 @@ tags: [opencli, adapter, browser, api-discovery, cli, web-scraping, automation]
 > **只想为一个具体页面快速生成一个命令？** 看 [opencli-oneshot skill](../opencli-oneshot/SKILL.md)（~150 行，4 步搞定）。
 > 本文档适合从零探索一个新站点的完整流程。
 
+> [!TIP]
+> **想要全自动生成？** 直接运行 `opencli generate <url> [--goal <goal>]`，内部会自动走完 explore → synthesize → cascade → verify 全流程。
+> 返回 `SkillOutput`（success / blocked / needs-human-check）。如果自动生成失败或需要人工介入，再按本文档的手动流程继续。
+
 ---
 
 ## AI Agent 开发者必读：用浏览器探索

skills/opencli-generate/SKILL.md

@@ -1,8 +1,8 @@
 /**
- * opencli-generate skill: thin wrapper over generateVerifiedFromUrl.
+ * Generate skill: thin wrapper over generateVerifiedFromUrl.
  *
- * Maps GenerateOutcome → SkillOutput per the skill spec
- * (skills/opencli-generate/SKILL.md).
+ * Maps GenerateOutcome → SkillOutput.
+ * Used by `opencli generate <url>` (automated path in opencli-explorer workflow).
  *
  * Design:
  *   - Input: url + goal? (user intent, not execution strategy)