/resolve-asset-guid

name: resolve-asset-guid
description: |-
  把用户能说出的业务信息（板块/项目/数据源 + 表名/字段名/资产名）拼成资产 GUID，回读校验后交给下游 skill。
  当用户要 GUID、界面查不到 GUID、下游接口要传 Guid/TableGuid/WatchObjectId 时进入。

  触发场景：只知表名却要 GUID（写资产属性/配质量规则/查资产详情/落标）；问 GUID 怎么拼；核对已有 GUID。

  触发词：资产GUID、拼GUID、Guid、TableGuid、dp_table、dp_ds_table、odps.、dp_index、cust_index、biz_index、dp_api、qbi_page。

  关键限制：**开场必问两事（资产类型 + 该类型所需信息），类型不得从名字推断；每段取值须逐段确认后才能拼**，禁止按表名相似外推；含内部ID的类型(dp_index/biz_index/dp_api/qbi_page)只能查；逻辑表第三段是板块名；项目名转小写不加_dev；前缀由引擎定(19种)、表名大小写看引擎；dp_ds_table 段数不定；GUID 错了接口不报错，必须回读校验。

资产 GUID 解析（按类型拼接 + 回读校验）

1. Scenario Description

Dataphin 资产 GUID 是资产的唯一标识，**界面上不直接展示**，但大量 OpenAPI 与子 skill 都以它为入参（`Guid` / `GuidList` / `TableGuid` / `WatchObjectId`）。用户手里通常只有业务信息（"fashion 板块的 dim_lk_cus 表"、"customers 表的 email 字段"），于是卡在第一步。

本 skill 负责这一段转换：**业务信息 → GUID → 回读校验 → 交付**。它是下列子 skill 的前置：

| 下游 skill | 需要的 GUID | |---|---| | [`manage-asset-attributes`](../manage-asset-attributes/SKILL.md) | 覆盖写属性的 `Guid`（TABLE / COLUMN） | | [`query-asset-details`](../query-asset-details/SKILL.md) | 四板块共用的资产 `Guid`、`GuidList` | | [`configure-quality-rule`](../configure-quality-rule/SKILL.md) | `WatchObjectId`（TABLE 类型就是资产 GUID） | | [`manage-standard-mapping`](../manage-standard-mapping/SKILL.md) | 建落标映射的字段 GUID | | [`manage-row-level-permission`](../manage-row-level-permission/SKILL.md) | `get-row-permission-by-table-guids` 的表 GUID |

**Architecture**：`Tenant → (BizUnit | Project | DataSource) → Table → Column`，GUID 就是这条归属链的字符串编码；指标 / API / 仪表板类资产的 GUID 含内部 ID，不在编码链上。

两条路径（选路规则见 §8 Step 1）：

业务信息
  ├─ 路径 A 可拼接：按公式拼 → 回读校验 → 交付
  └─ 路径 B 必须查：搜索接口命中 → 逐条比对选中 → 交付

> 完整公式与段语义见 [`references/guid-composition-matrix.md`](references/guid-composition-matrix.md)；每段从哪个接口取见 [`references/segment-resolution.md`](references/segment-resolution.md)。

2. Installation

aliyun plugin install --names aliyun-cli-dataphin-public

（详见 [`references/cli-installation-guide.md`](references/cli-installation-guide.md)）

3. Environment Variables

> 凭证与环境变量由父 skill `alibabacloud-dataphin-skills` 统一声明并预检（父 §3 + §4 Authentication + §8 Step 0，先于路由到本 skill 执行）；本 skill 不重复声明。

4. Authentication

> **Pre-check: Alibaba Cloud Credentials Required** > > **Security Rules:** > - **NEVER** read, echo, or print AK/SK values > - **NEVER** ask the user to input AK/SK directly in the conversation or command line > - **NEVER** use `aliyun configure set` with literal credential values > - **ONLY** use `aliyun configure list` to check credential status > > ```bash > aliyun configure list > ``` > Check the output for a valid profile (AK, STS, or OAuth identity). > > **If no valid profile exists, STOP here.** > 1. Obtain credentials from [Alibaba Cloud Console](https://ram.console.aliyun.com/manage/ak) > 2. Configure credentials **outside of this session** (via `aliyun configure` in terminal or environment variables in shell profile) > 3. Return and re-run after `aliyun configure list` shows a valid profile

**Pre-check: Aliyun CLI >= 3.3.3 required** > Run `aliyun version` to verify >= 3.3.3. If not installed or version too low, > install/update from https://aliyuncli.alicdn.com (see [`references/cli-installation-guide.md`](references/cli-installation-guide.md) for the OS-specific script).

**Pre-check: Aliyun CLI plugin update required** > [MUST] run `aliyun configure set --auto-plugin-install true` to enable automatic plugin installation. > [MUST] run `aliyun plugin update` to ensure that any existing plugins are always up-to-date.

5. RAM Policy

最小权限策略详见套件级 [`../../ram-policies.md`](../../ram-policies.md)（子 skill 不自带，统一收口套件级文件）。本 skill 全部为只读 Action。

> **[MUST] Permission Failure Handling:** When any command or API call fails due to permission errors at any point during execution, follow this process: > 1. Read `../../ram-policies.md` to get the full list of permissions required by this SKILL > 2. Use `ram-permission-diagnose` skill to guide the user through requesting the necessary permissions > 3. Pause and wait until the user confirms that the required permissions have been granted

6. Parameter Confirmation

> **IMPORTANT: Parameter Confirmation** — Before executing any command or API call, > ALL user-customizable parameters (e.g., RegionId, instance names, CIDR blocks, > passwords, domain names, resource specifications, etc.) MUST be confirmed with the > user. Do NOT assume or use default values without explicit user approval.

| 参数 | 必填 | 描述 | 默认值 | |---|---|---|---| | `OpTenantId` | 是 | 操作租户 ID（19 位 snowflake，**字符串传**） | — | | 资产类型 | 是 | 逻辑表 / 项目内物理对象 / 实时元表 / 镜像表 / 标签表 / 数据源表 / DataWorks 采集表 / 字段 / 各类指标 / API / 仪表板 | 不得默认，见 Step 0 | | 归属对象 | 视类型 | 数据板块名（逻辑表）/ 项目名 + 引擎（项目内对象）/ 数据源名或 ID + schema（数据源表）/ DataWorks 空间 id + 数据源 id + 逻辑 Schema（DataWorks 采集表） | — | | 资产名 | 是 | 表名 / 字段名 / 指标名 / API 名 / 仪表板名 | — | | 环境 | 视类型 | `DEV` / `PROD`（同名表两环境各有独立 GUID；`dp_index.` GUID 自带环境段） | 不得默认，须与用户确认 |

★ [硬规则] 开场两个必问，不许猜

收到“给我 xxx 的 GUID”时，**先问两件事，问完再动手**（用 AskUserQuestion，一次问完）：

1. **这是什么类型的表 / 资产？** —— 选项：逻辑表 / 项目内物理表·视图·物化视图 / 实时元表 / 镜像表 / 标签表 / 数据源表 / DataWorks 采集表 / 字段 / 指标 / API / 仪表板。 2. **该类型 GUID 需要的具体信息**（照 §0.2 清单逐项列出，已知的标已有、未知的直接要）。

**四条绝对禁止**：

1. **禁止从名称形态推断类型**。看到 `LD_xxx.表名` 不得当逻辑表、看到 `a.b` 不得当 schema.表 或 项目.表、看到 `dim_`/`dws_`/`_tmp` 不得推表类型。实测：`dws_ai_ready_insight` 同时是 MaxCompute 项目表与 Doris 数据源表；`load_test.orders` 同时存在于两个 StarRocks 数据源。 2. **禁止用“表名相似”外推任何段**。`all_type0123` 与 `all_type` 名字相近，**不构成**它们同数据源 / 同空间 / 同 schema 的任何证据。 3. **禁止把“照抄同数据源已有表中段”当默认路径**。照抄的前提是用户已确认目标表与模板表**同源同 schema**；未确认就照抄 = 猜。 4. **禁止在有任何一段未确认时输出 GUID 全文**。可以输出段值确认表并标出缺哪一段，但不得给出一条可直接复制的完整串。

> **反查的定位边界**：反查（`list-tables` 等）只能用来① 校验用户已确认的信息、② 在类型与归属已定后取真值、③ 命中多条时**列候选让用户选**。它**不能**用来替用户断定“这是哪一类资产”或“你要的就是这条”。

★ [硬规则] 提问与列候选必须用业务语言，不能拿 ID 让用户选

问的时候**直接问缺的那样东西**，用用户在界面上看得到的名字：

| 场景 | ✅ 应该这么问 | ❌ 不要这么问 | |---|---|---| | 数据源歧义 | “**数据源是哪一个？**” + 列出 `数据源名(编码)`，如 `数据服务API行级权限_数据源(ds_demo)` | “选 A 还是 B”、或直接摆两串 19 位 `dataSourceId` | | 项目歧义 | “**哪个项目？**” + 列项目名（必要时注明