@thinkingai/ae-cli 1.0.3 → 1.0.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -53
- package/README.zh.md +203 -0
- package/dist/{auth-BQC5DBE7.js → auth-4GAHTBVH.js} +1 -1
- package/dist/{auth-DXKYLMO7.js → auth-U2GHFMFY.js} +5 -5
- package/dist/{chunk-ZYXIGPG7.js → chunk-OQ4XEG77.js} +2 -2
- package/dist/{chunk-53FNNCZW.js → chunk-TJIMDNAU.js} +1 -1
- package/dist/{chunk-3CDLNXTD.js → chunk-UK6HO5O5.js} +2 -2
- package/dist/{client-T4VODLA6.js → client-HU63573O.js} +2 -2
- package/dist/{config-V7AXKDMB.js → config-OLF7RBPM.js} +4 -4
- package/dist/index.js +14 -14
- package/dist/{raw-G3GKHAPZ.js → raw-GDO4IWNW.js} +3 -3
- package/dist/{te-analysis-CHFTDN55.js → te-analysis-ZDJXMWZY.js} +61 -23
- package/dist/{te-audience-M6LQY6M7.js → te-audience-T5B52EEB.js} +60 -20
- package/dist/{te-common-BLQ7DVGC.js → te-common-BPTXXTHQ.js} +5 -32
- package/dist/{community-FVDAWGS4.js → te-community-FPB5LH56.js} +58 -58
- package/dist/{te-dataops-V4OTKY35.js → te-dataops-2NUJVG47.js} +2 -27
- package/dist/{te-engage-DXE4R5EW.js → te-engage-K3EANZ5P.js} +3 -21
- package/dist/{te-meta-FMM7KCVI.js → te-meta-JJMV75KB.js} +85 -17
- package/package.json +3 -3
- package/skills/ae-analysis/SKILL.md +229 -0
- package/skills/{te-meta/references/batch-create-metadata.md → ae-analysis/references/batch_create_metadata.md} +3 -3
- package/skills/{te-meta/references/batch-edit-metadata.md → ae-analysis/references/batch_edit_metadata.md} +2 -2
- package/skills/{te-analysis/references/build-entity-details-sql.md → ae-analysis/references/build_entity_details_sql.md} +9 -9
- package/skills/{te-analysis/references/build-event-details-sql.md → ae-analysis/references/build_event_details_sql.md} +9 -9
- package/skills/{te-analysis/references/create-alert.md → ae-analysis/references/create_alert.md} +4 -4
- package/skills/{te-audience/references/create-cluster.md → ae-analysis/references/create_cluster.md} +23 -19
- package/skills/{te-analysis/references/create-dashboard.md → ae-analysis/references/create_dashboard.md} +4 -4
- package/skills/{te-meta/references/create-metric.md → ae-analysis/references/create_metric.md} +10 -10
- package/skills/{te-analysis/references/create-or-update-dashboard-note.md → ae-analysis/references/create_or_update_dashboard_note.md} +3 -3
- package/skills/{te-meta/references/create-project-mark-time.md → ae-analysis/references/create_project_mark_time.md} +3 -3
- package/skills/{te-analysis/references/create-public-access-link.md → ae-analysis/references/create_public_access_link.md} +3 -3
- package/skills/{te-analysis/references/create-report.md → ae-analysis/references/create_report.md} +9 -9
- package/skills/{te-analysis/references/create-result-cluster.md → ae-analysis/references/create_result_cluster.md} +6 -6
- package/skills/{te-audience/references/create-tag.md → ae-analysis/references/create_tag.md} +16 -15
- package/skills/{te-meta/references/create-virtual-event.md → ae-analysis/references/create_virtual_event.md} +9 -9
- package/skills/{te-meta/references/create-virtual-property.md → ae-analysis/references/create_virtual_property.md} +7 -7
- package/skills/{te-meta/references/delete-project-mark-times.md → ae-analysis/references/delete_project_mark_times.md} +2 -2
- package/skills/{te-meta/references/delete-track-items.md → ae-analysis/references/delete_track_items.md} +2 -2
- package/skills/{te-analysis/references/drilldown-user-events.md → ae-analysis/references/drilldown_user_events.md} +8 -8
- package/skills/{te-analysis/references/drilldown-users.md → ae-analysis/references/drilldown_users.md} +10 -7
- package/skills/ae-analysis/references/generate_track_program.md +51 -0
- package/skills/ae-analysis/references/generate_track_sdk_sample.md +43 -0
- package/skills/{te-analysis/references/get-alert.md → ae-analysis/references/get_alert.md} +2 -2
- package/skills/{te-analysis/references/get-alert-definition-schema.md → ae-analysis/references/get_alert_definition_schema.md} +1 -1
- package/skills/ae-analysis/references/get_analysis_query_schema.md +61 -0
- package/skills/ae-analysis/references/get_cluster_definition_schema.md +53 -0
- package/skills/ae-analysis/references/get_clusters_by_name.md +69 -0
- package/skills/{te-analysis/references/get-filter-schema.md → ae-analysis/references/get_filter_schema.md} +1 -1
- package/skills/{te-analysis/references/get-groupby-schema.md → ae-analysis/references/get_groupby_schema.md} +1 -1
- package/skills/{te-meta/references/get-metric.md → ae-analysis/references/get_metric.md} +2 -2
- package/skills/{te-meta/references/get-project-config.md → ae-analysis/references/get_project_config.md} +2 -2
- package/skills/{te-analysis/references/get-report-definition.md → ae-analysis/references/get_report_definition.md} +2 -2
- package/skills/{te-common/references/get-resource-url.md → ae-analysis/references/get_resource_url.md} +4 -4
- package/skills/{te-analysis/references/get-table-columns.md → ae-analysis/references/get_table_columns.md} +2 -2
- package/skills/ae-analysis/references/get_tag_definition_schema.md +49 -0
- package/skills/ae-analysis/references/get_tags_by_name.md +69 -0
- package/skills/{te-meta/references/get-track-program.md → ae-analysis/references/get_track_program.md} +2 -2
- package/skills/{te-analysis/references/list-alerts.md → ae-analysis/references/list_alerts.md} +6 -3
- package/skills/{te-audience/references/list-cluster-members.md → ae-analysis/references/list_cluster_members.md} +11 -4
- package/skills/{te-audience/references/list-clusters.md → ae-analysis/references/list_clusters.md} +10 -4
- package/skills/{te-analysis/references/list-dashboards.md → ae-analysis/references/list_dashboards.md} +8 -4
- package/skills/{te-meta/references/list-entities.md → ae-analysis/references/list_entities.md} +10 -3
- package/skills/{te-meta/references/list-events.md → ae-analysis/references/list_events.md} +8 -5
- package/skills/ae-analysis/references/list_metrics.md +41 -0
- package/skills/ae-analysis/references/list_project_mark_times.md +42 -0
- package/skills/{te-meta/references/list-project-users.md → ae-analysis/references/list_project_users.md} +2 -2
- package/skills/{te-common/references/list-projects.md → ae-analysis/references/list_projects.md} +6 -4
- package/skills/{te-meta/references/list-properties.md → ae-analysis/references/list_properties.md} +9 -4
- package/skills/ae-analysis/references/list_public_access_links.md +41 -0
- package/skills/{te-analysis/references/list-reports.md → ae-analysis/references/list_reports.md} +8 -4
- package/skills/{te-audience/references/list-tag-members.md → ae-analysis/references/list_tag_members.md} +11 -4
- package/skills/{te-audience/references/list-tags.md → ae-analysis/references/list_tags.md} +10 -4
- package/skills/{te-analysis/references/load-filters.md → ae-analysis/references/load_filters.md} +3 -3
- package/skills/{te-analysis/references/query-adhoc.md → ae-analysis/references/query_adhoc.md} +14 -9
- package/skills/{te-analysis/references/query-dashboard-detail.md → ae-analysis/references/query_dashboard_detail.md} +2 -2
- package/skills/{te-analysis/references/query-dashboard-report-data.md → ae-analysis/references/query_dashboard_report_data.md} +9 -9
- package/skills/{te-analysis/references/query-entity-details.md → ae-analysis/references/query_entity_details.md} +10 -10
- package/skills/{te-analysis/references/query-event-details.md → ae-analysis/references/query_event_details.md} +12 -12
- package/skills/{te-analysis/references/query-report-data.md → ae-analysis/references/query_report_data.md} +11 -11
- package/skills/{te-audience/references/refresh-cluster.md → ae-analysis/references/refresh_cluster.md} +2 -2
- package/skills/{te-audience/references/refresh-tag.md → ae-analysis/references/refresh_tag.md} +2 -2
- package/skills/{te-meta/references/save-track-items.md → ae-analysis/references/save_track_items.md} +2 -2
- package/skills/{te-analysis/references/update-alert.md → ae-analysis/references/update_alert.md} +4 -4
- package/skills/{te-audience/references/update-cluster.md → ae-analysis/references/update_cluster.md} +15 -13
- package/skills/{te-analysis/references/update-dashboard.md → ae-analysis/references/update_dashboard.md} +3 -3
- package/skills/{te-meta/references/update-metric.md → ae-analysis/references/update_metric.md} +9 -9
- package/skills/{te-meta/references/update-project-mark-time.md → ae-analysis/references/update_project_mark_time.md} +3 -3
- package/skills/{te-analysis/references/update-public-access-link.md → ae-analysis/references/update_public_access_link.md} +3 -3
- package/skills/{te-audience/references/update-tag.md → ae-analysis/references/update_tag.md} +15 -14
- package/skills/ae-community/SKILL.md +305 -0
- package/skills/{te-community → ae-community}/references/community-activity-analysis.md +6 -7
- package/skills/{te-community → ae-community}/references/community-analyzing-official-content.md +3 -4
- package/skills/{te-community → ae-community}/references/community-analyzing-theme-comment.md +5 -6
- package/skills/{te-community → ae-community}/references/community-character-analysis.md +5 -6
- package/skills/{te-community → ae-community}/references/community-daily-report.md +7 -8
- package/skills/{te-community → ae-community}/references/community-hottopic-insight.md +4 -5
- package/skills/{te-community → ae-community}/references/community-weekly-report.md +7 -8
- package/skills/{te-community → ae-community}/references/get_channel_info.md +4 -5
- package/skills/{te-community → ae-community}/references/get_comment_tag_analysis.md +3 -4
- package/skills/{te-community → ae-community}/references/get_comments_summary.md +4 -5
- package/skills/{te-community → ae-community}/references/get_corpus_tags.md +3 -4
- package/skills/{te-community → ae-community}/references/get_daily_summary.md +3 -4
- package/skills/{te-community → ae-community}/references/get_hot_topics.md +3 -4
- package/skills/{te-community → ae-community}/references/get_livestream_analysis.md +3 -4
- package/skills/{te-community → ae-community}/references/get_livestream_detail.md +4 -5
- package/skills/{te-community → ae-community}/references/get_livestream_list.md +3 -4
- package/skills/{te-community → ae-community}/references/get_livestream_overview.md +3 -4
- package/skills/{te-community → ae-community}/references/get_livestream_room_metrics.md +3 -4
- package/skills/{te-community → ae-community}/references/get_livestream_rooms.md +3 -4
- package/skills/{te-community → ae-community}/references/get_overview_metrics.md +3 -4
- package/skills/{te-community → ae-community}/references/get_post_detail.md +4 -5
- package/skills/{te-community → ae-community}/references/get_risk_content.md +5 -6
- package/skills/{te-community → ae-community}/references/get_sentiment_overview.md +4 -5
- package/skills/{te-community → ae-community}/references/get_tag_trends.md +3 -4
- package/skills/{te-community → ae-community}/references/get_topic_detail.md +3 -4
- package/skills/{te-community → ae-community}/references/search_posts.md +5 -6
- package/skills/{te-dataops → ae-dataops}/SKILL.md +73 -10
- package/skills/{te-dataops → ae-dataops}/references/dataops-flow-create.md +1 -1
- package/skills/{te-dataops → ae-dataops}/references/dataops-flow-monitor.md +1 -1
- package/skills/{te-dataops → ae-dataops}/references/dataops-integration.md +1 -1
- package/skills/{te-dataops → ae-dataops}/references/dataops-query.md +1 -1
- package/skills/{te-dataops → ae-dataops}/references/dataops-table.md +1 -1
- package/skills/{te-engage → ae-engage}/SKILL.md +106 -6
- package/skills/{te-engage → ae-engage}/references/add-approver.md +2 -2
- package/skills/{te-engage → ae-engage}/references/add-channel.md +2 -2
- package/skills/{te-engage → ae-engage}/references/approver-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/cancel-query-by-request-id.md +2 -2
- package/skills/{te-engage → ae-engage}/references/channel-detail.md +2 -2
- package/skills/{te-engage → ae-engage}/references/channel-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-channel-detail.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-channel-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-item-analysis-report.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-item-detail.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-item-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-item-strategy-comparison.md +2 -2
- package/skills/{te-engage → ae-engage}/references/config-item-trigger-report.md +2 -2
- package/skills/{te-engage → ae-engage}/references/copy-config-template.md +2 -2
- package/skills/{te-engage → ae-engage}/references/delete-channel.md +2 -2
- package/skills/{te-engage → ae-engage}/references/delete-config-channel.md +2 -2
- package/skills/{te-engage → ae-engage}/references/delete-config-item.md +2 -2
- package/skills/{te-engage → ae-engage}/references/delete-flow.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-ab-split-node-report.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-detail.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-node-config-schema.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-node-detail-report.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-node-overview-report.md +2 -2
- package/skills/{te-engage → ae-engage}/references/flow-process-report.md +2 -2
- package/skills/{te-engage → ae-engage}/references/manage-flow.md +2 -2
- package/skills/{te-engage → ae-engage}/references/manage-strategy.md +2 -2
- package/skills/{te-engage → ae-engage}/references/manage-task.md +2 -2
- package/skills/{te-engage → ae-engage}/references/modify-flow-base-info.md +2 -2
- package/skills/{te-engage → ae-engage}/references/save-flow.md +3 -3
- package/skills/{te-engage → ae-engage}/references/strategy-detail.md +2 -2
- package/skills/{te-engage → ae-engage}/references/strategy-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/task-data-detail.md +3 -10
- package/skills/{te-engage → ae-engage}/references/task-data-overview.md +3 -9
- package/skills/{te-engage → ae-engage}/references/task-detail.md +2 -2
- package/skills/{te-engage → ae-engage}/references/task-experiment-report.md +3 -9
- package/skills/{te-engage → ae-engage}/references/task-list.md +2 -2
- package/skills/{te-engage → ae-engage}/references/task-metric-detail.md +3 -9
- package/skills/{te-engage → ae-engage}/references/task-stats.md +2 -2
- package/skills/{te-engage → ae-engage}/references/update-channel-status.md +2 -2
- package/skills/{te-engage → ae-engage}/references/update-config-channel-status.md +2 -2
- package/skills/{te-engage → ae-engage}/references/validate-flow-node-config.md +2 -2
- package/skills/{te-engage → ae-engage}/references/whitelist-list.md +2 -2
- package/dist/auth-JXELJNDS.js +0 -19
- package/dist/auth-L3G3A74I.js +0 -67
- package/dist/chunk-3GM5LJZR.js +0 -145
- package/dist/chunk-JD5DXMKL.js +0 -172
- package/dist/chunk-OVQOK35G.js +0 -108
- package/dist/chunk-RJNLN3KQ.js +0 -217
- package/dist/client-5QSQBBDB.js +0 -16
- package/dist/community-GMALVSRF.js +0 -684
- package/dist/config-Q7J3Z7Z2.js +0 -242
- package/dist/raw-ZNVURYMR.js +0 -59
- package/dist/te-analysis-7NN3SY3I.js +0 -871
- package/dist/te-audience-P43BWMHM.js +0 -350
- package/dist/te-common-H3IPTI2I.js +0 -144
- package/dist/te-dataops-WCGDBJLF.js +0 -1853
- package/dist/te-engage-UTRVNTGU.js +0 -1470
- package/dist/te-meta-HGYNXVGF.js +0 -479
- package/skills/te-analysis/SKILL.md +0 -107
- package/skills/te-analysis/references/get-analysis-query-schema.md +0 -36
- package/skills/te-analysis/references/list-public-access-links.md +0 -31
- package/skills/te-audience/SKILL.md +0 -63
- package/skills/te-audience/references/get-cluster-definition-schema.md +0 -37
- package/skills/te-audience/references/get-clusters-by-name.md +0 -32
- package/skills/te-audience/references/get-tag-definition-schema.md +0 -32
- package/skills/te-audience/references/get-tags-by-name.md +0 -32
- package/skills/te-common/SKILL.md +0 -135
- package/skills/te-community/SKILL.md +0 -125
- package/skills/te-meta/SKILL.md +0 -71
- package/skills/te-meta/references/list-metrics.md +0 -33
- package/skills/te-meta/references/list-project-mark-times.md +0 -33
- package/skills/te-shared/SKILL.md +0 -115
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: te-audience
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
description: "TE audience operations and targeting: create, update, query, recompute, and inspect member details for clusters and tags, plus cluster/tag definition schemas. Triggered when the user mentions audience building/targeting, audience packages, tag systems, tag assignment, tag member lookup, updating cluster rules, or recomputing clusters or tags."
|
|
5
|
-
metadata:
|
|
6
|
-
requires:
|
|
7
|
-
bins: ["ae-cli"]
|
|
8
|
-
cliHelp: "ae-cli analysis_audience --help"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# te-audience
|
|
12
|
-
|
|
13
|
-
> **CRITICAL - Before starting, MUST first read [`../te-shared/SKILL.md`](../te-shared/SKILL.md)**: authentication, host configuration, global parameters, and write-operation confirmation rules are defined there.
|
|
14
|
-
> **CRITICAL - Before performing write operations, MUST first read [`../te-common/SKILL.md`](../te-common/SKILL.md)**: shared post-action constraints (append resource links after create/update) are defined in that module.
|
|
15
|
-
> **CRITICAL - For every command that requires `project_id`, MUST follow `te-common`'s `PROJECT_ID_GATE` (if missing, stop and confirm with the user).**
|
|
16
|
-
> **CRITICAL - Before running any `+<tool_name>` command, MUST first read the corresponding reference document `./references/<tool-name>.md`** For example: before running `+create_cluster`, you must read [`./references/create-cluster.md`](./references/create-cluster.md)
|
|
17
|
-
|
|
18
|
-
## When to Use
|
|
19
|
-
|
|
20
|
-
Use `te-audience` when the user needs cluster and tag capabilities:
|
|
21
|
-
|
|
22
|
-
- Clusters: create, update, query, member inspection, recomputation
|
|
23
|
-
- Tags: create, update, query, member inspection, recomputation
|
|
24
|
-
- Cluster/tag definition schema: for frontend configurators or command argument construction
|
|
25
|
-
|
|
26
|
-
## Command Format
|
|
27
|
-
|
|
28
|
-
`ae-cli analysis_audience +<tool_name> [options]`
|
|
29
|
-
|
|
30
|
-
## Tool Groups (14)
|
|
31
|
-
|
|
32
|
-
### Clusters (6)
|
|
33
|
-
- `+create_cluster` ([Docs](./references/create-cluster.md))
|
|
34
|
-
- `+get_clusters_by_name` ([Docs](./references/get-clusters-by-name.md))
|
|
35
|
-
- `+list_cluster_members` ([Docs](./references/list-cluster-members.md))
|
|
36
|
-
- `+list_clusters` ([Docs](./references/list-clusters.md))
|
|
37
|
-
- `+update_cluster` ([Docs](./references/update-cluster.md))
|
|
38
|
-
- `+refresh_cluster` ([Docs](./references/refresh-cluster.md))
|
|
39
|
-
|
|
40
|
-
### Tags (6)
|
|
41
|
-
- `+create_tag` ([Docs](./references/create-tag.md))
|
|
42
|
-
- `+get_tags_by_name` ([Docs](./references/get-tags-by-name.md))
|
|
43
|
-
- `+list_tag_members` ([Docs](./references/list-tag-members.md))
|
|
44
|
-
- `+list_tags` ([Docs](./references/list-tags.md))
|
|
45
|
-
- `+update_tag` ([Docs](./references/update-tag.md))
|
|
46
|
-
- `+refresh_tag` ([Docs](./references/refresh-tag.md))
|
|
47
|
-
|
|
48
|
-
### Schema Definitions (2)
|
|
49
|
-
- `+get_cluster_definition_schema` ([Docs](./references/get-cluster-definition-schema.md))
|
|
50
|
-
- `+get_tag_definition_schema` ([Docs](./references/get-tag-definition-schema.md))
|
|
51
|
-
|
|
52
|
-
## Quick Validation
|
|
53
|
-
|
|
54
|
-
```bash
|
|
55
|
-
ae-cli analysis_audience --help
|
|
56
|
-
npm run verify:analysis-audience-tools
|
|
57
|
-
# Example: preview the request with dry-run (replace project_id with your actual project ID)
|
|
58
|
-
ae-cli analysis_audience +list_clusters --project_id <YOUR_PROJECT_ID> --dry-run
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## Reference Docs
|
|
62
|
-
|
|
63
|
-
See the `references/` directory (14 per-command documents total).
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
# analysis_audience +get_cluster_definition_schema (Get Cluster Definition Schema)
|
|
2
|
-
|
|
3
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
|
-
|
|
5
|
-
Domain: **Schema Query**
|
|
6
|
-
|
|
7
|
-
## Use Cases
|
|
8
|
-
- Support tool positioning: the current command provides the structure definition (schema) and should be used as a prerequisite step.
|
|
9
|
-
- Recommended sequence: first call this schema tool to get the structure, then call `analysis_meta +list_events` / `analysis_meta +list_properties` to obtain real metadata, and finally create or update clusters.
|
|
10
|
-
- Get the cluster definition schema. Supports the condition and sql cluster types and returns field definitions, enum descriptions, and examples.
|
|
11
|
-
|
|
12
|
-
## Commands
|
|
13
|
-
```bash
|
|
14
|
-
ae-cli analysis_audience +get_cluster_definition_schema --cluster_type condition
|
|
15
|
-
ae-cli analysis_audience +get_cluster_definition_schema --cluster_type sql
|
|
16
|
-
ae-cli analysis_audience +get_cluster_definition_schema --dry-run
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Parameters
|
|
20
|
-
| Parameter | Required | Description |
|
|
21
|
-
|---|---|---|
|
|
22
|
-
| `--cluster_type` | Yes | Cluster type. Supported values: condition and sql |
|
|
23
|
-
|
|
24
|
-
## Decision Rules
|
|
25
|
-
- `--cluster_type` must be explicitly set to `condition` or `sql`.
|
|
26
|
-
- It is recommended to run `--dry-run` first to inspect the request mapping before making the actual call.
|
|
27
|
-
- The current command returns only structure constraints; it does not guarantee that the field values are available in the target project. Event names and property names must be confirmed again with `analysis_meta` metadata interfaces.
|
|
28
|
-
- Before calling `analysis_meta +list_events` / `analysis_meta +list_properties`, first read their reference docs to confirm the parameter and return-field meanings.
|
|
29
|
-
|
|
30
|
-
## Next Step on Failure
|
|
31
|
-
- If reading fails, first verify whether the object ID exists and belongs to the current project.
|
|
32
|
-
- If the schema does not match expectations, confirm whether the correct schema interface was used (filter/groupby/query/tag/cluster).
|
|
33
|
-
|
|
34
|
-
## Recommended Chain
|
|
35
|
-
- First read: [`./get-cluster-definition-schema.md`](./get-cluster-definition-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)
|
|
36
|
-
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +create_cluster
|
|
37
|
-
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +update_cluster
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
# analysis_audience +get_clusters_by_name (Locate Clusters by Name)
|
|
2
|
-
|
|
3
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
|
-
|
|
5
|
-
Domain: **Cluster Management**
|
|
6
|
-
|
|
7
|
-
## Use Cases
|
|
8
|
-
- Get cluster definition details in batch by cluster name. Returns complete cluster information for matched clusters, including IDs, names, display names, types, status, user counts, and refresh status.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
```bash
|
|
12
|
-
ae-cli analysis_audience +get_clusters_by_name --project_id 1 --names '["demo"]'
|
|
13
|
-
ae-cli analysis_audience +get_clusters_by_name --dry-run
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
| Parameter | Required | Description |
|
|
18
|
-
|---|---|---|
|
|
19
|
-
| `--project_id` / `-p` | Yes | Project ID |
|
|
20
|
-
| `--names` | Yes | List of cluster names (JSON array). Exact-name matching is used; unmatched clusters are ignored automatically. |
|
|
21
|
-
|
|
22
|
-
## Decision Rules
|
|
23
|
-
- For the first execution, it is recommended to pass only the required parameters (`--project_id`, `--names`) and add optional parameters after confirming the path works.
|
|
24
|
-
- `--names` must be passed as a JSON array (e.g. `--names '["cluster_a","cluster_b"]'`).
|
|
25
|
-
- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
|
|
26
|
-
|
|
27
|
-
## Next Step on Failure
|
|
28
|
-
- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`, `--names`).
|
|
29
|
-
- If reading fails, first verify whether the object ID exists and belongs to the current project.
|
|
30
|
-
|
|
31
|
-
## Recommended Chain
|
|
32
|
-
- +list_clusters -> +get_clusters_by_name -> +update_cluster
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
# analysis_audience +get_tag_definition_schema (Get Tag Definition Schema)
|
|
2
|
-
|
|
3
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
|
-
|
|
5
|
-
Domain: **Schema Query**
|
|
6
|
-
|
|
7
|
-
## Use Cases
|
|
8
|
-
- Support tool positioning: the current command provides the structure definition (schema) and should be used as a prerequisite step.
|
|
9
|
-
- Recommended sequence: first call this schema tool to get the structure, then call specific business tools.
|
|
10
|
-
- Typical downstream tools: `+create_tag`, `+update_tag`
|
|
11
|
-
- Get the tag definition schema. Supports the condition, metric, first_last, and sql tag types and returns field definitions, enum descriptions, and examples.
|
|
12
|
-
|
|
13
|
-
## Commands
|
|
14
|
-
```bash
|
|
15
|
-
ae-cli analysis_audience +get_tag_definition_schema
|
|
16
|
-
ae-cli analysis_audience +get_tag_definition_schema --dry-run
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## Parameters
|
|
20
|
-
| Parameter | Required | Description |
|
|
21
|
-
|---|---|---|
|
|
22
|
-
| None | - | This command has no business parameters; call it directly. |
|
|
23
|
-
|
|
24
|
-
## Decision Rules
|
|
25
|
-
- It is recommended to run `--dry-run` first to inspect the request mapping before making the actual call.
|
|
26
|
-
|
|
27
|
-
## Next Step on Failure
|
|
28
|
-
- If reading fails, first verify whether the object ID exists and belongs to the current project.
|
|
29
|
-
- If the schema does not match expectations, confirm whether the correct schema interface was used (filter/groupby/query/tag/cluster).
|
|
30
|
-
|
|
31
|
-
## Recommended Chain
|
|
32
|
-
- +get_analysis_query_schema -> +get_filter_schema -> +get_groupby_schema
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
# analysis_audience +get_tags_by_name (Locate Tags by Name)
|
|
2
|
-
|
|
3
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
|
-
|
|
5
|
-
Domain: **Tag Management**
|
|
6
|
-
|
|
7
|
-
## Use Cases
|
|
8
|
-
- Get tag definition details in batch by tag name. Returns complete tag information for matched tags, including IDs, names, display names, types, status, user counts, and tag definitions.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
```bash
|
|
12
|
-
ae-cli analysis_audience +get_tags_by_name --project_id 1 --names '["demo"]'
|
|
13
|
-
ae-cli analysis_audience +get_tags_by_name --dry-run
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Parameters
|
|
17
|
-
| Parameter | Required | Description |
|
|
18
|
-
|---|---|---|
|
|
19
|
-
| `--project_id` / `-p` | Yes | Project ID |
|
|
20
|
-
| `--names` | Yes | List of tag names (JSON array). Exact-name matching is used; unmatched tags are ignored automatically. |
|
|
21
|
-
|
|
22
|
-
## Decision Rules
|
|
23
|
-
- For the first execution, it is recommended to pass only the required parameters (`--project_id`, `--names`) and add optional parameters after confirming the path works.
|
|
24
|
-
- `--names` must be passed as a JSON array (e.g. `--names '["tag_a","tag_b"]'`).
|
|
25
|
-
- When troubleshooting across projects, first confirm whether `--project_id` matches the current permissions and target environment.
|
|
26
|
-
|
|
27
|
-
## Next Step on Failure
|
|
28
|
-
- If required parameters are missing, fall back to the smallest runnable command and fill the gap (focus on `--project_id`, `--names`).
|
|
29
|
-
- If reading fails, first verify whether the object ID exists and belongs to the current project.
|
|
30
|
-
|
|
31
|
-
## Recommended Chain
|
|
32
|
-
- +list_tags -> +get_tags_by_name -> +update_tag
|
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: te-common
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
description: "TE cross-module common constraints: define the post-write flow after create/update operations (resource link completion, output conventions, failure fallback). Triggered when requirements involve shared rules across te-analysis/te-meta/te-audience."
|
|
5
|
-
metadata:
|
|
6
|
-
requires:
|
|
7
|
-
bins: ["ae-cli"]
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# te-common
|
|
11
|
-
|
|
12
|
-
> **CRITICAL - Before starting, MUST first read [`../te-shared/SKILL.md`](../te-shared/SKILL.md)**: authentication, host configuration, global parameters, and write-operation confirmation rules are all in there.
|
|
13
|
-
> **CRITICAL - Before executing any `+<tool_name>` command, MUST first read the corresponding reference document `./references/<tool-name>.md`** For example: before executing `+get_resource_url`, you must first read [`./references/get-resource-url.md`](./references/get-resource-url.md)
|
|
14
|
-
|
|
15
|
-
## When to Use
|
|
16
|
-
|
|
17
|
-
When the requirement belongs to the unified execution constraints across `te-analysis` / `te-meta` / `te-audience`, you must use `te-common` first:
|
|
18
|
-
|
|
19
|
-
- Post-write actions, such as resource link completion
|
|
20
|
-
- Unified output conventions and fallback policies
|
|
21
|
-
- Future cross-module common constraints
|
|
22
|
-
|
|
23
|
-
## Execution Sequence (AI Agent Must Follow)
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
[Start] → [Read command reference document] → [Execute write operation] → [Succeeded?]
|
|
27
|
-
↓ Yes
|
|
28
|
-
[Pause immediately, review the "write-operation post-link completion" section of this document]
|
|
29
|
-
↓
|
|
30
|
-
[Call +get_resource_url]
|
|
31
|
-
↓
|
|
32
|
-
[Output complete result + link]
|
|
33
|
-
↓
|
|
34
|
-
[End]
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
**Key point**: after a write operation succeeds → immediately go back to te-common, do not skip it.
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
|
-
## Current Mandatory Constraints (MUST)
|
|
42
|
-
|
|
43
|
-
### A. PROJECT_ID_GATE (preflight gate, no guessing)
|
|
44
|
-
|
|
45
|
-
- For any command about to be executed, you must first confirm whether that command requires `project_id` (per the corresponding `references/<tool-name>.md` document).
|
|
46
|
-
- **Regardless of whether the user provided a project name or project_id, you must first call `+list_projects` to retrieve the project list for verification.**
|
|
47
|
-
- Verification rules:
|
|
48
|
-
- If the user provided a number, you must find the matching project_id in the list
|
|
49
|
-
- If the user provided a name, you must find the matching project name in the list and obtain the corresponding project_id
|
|
50
|
-
- If no match is found, you must tell the user and show the available project list so they can choose again
|
|
51
|
-
- Before verification passes and the correct `project_id` is confirmed, do not call the target command.
|
|
52
|
-
|
|
53
|
-
Recommended interaction flow:
|
|
54
|
-
|
|
55
|
-
**Scenario 1: The user did not provide project information**
|
|
56
|
-
```text
|
|
57
|
-
This step requires project_id.
|
|
58
|
-
I will first list the available projects for you to choose from:
|
|
59
|
-
|
|
60
|
-
[Call +list_projects to display the project list]
|
|
61
|
-
|
|
62
|
-
Please choose one from the projects above (for example, reply with the project ID or the project name).
|
|
63
|
-
I will not execute the target command before you confirm.
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
**Scenario 2: The user provided a project name or ID**
|
|
67
|
-
```text
|
|
68
|
-
The project you mentioned is "xxx".
|
|
69
|
-
I will first verify whether this project exists:
|
|
70
|
-
|
|
71
|
-
[Call +list_projects to get the project list]
|
|
72
|
-
|
|
73
|
-
Verification result:
|
|
74
|
-
- ✅ Project "xxx" exists, project_id = 123
|
|
75
|
-
- Or ❌ Project "xxx" was not found, available projects are listed below: [display list]
|
|
76
|
-
|
|
77
|
-
Please confirm whether to use this project (project_id = 123) for the next operation.
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
### B. Write-operation post-link completion (mandatory closed loop)
|
|
81
|
-
|
|
82
|
-
**Trigger condition**: When any of the following commands succeeds, MUST enter the link completion flow:
|
|
83
|
-
|
|
84
|
-
| resource_type | Create command | Update command |
|
|
85
|
-
|---|---|---|
|
|
86
|
-
| `dashboard` | `+create_dashboard` | `+update_dashboard` |
|
|
87
|
-
| `report` | `+create_report` | - |
|
|
88
|
-
| `metric` | `+create_metric` | `+update_metric` |
|
|
89
|
-
| `alert` | `+create_alert` | `+update_alert` |
|
|
90
|
-
| `tag` | `+create_tag` | `+update_tag` |
|
|
91
|
-
| `cluster` | `+create_cluster`, `+create_result_cluster` | `+update_cluster` |
|
|
92
|
-
| `virtual_event` | `+create_virtual_event` | - |
|
|
93
|
-
| `event_virtual_prop` | `+create_virtual_property` (`--table_type event`) | - |
|
|
94
|
-
| `user_virtual_prop` | `+create_virtual_property` (`--table_type user`) | - |
|
|
95
|
-
| `super_event` | `+batch_create_metadata` (creating events) | `+batch_edit_metadata --type event` |
|
|
96
|
-
| `super_prop_event` | `+batch_create_metadata` (creating event_properties) | `+batch_edit_metadata --type event_property` |
|
|
97
|
-
| `super_prop_user` | `+batch_create_metadata` (creating user_properties) | `+batch_edit_metadata --type user_property` |
|
|
98
|
-
|
|
99
|
-
**Closed loop execution (must be completed)**:
|
|
100
|
-
1. ✅ Write operation succeeded → immediately check whether the return value contains `resource_id`
|
|
101
|
-
2. ✅ Has `resource_id` → call `+get_resource_url` (using the verified `project_id`)
|
|
102
|
-
3. ✅ Link generated successfully → output the complete response including the clickable link
|
|
103
|
-
4. ⚠️ Link generation failed → output the main result + explicitly state "link completion failed: [reason]"
|
|
104
|
-
|
|
105
|
-
**Multi-resource result handling (for batch metadata only)**:
|
|
106
|
-
- `+batch_create_metadata` / `+batch_edit_metadata` may return multiple resources at once (events/properties).
|
|
107
|
-
- For each resource from which `resource_id` can be extracted, you must call `+get_resource_url` separately.
|
|
108
|
-
- The final output must provide links for each resource one by one; if some fail, mark the failed items and the reasons, while the successful items are returned normally.
|
|
109
|
-
|
|
110
|
-
**Prohibited behaviors**:
|
|
111
|
-
- ❌ End the response immediately after a write operation succeeds (you must complete link completion or explain the failure)
|
|
112
|
-
- ❌ Treat a write operation as failed because link completion failed (the write result is independently valid)
|
|
113
|
-
|
|
114
|
-
**Closed-loop check template** (must explicitly confirm each step):
|
|
115
|
-
```
|
|
116
|
-
[Write operation result]
|
|
117
|
-
→ Check resource_id: [yes/no]
|
|
118
|
-
→ Call get_resource_url: [called / skipped (no ID)]
|
|
119
|
-
→ Link completion status: [successful link / failure reason / skipped]
|
|
120
|
-
→ Closed loop complete ✅
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
If the ID cannot be extracted or link generation fails, you must explain the failure reason, but you cannot roll back or judge the main write operation as failed.
|
|
124
|
-
|
|
125
|
-
## Execution Template
|
|
126
|
-
|
|
127
|
-
1. Execute the main write-operation command.
|
|
128
|
-
2. Extract `project_id`, `resource_type`, `resource_id` from the input or return value.
|
|
129
|
-
3. Call `ae-cli analysis_common +get_resource_url --project_id <id> --resource_type <type> --resource_id <id>`.
|
|
130
|
-
4. Output the main result + `markdown_link` (clickable) / `raw_url`.
|
|
131
|
-
|
|
132
|
-
## Unified Command Entry
|
|
133
|
-
|
|
134
|
-
- `+list_projects` ([documentation](./references/list-projects.md))
|
|
135
|
-
- `+get_resource_url` ([documentation](./references/get-resource-url.md))
|
|
@@ -1,125 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: te-community
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
description: "TE community analysis: post search, comment sentiment, topic trends, risky content, livestream data"
|
|
5
|
-
metadata:
|
|
6
|
-
requires:
|
|
7
|
-
bins: ["ae-cli"]
|
|
8
|
-
cliHelp: "ae-cli community --help"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# te-community
|
|
12
|
-
|
|
13
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../te-shared/SKILL.md) to learn about authentication, global parameters and security constraints.
|
|
14
|
-
|
|
15
|
-
## Overview
|
|
16
|
-
|
|
17
|
-
The `te-community` domain provides community social media data analysis capabilities, including post search, comment sentiment analysis, topic trends, risk content monitoring and livestream data.
|
|
18
|
-
|
|
19
|
-
Commands are invoked via `ae-cli community <command>`. **This document is mainly for navigation**: For specific usage, examples and Flags, see **`references/`** and each composite analysis reference below.
|
|
20
|
-
|
|
21
|
-
## Common parameters
|
|
22
|
-
|
|
23
|
-
| Parameters | Description |
|
|
24
|
-
|------|------|
|
|
25
|
-
| `--space-id` | Community space ID |
|
|
26
|
-
| `--game-id` | Game/space identification |
|
|
27
|
-
|
|
28
|
-
## Channel ID prerequisite: `get_channel_info`
|
|
29
|
-
|
|
30
|
-
A large number of subcommands rely on **`--channel-id`** or **`--channel-id-list`** (e.g. post details, comment summaries, live session lists, and channel-filtered search). If you only have `space-id` / `game-id` and do not yet know channel IDs, call `ae-cli community get_channel_info` first to retrieve channel IDs and names, then run follow-up commands. See [get_channel_info](references/get_channel_info.md) for details.
|
|
31
|
-
|
|
32
|
-
## Array parameter format
|
|
33
|
-
|
|
34
|
-
Multi-valued parameters are separated by commas:
|
|
35
|
-
```
|
|
36
|
-
--channel-id-list 1,2,3
|
|
37
|
-
--keywords tag1,tag2
|
|
38
|
-
--sentiment-types 0,1
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
## Date format
|
|
42
|
-
|
|
43
|
-
All date parameters use `yyyy-MM-dd` format, such as `--start-time 2024-01-01`.
|
|
44
|
-
|
|
45
|
-
## Reference documentation (subcommand navigation)
|
|
46
|
-
|
|
47
|
-
Open the corresponding file as needed to view instructions and examples (one page per command):
|
|
48
|
-
|
|
49
|
-
- Search posts or videos by keyword/time period: [search_posts](references/search_posts.md)
|
|
50
|
-
- Got the `post-id`, view the details of a single piece of content: [get_post_detail](references/get_post_detail.md)
|
|
51
|
-
- Query the list of available analysis tags: [get_corpus_tags](references/get_corpus_tags.md)
|
|
52
|
-
- Quickly view the overall sentiment and summary of the comment area: [get_comments_summary](references/get_comments_summary.md)
|
|
53
|
-
- Analyze the distribution and proportion of comment tags: [get_comment_tag_analysis](references/get_comment_tag_analysis.md)
|
|
54
|
-
- View sentiment trends (by time period): [get_sentiment_overview](references/get_sentiment_overview.md)
|
|
55
|
-
- View the community overview (posts, interactions, etc.): [get_overview_metrics](references/get_overview_metrics.md)
|
|
56
|
-
- Identify current hot topics: [get_hot_topics](references/get_hot_topics.md)
|
|
57
|
-
- Drill down to view the details of a topic: [get_topic_detail](references/get_topic_detail.md)
|
|
58
|
-
- Observe trends for specific tags: [get_tag_trends](references/get_tag_trends.md)
|
|
59
|
-
- Generate/view single-day community summary (daily): [get_daily_summary](references/get_daily_summary.md)
|
|
60
|
-
- Troubleshoot risk content and security compliance issues: [get_risk_content](references/get_risk_content.md)
|
|
61
|
-
- Get the list of livestream rooms and determine the room range: [get_livestream_rooms](references/get_livestream_rooms.md)
|
|
62
|
-
- View the live session history list: [get_livestream_list](references/get_livestream_list.md)
|
|
63
|
-
- Check the details of a livestream session: [get_livestream_detail](references/get_livestream_detail.md)
|
|
64
|
-
- Livestream session AI analysis report (highlight slices and emotional views): [get_livestream_analysis](references/get_livestream_analysis.md)
|
|
65
|
-
- Check the overall performance of the livestream module within the time period: [get_livestream_overview](references/get_livestream_overview.md)
|
|
66
|
-
- View the annual metrics of a single livestream room: [get_livestream_room_metrics](references/get_livestream_room_metrics.md)
|
|
67
|
-
- Get the channel list and basic channel information: [get_channel_info](references/get_channel_info.md)
|
|
68
|
-
|
|
69
|
-
## Advanced analysis skills
|
|
70
|
-
|
|
71
|
-
The following skills are called based on the MCP tool chain combination and are used to generate structured in-depth analysis.
|
|
72
|
-
|
|
73
|
-
### community-activity-analysis (activity-specific operation insight analysis)
|
|
74
|
-
|
|
75
|
-
In-depth evaluation of in-game activities or marketing events, including exposure impact, community sentiment, UGC ecosystem response, and long-tail effects.
|
|
76
|
-
|
|
77
|
-
For details, see: [`references/community-activity-analysis.md`](references/community-activity-analysis.md)
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
### community-daily-report (Daily Express)
|
|
82
|
-
|
|
83
|
-
Generate a concise "User Operations Daily Brief" covering single-day macro trends, breaking sentiment signals, and safety/compliance risks, with day-over-day comparison (T-1 vs T-2).
|
|
84
|
-
|
|
85
|
-
For details, see: [`references/community-daily-report.md`](references/community-daily-report.md)
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
### community-character-analysis (character-specific in-depth analysis)
|
|
90
|
-
|
|
91
|
-
In-depth analysis of specific game character ecology, players' emotional motivations and core needs, focusing on root causes rather than superficial phenomena.
|
|
92
|
-
|
|
93
|
-
For details, see: [`references/community-character-analysis.md`](references/community-character-analysis.md)
|
|
94
|
-
|
|
95
|
-
---
|
|
96
|
-
|
|
97
|
-
### community-hottopic-insight (topic analysis)
|
|
98
|
-
|
|
99
|
-
Build a "time -> event -> sentiment" evolution chain around a single topic and output an executive summary, key discussion clusters, sentiment slices, channel insights, and action recommendations.
|
|
100
|
-
|
|
101
|
-
For details, see: [`references/community-hottopic-insight.md`](references/community-hottopic-insight.md)
|
|
102
|
-
|
|
103
|
-
---
|
|
104
|
-
|
|
105
|
-
### community-weekly-report (weekly summary of community operations)
|
|
106
|
-
|
|
107
|
-
Summarize the data for the week, focus on connecting the core escalating discussion events of the week based on the "Daily Summary", and output a "Community Operations Weekly Summary Report."
|
|
108
|
-
|
|
109
|
-
For details, see: [`references/community-weekly-report.md`](references/community-weekly-report.md)
|
|
110
|
-
|
|
111
|
-
---
|
|
112
|
-
|
|
113
|
-
### community-analyzing-official-content (official content analysis)
|
|
114
|
-
|
|
115
|
-
Analyze recently published official content for a specified game in the community module, then classify and summarize it using the predefined categories.
|
|
116
|
-
|
|
117
|
-
For details, see: [`references/community-analyzing-official-content.md`](references/community-analyzing-official-content.md)
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
### community-analyzing-theme-comment (in-depth analysis of the theme comment area)
|
|
122
|
-
|
|
123
|
-
Conduct in-depth analysis of comments on specified posts or videos, then produce a report covering trend shifts, viewpoint distribution, and key takeaways.
|
|
124
|
-
|
|
125
|
-
For details, see: [`references/community-analyzing-theme-comment.md`](references/community-analyzing-theme-comment.md)
|
package/skills/te-meta/SKILL.md
DELETED
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: te-meta
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
description: "TE metadata and tracking-plan governance: event/property management, metric creation and updates, batch metadata editing, virtual events/properties, project configuration and members, tracking plans (track program), milestones/date markers (mark time), and entity catalog. Triggered when users mention editing tracking, tracking dictionaries, event/property governance, building metrics, checking project config, maintaining track programs, or managing mark time."
|
|
5
|
-
metadata:
|
|
6
|
-
requires:
|
|
7
|
-
bins: ["ae-cli"]
|
|
8
|
-
cliHelp: "ae-cli analysis_meta --help"
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# te-meta
|
|
12
|
-
|
|
13
|
-
> **CRITICAL - Before starting, MUST first read [`../te-shared/SKILL.md`](../te-shared/SKILL.md)**: authentication, host configuration, global parameters, and write-operation confirmation rules are all there.
|
|
14
|
-
> **CRITICAL - Before performing write operations, MUST first read [`../te-common/SKILL.md`](../te-common/SKILL.md)**: the unified post-operation constraints (resource-link completion after create/update) are defined there.
|
|
15
|
-
> **CRITICAL - For all commands that require `project_id`, MUST follow `te-common`'s `PROJECT_ID_GATE` (if missing, stop and confirm with the user).**
|
|
16
|
-
> **CRITICAL - Before running any `+<tool_name>` command, MUST first read the corresponding reference doc `./references/<tool-name>.md`**. For example: before running `+create_metric`, you must first read [`./references/create-metric.md`](./references/create-metric.md)
|
|
17
|
-
|
|
18
|
-
## When to Use
|
|
19
|
-
|
|
20
|
-
When the user needs "metadata governance and project configuration" capabilities, use `te-meta`:
|
|
21
|
-
|
|
22
|
-
- Event/property metadata queries: `+list_events`, `+list_properties`
|
|
23
|
-
- Metric and virtual metadata governance: metric / batch metadata / virtual event/property
|
|
24
|
-
- Project configuration: `+get_project_config`, `+list_project_users`
|
|
25
|
-
- Tracking plans and date markers: track program / mark time
|
|
26
|
-
- Entity catalog: `+list_entities`
|
|
27
|
-
|
|
28
|
-
## Command Format
|
|
29
|
-
|
|
30
|
-
`ae-cli analysis_meta +<tool_name> [options]`
|
|
31
|
-
|
|
32
|
-
## Tool Groups (20)
|
|
33
|
-
|
|
34
|
-
### Metadata and Governance (10)
|
|
35
|
-
- `+list_events` ([documentation](./references/list-events.md))
|
|
36
|
-
- `+list_properties` ([documentation](./references/list-properties.md))
|
|
37
|
-
- `+list_metrics` ([documentation](./references/list-metrics.md))
|
|
38
|
-
- `+get_metric` ([documentation](./references/get-metric.md))
|
|
39
|
-
- `+create_metric` ([documentation](./references/create-metric.md))
|
|
40
|
-
- `+update_metric` ([documentation](./references/update-metric.md))
|
|
41
|
-
- `+batch_edit_metadata` ([documentation](./references/batch-edit-metadata.md))
|
|
42
|
-
- `+batch_create_metadata` ([documentation](./references/batch-create-metadata.md))
|
|
43
|
-
- `+create_virtual_event` ([documentation](./references/create-virtual-event.md))
|
|
44
|
-
- `+create_virtual_property` ([documentation](./references/create-virtual-property.md))
|
|
45
|
-
|
|
46
|
-
### Project and Tracking (9)
|
|
47
|
-
- `+get_project_config` ([documentation](./references/get-project-config.md))
|
|
48
|
-
- `+list_project_users` ([documentation](./references/list-project-users.md))
|
|
49
|
-
- `+get_track_program` ([documentation](./references/get-track-program.md))
|
|
50
|
-
- `+save_track_items` ([documentation](./references/save-track-items.md))
|
|
51
|
-
- `+delete_track_items` ([documentation](./references/delete-track-items.md))
|
|
52
|
-
- `+create_project_mark_time` ([documentation](./references/create-project-mark-time.md))
|
|
53
|
-
- `+update_project_mark_time` ([documentation](./references/update-project-mark-time.md))
|
|
54
|
-
- `+list_project_mark_times` ([documentation](./references/list-project-mark-times.md))
|
|
55
|
-
- `+delete_project_mark_times` ([documentation](./references/delete-project-mark-times.md))
|
|
56
|
-
|
|
57
|
-
### Entity Catalog (1)
|
|
58
|
-
- `+list_entities` ([documentation](./references/list-entities.md))
|
|
59
|
-
|
|
60
|
-
## Quick Verification
|
|
61
|
-
|
|
62
|
-
```bash
|
|
63
|
-
ae-cli analysis_meta --help
|
|
64
|
-
npm run verify:analysis-meta-tools
|
|
65
|
-
# Example: use dry-run to preview the request (replace project_id with your actual project ID)
|
|
66
|
-
ae-cli analysis_meta +list_events --project_id <YOUR_PROJECT_ID> --dry-run
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
## Reference Docs
|
|
70
|
-
|
|
71
|
-
See the `references/` directory (20 per-command docs total).
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# analysis_meta +list_metrics (Metric Search)
|
|
2
|
-
|
|
3
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
|
-
|
|
5
|
-
Domain: **Metadata Query**
|
|
6
|
-
|
|
7
|
-
## Use Cases
|
|
8
|
-
- 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.
|
|
9
|
-
- List metric metadata in the project.
|
|
10
|
-
|
|
11
|
-
## Command
|
|
12
|
-
```bash
|
|
13
|
-
ae-cli analysis_meta +list_metrics --project_id 1
|
|
14
|
-
ae-cli analysis_meta +list_metrics --project_id 1 --query demo
|
|
15
|
-
ae-cli analysis_meta +list_metrics --dry-run
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
## Parameters
|
|
19
|
-
| Parameter | Required | Description |
|
|
20
|
-
|---|---|---|
|
|
21
|
-
| `--project_id` / `-p` | Yes | Project ID |
|
|
22
|
-
| `--query` / `-q` | No | Optional keyword filter. Performs fuzzy matching against metric names, display names, and remarks; if omitted, all metrics are returned. |
|
|
23
|
-
|
|
24
|
-
## Decision Rules
|
|
25
|
-
- First run should only pass the required parameter (`--project_id`), and add optional parameters only after the path is confirmed to work.
|
|
26
|
-
- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
|
|
27
|
-
|
|
28
|
-
## Next Steps After Failure
|
|
29
|
-
- If the required parameter is missing, fall back to the smallest runnable command and fill it in (focus on `--project_id`).
|
|
30
|
-
- If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
|
|
31
|
-
|
|
32
|
-
## Recommended Chaining
|
|
33
|
-
- +list_metrics -> +create_metric -> +get_metric
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# analysis_meta +list_project_mark_times (List Project Mark Times)
|
|
2
|
-
|
|
3
|
-
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
|
-
|
|
5
|
-
Domain: **Project Configuration**
|
|
6
|
-
|
|
7
|
-
## Use Cases
|
|
8
|
-
- List project date markers. Returns marker IDs, timestamps, content, and visibility status.
|
|
9
|
-
- List project date markers.
|
|
10
|
-
|
|
11
|
-
## Commands
|
|
12
|
-
```bash
|
|
13
|
-
ae-cli analysis_meta +list_project_mark_times --project_id 1
|
|
14
|
-
ae-cli analysis_meta +list_project_mark_times --project_id 1 --zone_offset 8
|
|
15
|
-
ae-cli analysis_meta +list_project_mark_times --dry-run
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
## Parameters
|
|
19
|
-
| Parameter | Required | Description |
|
|
20
|
-
|---|---|---|
|
|
21
|
-
| `--project_id` / `-p` | Yes | Project ID |
|
|
22
|
-
| `--zone_offset` | No | Marker time zone offset |
|
|
23
|
-
|
|
24
|
-
## Decision Rules
|
|
25
|
-
- For the first run, pass only the required parameter (`--project_id`) to confirm the path works, then add optional parameters.
|
|
26
|
-
- For cross-project troubleshooting, first confirm whether `--project_id` matches the current permissions and target environment.
|
|
27
|
-
|
|
28
|
-
## Next Steps After Failure
|
|
29
|
-
- If required parameters are missing, fall back to the smallest runnable command and fill them in first (focus on `--project_id`).
|
|
30
|
-
- If the result is empty, first confirm the project ID/keyword, then try loosening the filter conditions.
|
|
31
|
-
|
|
32
|
-
## Recommended Chaining
|
|
33
|
-
- +get_project_config -> +list_project_mark_times
|