@thinkingai/ae-cli 1.0.3 → 1.0.18

package/skills/{te-audience/references/list-clusters.md → ae-analysis/references/list_clusters.md}

@@ -1,16 +1,23 @@
 # analysis_audience +list_clusters (Cluster Search)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Cluster Management**
 
+## Constraints
+
+**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
+
 ## Use Cases
-- List cluster metadata accessible to the current user in the project. Supports keyword filtering and returns cluster names, display names, types, status, user counts, and related metadata, but not cluster members.
+- List cluster metadata accessible to the current user in the project.
+- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
+- Returns a paginated envelope (items + total + limit + offset + hasMore), not cluster members.
 
 ## Commands
 ```bash
-ae-cli analysis_audience +list_clusters --project_id 1
-ae-cli analysis_audience +list_clusters --project_id 1 --query demo
+ae-cli analysis_audience +list_clusters --project_id <project_id>
+ae-cli analysis_audience +list_clusters --project_id <project_id> --query demo
+ae-cli analysis_audience +list_clusters --project_id <project_id> --fields '["id","clusterName","usersNum"]' --limit 20 --offset 0
 ae-cli analysis_audience +list_clusters --dry-run
 ```
 
@@ -19,6 +26,9 @@ ae-cli analysis_audience +list_clusters --dry-run
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
 | `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against cluster names, display names, and remarks; if omitted, all clusters are returned. |
+| `--fields` | No | Optional return field list (JSON array). Invalid fields will fail with `INVALID_FIELDS`. |
+| `--limit` | No | Optional page size. Default: 20, max: 50. |
+| `--offset` | No | Optional page offset. Default: 0. |
 
 ## Decision Rules
 - For the first execution, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the path works.

package/skills/{te-analysis/references/list-dashboards.md → ae-analysis/references/list_dashboards.md}

@@ -1,17 +1,22 @@
 # analysis +list_dashboards (List Dashboards)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Dashboard management**
 
+## Constraints
+
+**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
+
 ## Use Cases
 - List dashboard metadata accessible to the current user in the project. Supports keyword filtering and returns dashboard IDs, names, descriptions, and related metadata, but not dashboard configuration or report data.
 - List dashboard metadata accessible to the current user in the project.
 
 ## Command
 ```bash
-ae-cli analysis +list_dashboards --project_id 1
-ae-cli analysis +list_dashboards --project_id 1 --query demo
+ae-cli analysis +list_dashboards --project_id <project_id>
+ae-cli analysis +list_dashboards --project_id <project_id> --query demo
+ae-cli analysis +list_dashboards --project_id <project_id> --fields '["dashboardId","dashboardName"]' --limit 20 --offset 0
 ae-cli analysis +list_dashboards --dry-run
 ```
 
@@ -19,7 +24,10 @@ ae-cli analysis +list_dashboards --dry-run
 | Parameter | Required | Description |
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against dashboard names; if omitted, all accessible dashboards are returned. |
+| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against dashboard names and AI remarks; if omitted, all accessible dashboards are returned. |
+| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `dashboardId`, `dashboardName`, `aiRemark`. |
+| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 50. |
+| `--offset` / `-o` | No | Optional page offset. Default: 0. |
 
 ## Decision Rules
 - On the first run, start with only the required parameters (`--project_id`), and add optional parameters after confirming the path works.

package/skills/{te-meta/references/list-entities.md → ae-analysis/references/list_entities.md}

@@ -1,6 +1,6 @@
 # analysis_meta +list_entities (Entity Search)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Entity Query**
 
@@ -10,8 +10,10 @@ Domain: **Entity Query**
 
 ## Command
 ```bash
-ae-cli analysis_meta +list_entities --project_id 1
-ae-cli analysis_meta +list_entities --project_id 1 --event_name demo
+ae-cli analysis_meta +list_entities --project_id <project_id>
+ae-cli analysis_meta +list_entities --project_id <project_id> --query demo
+ae-cli analysis_meta +list_entities --project_id <project_id> --event_name demo
+ae-cli analysis_meta +list_entities --project_id <project_id> --fields '["entityId", "entityName", "columnName", "columnDesc", "selectType"]' --limit 20 --offset 0
 ae-cli analysis_meta +list_entities --dry-run
 ```
 
@@ -20,6 +22,11 @@ ae-cli analysis_meta +list_entities --dry-run
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
 | `--event_name` | No | Optional event name filter |
+| `--query` / `-q` | No | Optional keyword filter. Fuzzy match is applied to entityName, columnName, and columnDesc; if omitted, all accessible dashboards are returned. |
+| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `entityId`, `entityName`, `columnName`, `columnDesc`, `selectType`. |
+| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 50. |
+| `--offset` / `-o` | No | Optional page offset. Default: 0. |
+
 
 ## Decision Rules
 - First run should only pass the required parameter (`--project_id`), and add optional parameters only after the path is confirmed to work.

package/skills/{te-meta/references/list-events.md → ae-analysis/references/list_events.md}

@@ -1,17 +1,22 @@
 # analysis_meta +list_events (Event Metadata Discovery)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Metadata Query**
 
+## Constraints
+
+**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
+
 ## Use Cases
 - Read-only query for SYSTEM METADATA already effective in the project. Use for super events in production metadata. Do NOT use for tracking-plan metadata (bury/track program); that belongs to BuryProgramTool.
 - Read-only query for SYSTEM METADATA already effective in the project.
 
 ## Commands
 ```bash
-ae-cli analysis_meta +list_events --project_id 1
-ae-cli analysis_meta +list_events --project_id 1 --query demo
+ae-cli analysis_meta +list_events --project_id <project_id>
+ae-cli analysis_meta +list_events --project_id <project_id> --query demo
+ae-cli analysis_meta +list_events --project_id <project_id> --query demo --fields '["eventName", "eventDesc"]' --limit 20 --offset 0
 ae-cli analysis_meta +list_events --dry-run
 ```
 
@@ -19,8 +24,10 @@ ae-cli analysis_meta +list_events --dry-run
 | Parameter | Required | Description |
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against event names, descriptions, and AI remarks; if omitted, all events are returned. |
-
+| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against eventName, eventDesc, and aiRemark; if omitted, all events are returned. |
+| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `eventName`, `eventDesc`, `aiRemark`, `eventTag`, `remark`. |
+| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 50. |
+| `--offset` / `-o` | No | Optional page offset. Default: 0. |
 ## Decision Rules
 - For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.
 - For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.

package/skills/ae-analysis/references/list_metrics.md

@@ -0,0 +1,45 @@
+# analysis_meta +list_metrics (Metric Search)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Metadata Query**
+
+## Constraints
+
+**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
+
+## Use Cases
+- List metric metadata in the project. Supports keyword filtering and returns metric IDs, names, display names, model types, remarks, and related metadata, but not metric calculation results.
+- Supports pagination with fields/limit/offset for payload governance.
+- Query performs fuzzy matching on metricName, metricDesc, and metricRemark.
+
+## Command
+```bash
+ae-cli analysis_meta +list_metrics --project_id <project_id>
+ae-cli analysis_meta +list_metrics --project_id <project_id> --query demo
+ae-cli analysis_meta +list_metrics --project_id <project_id> --query demo --fields '["metricId","metricName"]' --limit 10 --offset 0
+ae-cli analysis_meta +list_metrics --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--project_id` / `-p` | Yes | Project ID |
+| `--query` / `-q` | No | Optional keyword filter. Fuzzy match on metricName, metricDesc, metricRemark. |
+| `--fields` | No | Optional fields to return. Supported: metricId, metricName, metricDesc, metricRemark, metricMode, openId, creator, creatorLoginName, updateOpenId, updateCreator, updateLoginName, createTime, updateTime. Invalid fields cause INVALID_FIELDS error. |
+| `--limit` | No | Optional limit. Default: 20, maximum: 50. |
+| `--offset` | No | Optional offset. Default: 0. |
+
+## Decision Rules
+- First run should only pass the required parameter (`--project_id`), and add optional parameters only after the path is confirmed to work.
+- For pagination, use `--limit` and `--offset` together. Default limit is 20.
+- Use `--fields` to select specific columns for lighter response payloads.
+- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
+
+## Next Steps After Failure
+- If the required parameter is missing, fall back to the smallest runnable command and fill it in (focus on `--project_id`).
+- If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
+- If INVALID_FIELDS error appears, check that all field names in `--fields` match the supported list.
+
+## Recommended Chaining
+- +list_metrics -> +create_metric -> +get_metric

package/skills/ae-analysis/references/list_project_mark_times.md

@@ -0,0 +1,42 @@
+# analysis_meta +list_project_mark_times (List Project Mark Times)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Project Configuration**
+
+## Use Cases
+- List project date markers. Returns marker IDs, timestamps, content, and visibility status.
+- Supports pagination with fields/limit/offset for payload governance.
+- Query performs fuzzy matching on markContent.
+
+## Commands
+```bash
+ae-cli analysis_meta +list_project_mark_times --project_id <project_id>
+ae-cli analysis_meta +list_project_mark_times --project_id <project_id> --zone_offset 8
+ae-cli analysis_meta +list_project_mark_times --project_id <project_id> --query demo --fields '["id","markTime","markContent"]' --limit 10 --offset 0
+ae-cli analysis_meta +list_project_mark_times --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--project_id` / `-p` | Yes | Project ID |
+| `--zone_offset` | No | Marker time zone offset |
+| `--query` / `-q` | No | Optional keyword filter. Fuzzy match on markContent. |
+| `--fields` | No | Optional fields to return. Supported: id, projectId, markTime, userZoneTime, zoneOffset, markContent, isShow, creatorName, creatorId, lastModifierName, lastModifierId, createTime, updateTime. Invalid fields cause INVALID_FIELDS error. |
+| `--limit` | No | Optional limit. Default: 20, maximum: 50. |
+| `--offset` | No | Optional offset. Default: 0. |
+
+## Decision Rules
+- For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.
+- For pagination, use `--limit` and `--offset` together. Default limit is 20.
+- Use `--fields` to select specific columns for lighter response payloads.
+- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
+
+## Next Steps After Failure
+- If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
+- If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
+- If INVALID_FIELDS error appears, check that all field names in `--fields` match the supported list.
+
+## Recommended Chaining
+- +get_project_config -> +list_project_mark_times

package/skills/{te-meta/references/list-project-users.md → ae-analysis/references/list_project_users.md}

@@ -1,6 +1,6 @@
 # analysis_meta +list_project_users (Read Project Member List)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Project Configuration**
 
@@ -10,7 +10,7 @@ Domain: **Project Configuration**
 
 ## Command
 ```bash
-ae-cli analysis_meta +list_project_users --project_id 1
+ae-cli analysis_meta +list_project_users --project_id <project_id>
 ae-cli analysis_meta +list_project_users --dry-run
 ```
 

package/skills/{te-common/references/list-projects.md → ae-analysis/references/list_projects.md}

@@ -1,6 +1,6 @@
 # analysis_common +list_projects (view projects accessible to the current user)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **project discovery / cross-module pre-query**
 
@@ -10,7 +10,7 @@ Domain: **project discovery / cross-module pre-query**
 
 ## Mandatory Rules (MUST)
 - This command does not accept any business parameters; do not invent `project_id`, keywords, or pagination parameters.
-- If a later target command requires `project_id`, `+list_projects` may only be used for "candidate project discovery" and cannot replace user confirmation.
+- If a later target command requires `project_id`, `+list_projects` is used for first-time project discovery, new project verification, project switching, or ambiguity resolution. Do not call it repeatedly when the same continuous conversation already has a verified project context for the same host/environment.
 - In the final response, prioritize the returned `projectId`, `projectName`, and `roleName` to help the user confirm the project.
 
 ## Command
@@ -26,7 +26,8 @@ ae-cli analysis_common +list_projects --dry-run
 
 ## Decision Rules
 - When the user says "let me see what projects I have", "list the available projects first", or "I don't know project_id", call this command first.
-- When you need to continue with a command that depends on `project_id`, show candidate projects first, then ask the user to explicitly confirm the target `projectId`.
+- When a later command depends on `project_id` and there is no verified project context, show candidate projects first, then ask the user to explicitly confirm the target `projectId`.
+- When the same continuous conversation already has a verified `project_id` for the same host/environment, reuse it directly and do not call `+list_projects` again unless the user switches projects, switches host/environment, asks to list projects, or the current project context becomes ambiguous.
 - If there are many projects returned, prioritize summarizing by `projectName`, `projectId`, and `roleName` to avoid expanding all low-value fields at once.
 
 ## Next Step on Failure
@@ -34,4 +35,5 @@ ae-cli analysis_common +list_projects --dry-run
 - If the call fails, first check the authentication status, the target environment host, and the current login identity.
 
 ## Recommended Chaining
-- `+list_projects` -> user confirms `project_id` -> any command that requires `project_id`
+- First use: `+list_projects` -> user confirms `project_id` -> any command that requires `project_id`
+- Follow-up use in the same verified context: reuse confirmed `project_id` -> target command

package/skills/{te-meta/references/list-properties.md → ae-analysis/references/list_properties.md}

@@ -1,6 +1,6 @@
 # analysis_meta +list_properties (Property Metadata Discovery)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Metadata Query**
 
@@ -10,8 +10,9 @@ Domain: **Metadata Query**
 
 ## Commands
 ```bash
-ae-cli analysis_meta +list_properties --project_id 1
-ae-cli analysis_meta +list_properties --project_id 1 --scope event --event_name purchase --query demo
+ae-cli analysis_meta +list_properties --project_id <project_id>
+ae-cli analysis_meta +list_properties --project_id <project_id> --scope event --event_name purchase --query demo
+ae-cli analysis_meta +list_properties --project_id <project_id> --query demo --fields '["propName", "propDesc"]' --limit 20 --offset 0
 ae-cli analysis_meta +list_properties --dry-run
 ```
 
@@ -21,7 +22,11 @@ ae-cli analysis_meta +list_properties --dry-run
 | `--project_id` / `-p` | Yes | Project ID |
 | `--scope` | No | Optional property scope. event means event properties, user means user properties. If omitted, all scopes are queried. |
 | `--event_name` | No | Optional event name. If provided, only event properties available for that event are returned. |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against property names, descriptions, and AI remarks; if omitted, all matched properties are returned. |
+| `--query` / `-q` | No | Optional keyword filter. Fuzzy match is applied to propName, propDesc, and aiRemark; if omitted, all matched properties are returned. |
+| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `propName`, `propDesc`, `aiRemark`, `selectType`, `tableType`, `subTableType`. |
+| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 50. |
+| `--offset` / `-o` | No | Optional page offset. Default: 0. |
+
 
 ## Decision Rules
 - For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.

package/skills/ae-analysis/references/list_public_access_links.md

@@ -0,0 +1,41 @@
+# analysis +list_public_access_links (public link search)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Dashboard Management**
+
+## Use Cases
+- List public access links in the project. Returns link IDs, short codes, access targets, status, effective time, expiration time, and related metadata.
+- Supports pagination with fields/limit/offset for payload governance.
+- Query performs fuzzy matching on shorter and remarks.
+
+## Commands
+```bash
+ae-cli analysis +list_public_access_links --project_id <project_id>
+ae-cli analysis +list_public_access_links --project_id <project_id> --query demo
+ae-cli analysis +list_public_access_links --project_id <project_id> --query demo --fields '["id","shorter","accessStatus"]' --limit 10 --offset 0
+ae-cli analysis +list_public_access_links --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--project_id` / `-p` | Yes | Project ID |
+| `--query` / `-q` | No | Optional keyword filter. Fuzzy match on shorter and remarks. |
+| `--fields` | No | Optional fields to return. Supported: id, shorter, creator, projectIdAndName, source, accessId, target, options, remarks, accessStatus, effectTime, expireTime, createTime, updateTime. Invalid fields cause INVALID_FIELDS error. |
+| `--limit` | No | Optional limit. Default: 20, maximum: 50. |
+| `--offset` | No | Optional offset. Default: 0. |
+
+## Decision Rules
+- For the first run, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the chain works.
+- For pagination, use `--limit` and `--offset` together. Default limit is 20.
+- Use `--fields` to select specific columns for lighter response payloads.
+- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
+
+## Next Step After Failure
+- If required parameters are missing, fall back to the smallest runnable command and fill them in (focus on `--project_id`).
+- If the result is empty, first confirm the project ID/keyword, then try broadening the filter conditions.
+- If INVALID_FIELDS error appears, check that all field names in `--fields` match the supported list.
+
+## Recommended Chaining
+- +list_public_access_links -> +update_public_access_link

package/skills/{te-analysis/references/list-reports.md → ae-analysis/references/list_reports.md}

@@ -1,17 +1,22 @@
 # analysis +list_reports (List Reports)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Report management**
 
+## Constraints
+
+**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
+
 ## Use Cases
 - List report metadata accessible to the current user in the project. Supports keyword filtering and returns report IDs, names, model types, update times, and related metadata, but not report definitions or analysis data.
 - List report metadata accessible to the current user in the project.
 
 ## Command
 ```bash
-ae-cli analysis +list_reports --project_id 1
-ae-cli analysis +list_reports --project_id 1 --query demo
+ae-cli analysis +list_reports --project_id <project_id>
+ae-cli analysis +list_reports --project_id <project_id> --query demo
+ae-cli analysis +list_reports --project_id <project_id> --fields '["reportId","reportName","reportModel"]' --limit 20 --offset 0
 ae-cli analysis +list_reports --dry-run
 ```
 
@@ -19,7 +24,10 @@ ae-cli analysis +list_reports --dry-run
 | Parameter | Required | Description |
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
-| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against report names and descriptions; if omitted, all accessible reports are returned. |
+| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against report names, descriptions, and AI remarks; if omitted, all accessible reports are returned. |
+| `--fields` / `-f` | No | Optional fields to return (JSON array). Supported fields: `reportId`, `reportName`, `reportDesc`, `reportModel`, `aiRemark`. |
+| `--limit` / `-l` | No | Optional page size. Default: 20, maximum: 50. |
+| `--offset` / `-o` | No | Optional page offset. Default: 0. |
 
 ## Decision Rules
 - On the first run, start with only the required parameters (`--project_id`), and add optional parameters after confirming the path works.

package/skills/{te-audience/references/list-tag-members.md → ae-analysis/references/list_tag_members.md}

@@ -1,16 +1,19 @@
 # analysis_audience +list_tag_members (View Tag Members)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Tag Management**
 
 ## Use Cases
-- List members in the specified tag. Returns member information such as user property values and total user count for the selected snapshot date.
+- List members in the specified tag.
+- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
+- Returns a paginated envelope (items + total + limit + offset + hasMore) for the selected snapshot date.
 
 ## Commands
 ```bash
-ae-cli analysis_audience +list_tag_members --project_id 1 --tag_name demo
-ae-cli analysis_audience +list_tag_members --project_id 1 --tag_name demo --snapshot_date 2026-04-01 --property_names '["#user_id","name"]' --use_cache false
+ae-cli analysis_audience +list_tag_members --project_id <project_id> --tag_name demo
+ae-cli analysis_audience +list_tag_members --project_id <project_id> --tag_name demo --snapshot_date 2026-04-01 --property_names '["#user_id","name"]' --use_cache false
+ae-cli analysis_audience +list_tag_members --project_id <project_id> --tag_name demo --query user_001 --fields '["#user_id","name"]' --limit 20 --offset 0
 ae-cli analysis_audience +list_tag_members --dry-run
 ```
 
@@ -22,6 +25,10 @@ ae-cli analysis_audience +list_tag_members --dry-run
 | `--snapshot_date` | No | Optional tag snapshot date. Format: YYYY-MM-DD |
 | `--property_names` | No | Optional list of user property names (JSON array) |
 | `--use_cache` | No | Whether to use cache. Default: true |
+| `--query` | No | Optional keyword filter on `#user_id` and selected properties. |
+| `--fields` | No | Optional return field list (JSON array). Invalid fields will fail with `INVALID_FIELDS`. |
+| `--limit` | No | Optional page size. Default: 20, max: 50. |
+| `--offset` | No | Optional page offset. Default: 0. |
 
 ## Decision Rules
 - For the first execution, it is recommended to pass only the required parameters (`--project_id`, `--tag_name`) and add optional parameters after confirming the path works.

package/skills/{te-audience/references/list-tags.md → ae-analysis/references/list_tags.md}

@@ -1,16 +1,23 @@
 # analysis_audience +list_tags (Tag Search)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Tag Management**
 
+## Constraints
+
+**Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
+
 ## Use Cases
-- List tag metadata accessible to the current user in the project. Supports keyword filtering and returns tag names, display names, types, status, user counts, and related metadata, but not tag members.
+- List tag metadata accessible to the current user in the project.
+- Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
+- Returns a paginated envelope (items + total + limit + offset + hasMore), not tag members.
 
 ## Commands
 ```bash
-ae-cli analysis_audience +list_tags --project_id 1
-ae-cli analysis_audience +list_tags --project_id 1 --query demo
+ae-cli analysis_audience +list_tags --project_id <project_id>
+ae-cli analysis_audience +list_tags --project_id <project_id> --query demo
+ae-cli analysis_audience +list_tags --project_id <project_id> --fields '["id","clusterName","usersNum"]' --limit 20 --offset 0
 ae-cli analysis_audience +list_tags --dry-run
 ```
 
@@ -19,6 +26,9 @@ ae-cli analysis_audience +list_tags --dry-run
 |---|---|---|
 | `--project_id` / `-p` | Yes | Project ID |
 | `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against tag names, display names, and remarks; if omitted, all tags are returned. |
+| `--fields` | No | Optional return field list (JSON array). Invalid fields will fail with `INVALID_FIELDS`. |
+| `--limit` | No | Optional page size. Default: 20, max: 50. |
+| `--offset` | No | Optional page offset. Default: 0. |
 
 ## Decision Rules
 - For the first execution, it is recommended to pass only the required parameters (`--project_id`) and add optional parameters after confirming the path works.

package/skills/{te-analysis/references/load-filters.md → ae-analysis/references/load_filters.md}

@@ -1,6 +1,6 @@
 # analysis +load_filters (load filter candidate values)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Model Analysis**
 
@@ -14,8 +14,8 @@ Domain: **Model Analysis**
 
 ## Commands
 ```bash
-ae-cli analysis +load_filters --project_id 1 --quot demo --table_type event
-ae-cli analysis +load_filters --project_id 1 --quot demo --table_type event --event_name demo --inputdata demo --zone_offset 8 --cluster_date_policy SPECIFIED --specified_cluster_date 2026-04-08 --is_report true
+ae-cli analysis +load_filters --project_id <project_id> --quot demo --table_type event
+ae-cli analysis +load_filters --project_id <project_id> --quot demo --table_type event --event_name demo --inputdata demo --zone_offset 8 --cluster_date_policy SPECIFIED --specified_cluster_date 2026-04-08 --is_report true
 ae-cli analysis +load_filters --dry-run
 ```
 

package/skills/{te-analysis/references/query-adhoc.md → ae-analysis/references/query_adhoc.md}

@@ -1,9 +1,19 @@
 # analysis +query_adhoc (Ad Hoc Analysis Execution)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Model analysis**
 
+## Constraints
+
+**⚠️ QUERY_EXISTING_FIRST:** Before using ad-hoc query, you MUST first check for existing reports/dashboards with `list_reports` and `list_dashboards`. Only use `query_adhoc` if no matching reports found. See [SKILL.md § D. QUERY_EXISTING_FIRST](../SKILL.md#d-query_existing_first).
+
+**Quick check workflow:**
+1. `list_reports --query <keyword>` - search matching reports
+2. `list_dashboards --query <keyword>` - search matching dashboards
+3. If found → use `query_report_data` or `query_dashboard_report_data`
+4. If not found → only then use `query_adhoc`
+
 ## Use Cases
 - Precondition helper: call `+get_analysis_query_schema` to get the structure before using this tool.
 - When constructing a real `qp`, you must supplement it with real project metadata; first call `analysis_meta +list_events` and `analysis_meta +list_properties`.
@@ -22,22 +32,22 @@ Domain: **Model analysis**
 
 ## Mandatory prerequisites (MUST)
 - Before constructing `--qp`, you must first read and follow these reference documents:
-  - [`./get-analysis-query-schema.md`](./get-analysis-query-schema.md)
-  - [`../../te-meta/references/list-events.md`](../../te-meta/references/list-events.md)
-  - [`../../te-meta/references/list-properties.md`](../../te-meta/references/list-properties.md)
+  - [`./get_analysis_query_schema.md`](./get_analysis_query_schema.md)
+  - [`./list_events.md`](./list_events.md)
+  - [`./list_properties.md`](./list_properties.md)
 - Do not generate the final `qp` until the documentation review and prerequisite command calls are complete.
 
 ## Prerequisite call chain (required for constructing qp)
 1. First determine `--model_type`.
-2. Read `get-analysis-query-schema.md`, then call `ae-cli analysis +get_analysis_query_schema --model_type <model_type>` to get the structure.
-3. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1` to get the available events.
-4. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1` to get the available properties.
+2. Read `get_analysis_query_schema.md`, then call `ae-cli analysis +get_analysis_query_schema --model_type <model_type>` to get the structure.
+3. Read `list_events.md`, then call `ae-cli analysis_meta +list_events --project_id <project_id>` to get the available events.
+4. Read `list_properties.md`, then call `ae-cli analysis_meta +list_properties --project_id <project_id>` to get the available properties.
 5. Build `qp` from the schema + metadata, then call `+query_adhoc`.
 
 ## Command
 ```bash
-ae-cli analysis +query_adhoc --project_id 1 --model_type event --qp '{}'
-ae-cli analysis +query_adhoc --project_id 1 --model_type event --qp '{}' --zone_offset 8 --request_id demo --use_cache true --is_sort_by_columns true --resolve_recent_day true --timeout_minutes 8
+ae-cli analysis +query_adhoc --project_id <project_id> --model_type event --qp '{}'
+ae-cli analysis +query_adhoc --project_id <project_id> --model_type event --qp '{}' --fields '["date","event"]' --limit 10 --offset 0 --zone_offset 8 --request_id demo --use_cache true --is_sort_by_columns true --resolve_recent_day true --timeout_minutes 8
 ae-cli analysis +query_adhoc --dry-run
 ```
 
@@ -52,10 +62,15 @@ ae-cli analysis +query_adhoc --dry-run
 | `--zone_offset` | No | Time zone offset in hours. For example, UTC+8 is 8 and UTC-5 is -5 |
 | `--is_sort_by_columns` | No | Whether to sort query results by columns. Default: false |
 | `--resolve_recent_day` | No | Whether to resolve relative time expressions such as "last 7 days". Default: false |
+| `--fields` | No | Optional fields to return. Must match column names in result. Invalid fields cause INVALID_FIELDS error. |
+| `--limit` | No | Optional limit. Default: 20, maximum: 50. |
+| `--offset` | No | Optional offset. Default: 0. |
 | `--timeout_minutes` | No | Query timeout in minutes. If the query exceeds this time, it will be cancelled automatically. |
 
 ## Decision Rules
 - On the first run, start with only the required parameters (`--project_id`,`--model_type`,`--qp`), and add optional parameters after confirming the path works.
+- For pagination, use `--limit` and `--offset` together. Default limit is 20.
+- Use `--fields` to select specific columns for lighter response payloads.
 - `qp` cannot be written from experience alone: it must satisfy both the schema structure and the project metadata constraints.
 - Before calling `list_events` / `list_properties`, you must first study the corresponding reference documents.
 - Wrap JSON parameters in single quotes (for example `--qp '{}'`) to avoid shell escaping issues.

package/skills/{te-analysis/references/query-dashboard-detail.md → ae-analysis/references/query_dashboard_detail.md}

@@ -1,6 +1,6 @@
 # analysis +query_dashboard_detail (read dashboard structure)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Dashboard Management**
 
@@ -13,7 +13,7 @@ Domain: **Dashboard Management**
 
 ## Commands
 ```bash
-ae-cli analysis +query_dashboard_detail --project_id 1 --dashboard_id 1
+ae-cli analysis +query_dashboard_detail --project_id <project_id> --dashboard_id 1
 ae-cli analysis +query_dashboard_detail --dry-run
 ```
 

package/skills/{te-analysis/references/query-dashboard-report-data.md → ae-analysis/references/query_dashboard_report_data.md}

@@ -1,6 +1,6 @@
 # analysis +query_dashboard_report_data (Batch Query Dashboard Report Data)
 
-> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
 Domain: **Dashboard management**
 
@@ -12,21 +12,21 @@ Domain: **Dashboard management**
 
 ## Mandatory prerequisites (MUST)
 - Before constructing `--filters`, you must first read and follow these reference documents:
-  - [`./get-filter-schema.md`](./get-filter-schema.md)
-  - [`../../te-meta/references/list-events.md`](../../te-meta/references/list-events.md)
-  - [`../../te-meta/references/list-properties.md`](../../te-meta/references/list-properties.md)
+  - [`./get_filter_schema.md`](./get_filter_schema.md)
+  - [`./list_events.md`](./list_events.md)
+  - [`./list_properties.md`](./list_properties.md)
 - Do not generate the final `filters` until the documentation review and prerequisite command calls are complete.
 
 ## Prerequisite call chain (required for constructing filters)
-1. Read `get-filter-schema.md`, then call `ae-cli analysis +get_filter_schema` to get the filter structure.
-2. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1`.
-3. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1`.
+1. Read `get_filter_schema.md`, then call `ae-cli analysis +get_filter_schema` to get the filter structure.
+2. Read `list_events.md`, then call `ae-cli analysis_meta +list_events --project_id <project_id>`.
+3. Read `list_properties.md`, then call `ae-cli analysis_meta +list_properties --project_id <project_id>`.
 4. Build `filters` from the schema + metadata, then call `+query_dashboard_report_data`.
 
 ## Command
 ```bash
-ae-cli analysis +query_dashboard_report_data --project_id 1 --dashboard_id 1
-ae-cli analysis +query_dashboard_report_data --project_id 1 --dashboard_id 1 --filters '{}' --start_date 2026-04-08 --end_date 2026-04-08 --time_granularity day --use_cache true --report_ids '[1001]'
+ae-cli analysis +query_dashboard_report_data --project_id <project_id> --dashboard_id 1
+ae-cli analysis +query_dashboard_report_data --project_id <project_id> --dashboard_id 1 --filters '{}' --start_date 2026-04-08 --end_date 2026-04-08 --time_granularity day --use_cache true --report_ids '[1001]'
 ae-cli analysis +query_dashboard_report_data --dry-run
 ```