/query-asset-details

name: query-asset-details
description: |-
  一站式拼出资产目录里一个资产的完整详情页，**覆盖 5 类资产**：表（属性/字段/使用说明 + 数据预览 + 表与字段血缘 + 质量概况）、技术指标（属性 + 数据预览 + 所属字段血缘 + 所属字段质量规则）、业务指标（属性 + 相关指标 + 使用说明）、数据服务 API（属性 + API 文档）、仪表板（属性 + 图表信息）。
  当用户场景涉及 资产详情、资产画像、看这张表/这个指标/这个 API/这个报表、字段列表、使用说明、数据预览、上下游血缘、字段血缘、质量概况、相关指标、指标口径、API 文档、请求/返回参数、图表列表、目录层级 时进入。

  触发场景：给一个 GUID/名称要“这个资产的全貌”；只看其中某一板块；属性写入后回读校验。

  触发词：资产详情、资产画像、目录详情、字段列表、使用说明、数据预览、前50条、血缘、上下游、字段血缘、质量概况、质量分、相关指标、指标口径、业务指标、技术指标、API 文档、仪表板、图表信息、get-catalog-asset-details、get-biz-metric-by-name、get-data-service-api-document。

  关键限制：**先认资产类型再选板块**（业务指标无预览/无血缘；API与仪表板无预览/血缘/质量）；**汇报术语必须对齐界面**（`SimpleNodeInfos`=「产出任务」不是「调度节点」；`ReadCount`=「浏览量」；`CollectionCount`=「收藏数」）；**`IncludeDetailedAttributes` 不传则 `ReadCount`/`CollectionCount`/`SimpleNodeInfos` 恒为 null**；字段级 `Standards`/`ClassifyName`/`LevelShortName` 是活字段**必须逐列输出**，只有 `Columns[].QualityScore` 是恒 null 的死字段；**表级质量分无 OpenAPI**；**API 错误码无 OpenAPI**；**仪表板图表信息只有 GUID+名称**且放在 `Columns[]` 里；**质量模块响应体在 `PageResult`/具名键下，不在 `Data` 下**，只读 Data 会恒得 null 并误判成未授权；**质量输出不得透出「监控对象/watch」等内部词**，只说这张表下配了多少条质量规则；字段名与 SDK 文档不一致（`Id`/`Type`/`TableInfo`/`Strength`/`TestRun*`/`ValidateSuccess`）；`GetQualityWatchByObjectId` 的 WatchType/WatchObjectId 是 **query 位参数**且 TABLE 类型的 WatchObjectId **就是资产 GUID**；`ListQualityRules` 的 watchId **事实必填**；`GetBizMetricByName` 必须用 `BizMetricByNameQuery` 包裹且 **`draft` 必填**；PagedQuery* 是旧裸名会报 Unknown API；`GetTableLineages` 的 NeedUpstream/NeedDownstream **默认 false 必须显式传 true** 且 FilterQuery 必传，**单次只返回 1 跳，全链路必须客户端 BFS 递归且要先让用户选范围**；数据预览会起即席查询**消耗计算资源，需 HITL 确认**且分区表必须带分区谓词；`Instruction` 是富文本 JSON 不能直展；GetAssetAttributes 单次 GuidList ≤ 50；19 位 ID 必须字符串。

资产目录详情查询（5 类资产 × 分板块）

1. Scenario Description

把资产目录里一个资产的**详情页**用 OpenAPI 拼出来。**板块随资产类型变**：

| 资产类型 | 板块组合 | 主 API | |---|---|---| | **表** `TABLE` | 属性详情·字段列表·使用说明 + 数据预览 + 表/字段血缘 + 质量概况 | `GetCatalogAssetDetails` / `ExecuteAdHocTask` / `GetTable(Column)Lineages` / 质量三件套 | | **技术指标** `INDEX` | 属性详情 + 数据预览 + **所属字段**血缘 + **所属字段**质量规则 | 同上，但先把指标映射到「所属表 + 字段」 | | **业务指标** `BIZ_INDEX` | 属性详情 + **相关指标** + **使用说明** | `GetCatalogAssetDetails` + **`GetBizMetricByName`** | | **数据服务 API** `API` | 属性详情 + **API 文档**（基本信息/请求参数/返回参数） | `GetCatalogAssetDetails` + **`GetDataServiceApiDocument`** | | **仪表板** `PAGE` | 属性详情 + **图表信息** | `GetCatalogAssetDetails`（`IncludeColumns: true`） |

**完整矩阵、各类型非空字段差异、以及技术指标→字段的映射路径，全部在** [`references/asset-type-matrix.md`](references/asset-type-matrix.md)（已实测）。

**Architecture**：

资产 GUID
  └─ GetCatalogAssetDetails（所有类型的统一入口）→ AssetType + SubType
       ├─ TABLE      → 预览 / 表·字段血缘 / 质量概况
       ├─ INDEX     → AssetFullName 拆出「表名.字段名」→ 拼表 GUID → 字段血缘 + 字段质量规则
       ├─ BIZ_INDEX → GetBizMetricByName → RelatedBizMetrics / MetricDefinition / OperateInstructionContent
       ├─ API       → ApiId → GetDataServiceApiDocument → Request/Response/PublicParamList
       └─ PAGE      → Columns[] 即图表列表（ChartCount 对得上）

> **★ 板块④ 质量的能力边界（必须先读）**：**平台的「表级质量分」没有任何 OpenAPI 可取**。质量接口只能给出「规则清单 + 校验通过/不通过」，分数需本 skill 自算，且计分方式/权重本身也不可读。结论与实测证据见 [`references/quality-profile-feasibility.md`](references/quality-profile-feasibility.md)——**回答用户“质量分是多少”之前必须先看这份，不要把自算通过率当成平台质量分报出去。**

> 属性的**写入**请用子 skill `manage-asset-attributes`（`UpdateAssetAttributes`）；质量规则的**配置**请用 `configure-quality-rule`；业务指标的**增删改**请用 `manage-biz-metric`。

2. Installation

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

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

> **命令收录说明**：`GetAssetAttributes` 为 V6.3 新增、`GetCatalogAssetDetails` 为 V6.3 增强出参；若 `aliyun dataphin-public --help` 未列出对应 kebab-case 命令，先 `aliyun plugin update`；仍未收录时走 §8 末尾的 SDK 兜底（API 版本 `2023-06-30`）。

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, print, or expose AK/SK values in the conversation or logs > - **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` 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

最小权限策略详见 [`references/ram-policies.md`](references/ram-policies.md)。

> **[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 `references/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, resour