@clickzetta/cz-cli-darwin-x64 0.3.39 → 0.3.41

package/bin/skills/clickzetta-kafka-ingest-pipeline/SKILL.md

@@ -16,6 +16,37 @@ description: |
 
 # Kafka 数据接入管道工作流
 
+## 向导：收集必要信息
+
+开始搭建 Kafka 管道前，优先使用交互式问答工具（如 `question`）收集以下信息并弹出选项菜单；若无此类工具，则用文字一次性列出所有问题：
+
+```
+question({
+  questions: [
+    {
+      question: "Kafka 消息格式？",
+      options: [
+        { label: "JSON（简单结构）", description: "顶层字段直接映射" },
+        { label: "JSON（嵌套结构）", description: "需要 JSONPath 解析嵌套字段" },
+        { label: "CSV", description: "逗号分隔文本" },
+        { label: "Avro / 其他", description: "需要额外配置" }
+      ]
+    },
+    {
+      question: "接入路径？",
+      options: [
+        { label: "READ_KAFKA Pipe（推荐）", description: "通用场景，支持复杂 SQL 转换" },
+        { label: "Kafka 外部表 + Table Stream", description: "需要保留原始消息或多个下游消费同一 Topic" }
+      ]
+    }
+  ]
+})
+```
+
+**如果用户已经提供了足够信息，直接进入工作流，不再弹出菜单。**
+
+---
+
 ## 适用场景
 
 - 将 Kafka Topic 数据持续导入 ClickZetta Lakehouse 表
@@ -39,29 +70,18 @@ description: |
 - Kafka 集群网络可达（确认 bootstrap 地址和端口）
 - 已知 Kafka Topic 名称和消息格式
 - 认证信息（如需要）：SASL 用户名/密码
-- **执行环境（满足其一即可，优先使用 cz-cli）**：
-  - **cz-cli 路径**：已安装 cz-cli（`pip install cz-cli`），并完成 `cz-cli configure` 配置
-  - **MCP 路径**：clickzetta-mcp-server 工具可用（`LH_execute_query`、`LH_show_object_list` 等）
+- **执行环境**：已安装并配置 cz-cli
 
-## 环境探测（执行前必读）
+## 执行环境
 
-在开始任何操作前，先判断当前执行环境：
+所有 SQL 通过 `cz-cli sql` 执行：
 
-**第一步：检测 cz-cli 是否可用**
 ```bash
-cz-cli --version
+cz-cli --version   # 确认 cz-cli 可用
+cz-cli sql "SELECT 1" --sync   # 验证连接
 ```
-- 若命令存在 → **走 cz-cli 路径**（见本文档末尾"cz-cli 替代路径"章节）
-- 若命令不存在 → 继续检测 MCP
-
-**第二步：检测 MCP 是否可用（仅在 cz-cli 不可用时）**
 
-尝试调用 `LH_execute_query` 工具执行一条简单 SQL（如 `SELECT 1`）。
-- 若工具存在于 tool list → **走 MCP 路径**（本文档默认路径）
-- 若工具不存在 → 停止执行，提示用户：
-  > "当前环境既无 cz-cli 也无 MCP 工具，请安装其中之一后重试。
-  > cz-cli 安装：`pip install cz-cli`，然后运行 `cz-cli configure`
-  > MCP 安装：参考 clickzetta-mcp-server 配置文档"
+需要 cz-cli，请参考官方文档安装并完成配置后重试。
 
 ## ⚠️ 关键注意事项
 
@@ -663,10 +683,8 @@ COPY INTO ods.secure_events FROM (
 
 ---
 
-## cz-cli 替代路径
+## cz-cli 执行路径
 
-> 仅在 cz-cli 可用且 MCP 不可用时使用本节。步骤编号与上方 MCP 路径对应。
-> 所有操作通过 `cz-cli agent run` 委托给内置 agent 完成，agent 内置完整的 MCP 工具访问能力。
 
 ### 路径一：READ_KAFKA Pipe（cz-cli 版）
 

package/bin/skills/clickzetta-metadata/SKILL.md

@@ -1,40 +1,39 @@
 ---
 name: clickzetta-metadata
 description: |
-  查询 ClickZetta Lakehouse 元数据，覆盖两种查询方式：
-  1. SHOW/DESC 命令族（实时，无延迟）：快速查看当前对象状态，适合单个对象的即时查询
-  2. INFORMATION_SCHEMA 视图（约 15 分钟延迟，支持复杂 SQL 分析）：适合聚合统计、费用归因、跨对象分析
-
-  选择原则：
-  - 快速查看单个对象（表结构、字段、集群状态、权限）→ SHOW/DESC
-  - 复杂 SQL 分析、费用归因、跨空间统计、历史趋势 → information_schema
-
-  覆盖所有 SHOW 命令（TABLES/SCHEMAS/CATALOGS/COLUMNS/VOLUMES/CONNECTIONS/JOBS/VCLUSTERS/
-  PIPES/SHARES/USERS/ROLES/GRANTS/FUNCTIONS/TABLE STREAMS/PARTITIONS/SYNONYMS/INDEX/
-  DYNAMIC TABLE REFRESH HISTORY/TABLES HISTORY），所有 DESC 命令（TABLE/SCHEMA/HISTORY/
-  VCLUSTER/VOLUME/CONNECTION/FUNCTION/VIEW/DYNAMIC TABLE/SHARE/INDEX/TABLE STREAM），
-  SHOW CREATE TABLE，load_history()，FROM (SHOW ...) 子查询，上下文函数，
-  以及 INFORMATION_SCHEMA 空间级和实例级视图（TABLES/COLUMNS/JOB_HISTORY/USERS/ROLES/
-  VOLUMES/CONNECTIONS/MATERIALIZED_VIEW_REFRESH_HISTORY/STORAGE_METERING/INSTANCE_USAGE 等）。
-
-  当用户说"查看表列表"、"查看字段"、"查看字段信息"、"查看作业"、"查看作业历史"、
-  "查看 JOB 历史"、"SHOW TABLES"、"DESC TABLE"、"查看分区"、"查看历史版本"、
-  "查看删除的表"、"查看导入历史"、"load_history"、"SHOW JOBS"、"查看集群状态"、
-  "查看连接"、"查看权限"、"SHOW GRANTS"、"查看函数"、"查看 Volume"、
-  "查看 Volume 列表"、"查看 Share"、"查看 Catalog"、"查看慢查询"、
-  "查看 CRU 消耗"、"费用分析"、"成本分析"、"计算费用"、"存储费用"、
-  "用量统计"、"成本归因"、"哪个用户消耗最多"、"存储用量排行"、
-  "查看用户列表"、"查看角色"、"查看 Connection"、"查看物化视图刷新历史"、
-  "元数据查询"、"information_schema"、"查看所有表"、"查看 Schema 列表"、
-  "统计存储用量"、"SHOW/DESC 和 information_schema 哪个更快"时触发。
-
-  注意：本 skill 仅覆盖元数据的只读查询（SHOW/DESC/information_schema）。
-  权限变更（GRANT/REVOKE/创建用户/角色管理/数据脱敏）请使用 clickzetta-access-control skill。
-  Keywords: SHOW, DESC, DESCRIBE, metadata, load_history, information_schema, table info, column info, job history, system view, cost analysis, CRU
+  查询 ClickZetta Lakehouse 元数据，覆盖两种方式：
+  SHOW/DESC 命令族（实时，适合单个对象即时查询）和
+  INFORMATION_SCHEMA 视图（支持复杂 SQL 分析、费用归因、跨对象统计）。
+  当用户说"查看表列表"、"查看字段"、"查看作业历史"、"SHOW TABLES"、
+  "DESC TABLE"、"查看分区"、"查看权限"、"SHOW GRANTS"、"查看 Volume"、
+  "费用分析"、"成本归因"、"用量统计"、"元数据查询"、"information_schema"时触发。
+  注意：本 skill 仅覆盖只读元数据查询；权限变更请使用 clickzetta-access-control。
+  Keywords: SHOW, DESC, metadata, load_history, information_schema, job history, cost analysis, CRU
 ---
 
 # ClickZetta 元数据查询指南
 
+## 执行方式
+
+所有 SQL 通过 `cz-cli sql` 执行，无需 MCP 工具。
+
+**执行示例：**
+
+```bash
+# 执行 SHOW/DESC 查询
+cz-cli sql "SHOW TABLES" --sync -o table
+
+# 执行 information_schema 查询
+cz-cli sql "SELECT * FROM information_schema.tables LIMIT 10" --sync -o table
+
+# 执行 load_history 查询
+cz-cli sql "SELECT * FROM load_history('my_schema.my_table') LIMIT 20" --sync -o table
+```
+
+注意：`--sync` 等待结果返回；`-o table` 输出为表格格式便于阅读。
+
+---
+
 ## 选择查询方式
 
 | 场景 | 推荐方式 | 原因 |
@@ -51,6 +50,26 @@ description: |
 
 ---
 
+## 支持的命令与视图全览
+
+**SHOW 命令**：TABLES / SCHEMAS / CATALOGS / COLUMNS / VOLUMES / CONNECTIONS / JOBS / VCLUSTERS /
+PIPES / SHARES / USERS / ROLES / GRANTS / FUNCTIONS / TABLE STREAMS / PARTITIONS / SYNONYMS / INDEX /
+DYNAMIC TABLE REFRESH HISTORY / TABLES HISTORY
+
+**DESC 命令**：TABLE / SCHEMA / HISTORY / VCLUSTER / VOLUME / CONNECTION / FUNCTION / VIEW /
+DYNAMIC TABLE / SHARE / INDEX / TABLE STREAM
+
+**其他**：SHOW CREATE TABLE、load_history()、FROM (SHOW ...) 子查询、上下文函数
+
+**INFORMATION_SCHEMA 视图**（空间级）：TABLES / COLUMNS / JOB_HISTORY / USERS / ROLES /
+VOLUMES / CONNECTIONS / MATERIALIZED_VIEW_REFRESH_HISTORY / AUTOMV_REFRESH_HISTORY / SORTKEY_CANDIDATES
+
+**INFORMATION_SCHEMA 视图**（实例级，需 INSTANCE ADMIN）：WORKSPACES / SCHEMAS / TABLES / COLUMNS /
+VIEWS / USERS / ROLES / JOB_HISTORY / VOLUMES / CONNECTIONS / OBJECT_PRIVILEGES /
+STORAGE_METERING / INSTANCE_USAGE
+
+---
+
 ## 参考文档
 
 - [SHOW/DESC 完整语法](references/show-desc-reference.md)
@@ -138,7 +157,7 @@ SHOW VCLUSTERS WHERE state = 'RUNNING';
 
 -- 作业（最近 7 天，最多 10000 条，不支持 ORDER BY）
 SHOW JOBS LIMIT 20;
-SHOW JOBS IN VCLUSTER default_ap LIMIT 20;
+SHOW JOBS IN VCLUSTER default LIMIT 20;
 
 -- 动态表刷新历史（最近 7 天）
 SHOW DYNAMIC TABLE REFRESH HISTORY LIMIT 20;
@@ -169,7 +188,7 @@ SHOW SHARES;
 DESC my_table;
 DESC EXTENDED my_table;          -- 含 last_modified_time/properties/statistics
 DESC SCHEMA my_schema;
-DESC VCLUSTER default_ap;
+DESC VCLUSTER default;
 DESC VOLUME my_volume;
 DESC CONNECTION my_oss_conn;
 DESC FUNCTION my_schema.my_function;  -- 仅支持外部函数

package/bin/skills/clickzetta-monitoring/SKILL.md

@@ -13,6 +13,22 @@ description: |
   Keywords: monitoring, job status, performance, resource usage, SHOW JOBS, slow query
 ---
 
+## 执行方式
+
+所有 SQL 通过 `cz-cli sql` 执行，无需 MCP 工具：
+
+```bash
+# 执行查询
+cz-cli sql "SHOW JOBS LIMIT 20" --sync -o table
+
+# 执行 information_schema 查询
+cz-cli sql "SELECT * FROM information_schema.job_history WHERE pt_date >= CAST(CURRENT_DATE - INTERVAL 1 DAY AS DATE) LIMIT 10" --sync -o table
+```
+
+注意：`--sync` 等待结果返回；`-o table` 输出为表格格式便于阅读。
+
+---
+
 # ClickZetta 作业监控与分析
 
 阅读 [references/show-jobs.md](references/show-jobs.md) 了解 SHOW JOBS 语法。
@@ -27,7 +43,7 @@ description: |
 SHOW JOBS;
 
 -- 查看指定集群的作业
-SHOW JOBS IN VCLUSTER default_ap;
+SHOW JOBS IN VCLUSTER default;
 
 -- 查看执行时间超过2分钟的慢查询
 SHOW JOBS WHERE execution_time > INTERVAL 2 MINUTE;
@@ -36,7 +52,7 @@ SHOW JOBS WHERE execution_time > INTERVAL 2 MINUTE;
 SHOW JOBS WHERE status = 'FAILED';
 
 -- 限制返回数量
-SHOW JOBS IN VCLUSTER default_ap LIMIT 50;
+SHOW JOBS IN VCLUSTER default LIMIT 50;
 ```
 
 ---

package/bin/skills/clickzetta-monitoring/references/show-jobs.md

@@ -24,10 +24,10 @@ SHOW JOBS [IN VCLUSTER vc_name] [LIKE 'pattern'] [WHERE <expr>] [LIMIT num];
 SHOW JOBS;
 
 -- 查看指定集群的作业
-SHOW JOBS IN VCLUSTER default_ap;
+SHOW JOBS IN VCLUSTER default;
 
 -- 查看执行时间超过2分钟的作业
-SHOW JOBS IN VCLUSTER default_ap WHERE execution_time > INTERVAL 2 MINUTE;
+SHOW JOBS IN VCLUSTER default WHERE execution_time > INTERVAL 2 MINUTE;
 
 -- 限制返回100条
 SHOW JOBS LIMIT 100;

package/bin/skills/clickzetta-oss-ingest-pipeline/SKILL.md

@@ -13,6 +13,45 @@ description: |
 
 # 对象存储数据管道搭建工作流
 
+## 向导：收集必要信息
+
+开始搭建对象存储管道前，优先使用交互式问答工具（如 `question`）收集以下信息并弹出选项菜单；若无此类工具，则用文字一次性列出所有问题：
+
+```
+question({
+  questions: [
+    {
+      question: "云平台？",
+      options: [
+        { label: "阿里云 OSS", description: "支持 LIST_PURGE 和 EVENT_NOTIFICATION 两种模式" },
+        { label: "AWS S3", description: "支持 LIST_PURGE 和 EVENT_NOTIFICATION 两种模式" },
+        { label: "腾讯云 COS", description: "仅支持 LIST_PURGE 模式" }
+      ]
+    },
+    {
+      question: "导入模式？",
+      options: [
+        { label: "持续导入（PIPE）", description: "新文件自动触发导入，近实时" },
+        { label: "批量一次性导入", description: "手动或定时执行 COPY INTO" }
+      ]
+    },
+    {
+      question: "文件格式？",
+      options: [
+        { label: "CSV", description: "逗号分隔文本" },
+        { label: "JSON / JSONL", description: "JSON 或换行分隔 JSON" },
+        { label: "Parquet", description: "列式存储格式" },
+        { label: "ORC", description: "列式存储格式" }
+      ]
+    }
+  ]
+})
+```
+
+**如果用户已经提供了足够信息，直接进入工作流，不再弹出菜单。**
+
+---
+
 ## 适用场景
 
 - 从对象存储（阿里云 OSS / AWS S3 / 腾讯云 COS）持续自动导入数据到 Lakehouse（PIPE 模式）
@@ -26,29 +65,18 @@ description: |
 
 - ClickZetta Lakehouse 账户，具备创建 PIPE、表、存储连接、Volume 等权限
 - 对象存储桶可达（Endpoint、AccessKey 或 Role ARN）
-- **执行环境（满足其一即可，优先使用 cz-cli）**：
-  - **cz-cli 路径**：已安装 cz-cli（`pip install cz-cli`），并完成 `cz-cli configure` 配置
-  - **MCP 路径**：clickzetta-mcp-server 工具可用（`LH_execute_query`、`LH_show_object_list` 等）
+- **执行环境**：已安装并配置 cz-cli
 
-## 环境探测（执行前必读）
+## 执行环境
 
-在开始任何操作前，先判断当前执行环境：
+所有 SQL 通过 `cz-cli sql` 执行：
 
-**第一步：检测 cz-cli 是否可用**
 ```bash
-cz-cli --version
+cz-cli --version   # 确认 cz-cli 可用
+cz-cli sql "SELECT 1" --sync   # 验证连接
 ```
-- 若命令存在 → **走 cz-cli 路径**（见本文档末尾"cz-cli 替代路径"章节）
-- 若命令不存在 → 继续检测 MCP
 
-**第二步：检测 MCP 是否可用（仅在 cz-cli 不可用时）**
-
-尝试调用 `LH_execute_query` 工具执行一条简单 SQL（如 `SELECT 1`）。
-- 若工具存在于 tool list → **走 MCP 路径**（本文档默认路径）
-- 若工具不存在 → 停止执行，提示用户：
-  > "当前环境既无 cz-cli 也无 MCP 工具，请安装其中之一后重试。
-  > cz-cli 安装：`pip install cz-cli`，然后运行 `cz-cli configure`
-  > MCP 安装：参考 clickzetta-mcp-server 配置文档"
+需要 cz-cli，请参考官方文档安装并完成配置后重试。
 
 ## 核心概念
 
@@ -82,7 +110,7 @@ cz-cli --version
 #### 步骤 1：创建存储连接（Storage Connection）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 -- 密钥方式（LIST_PURGE 模式支持）
 CREATE STORAGE CONNECTION IF NOT EXISTS my_oss_connection
   TYPE OSS
@@ -102,7 +130,7 @@ CREATE STORAGE CONNECTION IF NOT EXISTS my_oss_connection
 #### 步骤 2：创建外部 Volume
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE EXTERNAL VOLUME IF NOT EXISTS pipe_volume
   LOCATION 'oss://my-bucket/data-path/'
   USING CONNECTION my_oss_connection
@@ -121,7 +149,7 @@ CREATE EXTERNAL VOLUME IF NOT EXISTS pipe_volume
 在创建 PIPE 之前，先用 COPY INTO 验证数据能正常加载：
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 COPY INTO my_schema.target_table
 FROM VOLUME pipe_volume
 USING CSV OPTIONS ('header' = 'true', 'delimiter' = ',') PURGE=true;
@@ -134,7 +162,7 @@ USING CSV OPTIONS ('header' = 'true', 'delimiter' = ',') PURGE=true;
 #### 步骤 4：创建 PIPE（LIST_PURGE 模式）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE PIPE IF NOT EXISTS my_oss_pipe
   INGEST_MODE = 'LIST_PURGE'
   VIRTUAL_CLUSTER = 'my_vc'
@@ -168,7 +196,7 @@ USING CSV OPTIONS ('header' = 'true') PURGE=true;
 #### 步骤 5：验证 PIPE 状态
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 DESC PIPE EXTENDED my_oss_pipe;
 ```
 
@@ -190,7 +218,7 @@ DESC PIPE EXTENDED my_oss_pipe;
 #### 步骤 1：创建存储连接（Role ARN 方式）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE STORAGE CONNECTION IF NOT EXISTS my_oss_role_connection
   TYPE OSS
   ENDPOINT = 'oss-cn-hangzhou.aliyuncs.com'
@@ -201,7 +229,7 @@ CREATE STORAGE CONNECTION IF NOT EXISTS my_oss_role_connection
 #### 步骤 2：创建外部 Volume
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE EXTERNAL VOLUME IF NOT EXISTS pipe_event_volume
   LOCATION 'oss://my-bucket/data-path/'
   USING CONNECTION my_oss_role_connection
@@ -212,7 +240,7 @@ CREATE EXTERNAL VOLUME IF NOT EXISTS pipe_event_volume
 #### 步骤 3：创建 PIPE（EVENT_NOTIFICATION 模式）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE PIPE IF NOT EXISTS my_oss_event_pipe
   INGEST_MODE = 'EVENT_NOTIFICATION'
   VIRTUAL_CLUSTER = 'my_vc'
@@ -245,7 +273,7 @@ USING CSV;
 #### 步骤 1：创建目标表
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE TABLE IF NOT EXISTS my_schema.target_table (
   id STRING,
   name STRING,
@@ -257,7 +285,7 @@ CREATE TABLE IF NOT EXISTS my_schema.target_table (
 #### 步骤 2：创建存储连接（access_id/access_key 语法）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE STORAGE CONNECTION IF NOT EXISTS my_batch_conn
   TYPE OSS
   ENDPOINT = 'oss-cn-shanghai-internal.aliyuncs.com'
@@ -273,7 +301,7 @@ CREATE STORAGE CONNECTION IF NOT EXISTS my_batch_conn
 #### 步骤 3：创建外部 Volume（启用目录自动刷新）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 CREATE EXTERNAL VOLUME IF NOT EXISTS my_batch_volume
   LOCATION 'oss://my-bucket/data-path/'
   USING CONNECTION my_batch_conn
@@ -293,7 +321,7 @@ CREATE EXTERNAL VOLUME IF NOT EXISTS my_batch_volume
 #### 步骤 4a：INSERT INTO 从 Volume 导入（支持过滤转换）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 INSERT INTO my_schema.target_table
 SELECT * FROM VOLUME my_batch_volume (
   id STRING,
@@ -315,7 +343,7 @@ WHERE amount > 0;
 #### 步骤 4b：COPY INTO 从 Volume 导入（简洁语法）
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 COPY INTO my_schema.target_table
 FROM VOLUME my_batch_volume (
   id STRING,
@@ -334,7 +362,7 @@ FROM VOLUME my_batch_volume (
 #### 步骤 5：验证导入结果
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 SELECT COUNT(*) AS total_rows FROM my_schema.target_table;
 SELECT * FROM my_schema.target_table LIMIT 10;
 ```
@@ -346,7 +374,7 @@ SELECT * FROM my_schema.target_table LIMIT 10;
 ### 查看 PIPE 详细状态
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 DESC PIPE EXTENDED my_oss_pipe;
 ```
 
@@ -359,7 +387,7 @@ DESC PIPE EXTENDED my_oss_pipe;
 ### 查看加载历史
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 SELECT * FROM load_history('my_schema.target_table')
 ORDER BY last_load_time DESC
 LIMIT 20;
@@ -372,7 +400,7 @@ LIMIT 20;
 PIPE 执行的作业会自动打上 `query_tag`，格式为：`pipe.<workspace_name>.<schema_name>.<pipe_name>`
 
 ```sql
--- 使用 LH_execute_query 执行
+-- 通过 cz-cli sql "<SQL>" --sync 执行
 -- 在 JOBS 列表中过滤 PIPE 相关作业
 SHOW JOBS WHERE query_tag = 'pipe.my_workspace.my_schema.my_oss_pipe';
 ```
@@ -450,10 +478,7 @@ DROP PIPE IF EXISTS my_oss_pipe;
 
 ---
 
-## cz-cli 替代路径
-
-> 仅在 cz-cli 可用且 MCP 不可用时使用本节。步骤编号与上方 MCP 路径对应。
-> 所有操作通过 `cz-cli agent run` 委托给内置 agent 完成，agent 内置完整的 MCP 工具访问能力。
+## cz-cli 执行路径
 
 ### 模式 A：LIST_PURGE 扫描模式（cz-cli 版）