@thinkingai/ae-cli 1.0.1 → 1.0.3

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.
Files changed (170) hide show
  1. package/README.md +16 -13
  2. package/dist/auth-BQC5DBE7.js +19 -0
  3. package/dist/auth-DXKYLMO7.js +81 -0
  4. package/dist/chunk-3CDLNXTD.js +218 -0
  5. package/dist/chunk-53FNNCZW.js +174 -0
  6. package/dist/chunk-EBFUVWIZ.js +127 -0
  7. package/dist/chunk-ZYXIGPG7.js +148 -0
  8. package/dist/client-T4VODLA6.js +16 -0
  9. package/dist/community-FVDAWGS4.js +684 -0
  10. package/dist/config-V7AXKDMB.js +242 -0
  11. package/dist/index.js +16 -15
  12. package/dist/raw-G3GKHAPZ.js +61 -0
  13. package/dist/te-analysis-CHFTDN55.js +871 -0
  14. package/dist/te-audience-M6LQY6M7.js +350 -0
  15. package/dist/te-common-BLQ7DVGC.js +144 -0
  16. package/dist/te-dataops-V4OTKY35.js +1853 -0
  17. package/dist/te-engage-DXE4R5EW.js +1470 -0
  18. package/dist/te-meta-FMM7KCVI.js +479 -0
  19. package/package.json +7 -5
  20. package/skills/te-analysis/SKILL.md +10 -10
  21. package/skills/te-analysis/references/build-entity-details-sql.md +10 -10
  22. package/skills/te-analysis/references/build-event-details-sql.md +10 -10
  23. package/skills/te-analysis/references/create-alert.md +4 -4
  24. package/skills/te-analysis/references/create-dashboard.md +4 -4
  25. package/skills/te-analysis/references/create-or-update-dashboard-note.md +4 -4
  26. package/skills/te-analysis/references/create-public-access-link.md +4 -4
  27. package/skills/te-analysis/references/create-report.md +10 -10
  28. package/skills/te-analysis/references/create-result-cluster.md +4 -4
  29. package/skills/te-analysis/references/drilldown-user-events.md +6 -6
  30. package/skills/te-analysis/references/drilldown-users.md +4 -4
  31. package/skills/te-analysis/references/get-alert-definition-schema.md +3 -3
  32. package/skills/te-analysis/references/get-alert.md +3 -3
  33. package/skills/te-analysis/references/get-analysis-query-schema.md +4 -4
  34. package/skills/te-analysis/references/get-filter-schema.md +3 -3
  35. package/skills/te-analysis/references/get-groupby-schema.md +3 -3
  36. package/skills/te-analysis/references/get-report-definition.md +3 -3
  37. package/skills/te-analysis/references/get-table-columns.md +3 -3
  38. package/skills/te-analysis/references/list-alerts.md +4 -4
  39. package/skills/te-analysis/references/list-dashboards.md +4 -4
  40. package/skills/te-analysis/references/list-public-access-links.md +3 -3
  41. package/skills/te-analysis/references/list-reports.md +4 -4
  42. package/skills/te-analysis/references/load-filters.md +4 -4
  43. package/skills/te-analysis/references/query-adhoc.md +10 -10
  44. package/skills/te-analysis/references/query-dashboard-detail.md +3 -3
  45. package/skills/te-analysis/references/query-dashboard-report-data.md +9 -9
  46. package/skills/te-analysis/references/query-entity-details.md +10 -10
  47. package/skills/te-analysis/references/query-event-details.md +10 -10
  48. package/skills/te-analysis/references/query-report-data.md +11 -11
  49. package/skills/te-analysis/references/update-alert.md +4 -4
  50. package/skills/te-analysis/references/update-dashboard.md +4 -4
  51. package/skills/te-analysis/references/update-public-access-link.md +4 -4
  52. package/skills/te-audience/SKILL.md +5 -5
  53. package/skills/te-audience/references/create-cluster.md +10 -10
  54. package/skills/te-audience/references/create-tag.md +10 -10
  55. package/skills/te-audience/references/get-cluster-definition-schema.md +9 -9
  56. package/skills/te-audience/references/get-clusters-by-name.md +3 -3
  57. package/skills/te-audience/references/get-tag-definition-schema.md +3 -3
  58. package/skills/te-audience/references/get-tags-by-name.md +3 -3
  59. package/skills/te-audience/references/list-cluster-members.md +4 -4
  60. package/skills/te-audience/references/list-clusters.md +4 -4
  61. package/skills/te-audience/references/list-tag-members.md +4 -4
  62. package/skills/te-audience/references/list-tags.md +4 -4
  63. package/skills/te-audience/references/refresh-cluster.md +3 -3
  64. package/skills/te-audience/references/refresh-tag.md +3 -3
  65. package/skills/te-audience/references/update-cluster.md +9 -9
  66. package/skills/te-audience/references/update-tag.md +10 -10
  67. package/skills/te-common/SKILL.md +2 -2
  68. package/skills/te-common/references/get-resource-url.md +5 -5
  69. package/skills/te-common/references/list-projects.md +3 -3
  70. package/skills/te-community/SKILL.md +61 -69
  71. package/skills/te-community/references/community-activity-analysis.md +43 -43
  72. package/skills/te-community/references/community-analyzing-official-content.md +47 -47
  73. package/skills/te-community/references/community-analyzing-theme-comment.md +87 -87
  74. package/skills/te-community/references/community-character-analysis.md +44 -44
  75. package/skills/te-community/references/community-daily-report.md +56 -53
  76. package/skills/te-community/references/community-hottopic-insight.md +81 -87
  77. package/skills/te-community/references/community-weekly-report.md +54 -53
  78. package/skills/te-community/references/get_channel_info.md +9 -9
  79. package/skills/te-community/references/get_comment_tag_analysis.md +15 -15
  80. package/skills/te-community/references/get_comments_summary.md +15 -15
  81. package/skills/te-community/references/get_corpus_tags.md +9 -9
  82. package/skills/te-community/references/get_daily_summary.md +10 -10
  83. package/skills/te-community/references/get_hot_topics.md +12 -12
  84. package/skills/te-community/references/get_livestream_analysis.md +9 -9
  85. package/skills/te-community/references/get_livestream_detail.md +19 -19
  86. package/skills/te-community/references/get_livestream_list.md +13 -13
  87. package/skills/te-community/references/get_livestream_overview.md +11 -11
  88. package/skills/te-community/references/get_livestream_room_metrics.md +12 -12
  89. package/skills/te-community/references/get_livestream_rooms.md +12 -12
  90. package/skills/te-community/references/get_overview_metrics.md +12 -12
  91. package/skills/te-community/references/get_post_detail.md +21 -21
  92. package/skills/te-community/references/get_risk_content.md +23 -23
  93. package/skills/te-community/references/get_sentiment_overview.md +16 -16
  94. package/skills/te-community/references/get_tag_trends.md +13 -13
  95. package/skills/te-community/references/get_topic_detail.md +12 -12
  96. package/skills/te-community/references/search_posts.md +26 -26
  97. package/skills/te-dataops/SKILL.md +390 -392
  98. package/skills/te-dataops/references/dataops-flow-create.md +87 -87
  99. package/skills/te-dataops/references/dataops-flow-monitor.md +65 -65
  100. package/skills/te-dataops/references/dataops-integration.md +90 -85
  101. package/skills/te-dataops/references/dataops-query.md +58 -58
  102. package/skills/te-dataops/references/dataops-table.md +63 -63
  103. package/skills/te-engage/SKILL.md +103 -103
  104. package/skills/te-engage/references/add-approver.md +11 -11
  105. package/skills/te-engage/references/add-channel.md +34 -34
  106. package/skills/te-engage/references/approver-list.md +8 -8
  107. package/skills/te-engage/references/cancel-query-by-request-id.md +10 -10
  108. package/skills/te-engage/references/channel-detail.md +13 -13
  109. package/skills/te-engage/references/channel-list.md +15 -15
  110. package/skills/te-engage/references/config-channel-detail.md +10 -10
  111. package/skills/te-engage/references/config-channel-list.md +11 -11
  112. package/skills/te-engage/references/config-item-analysis-report.md +21 -21
  113. package/skills/te-engage/references/config-item-detail.md +10 -10
  114. package/skills/te-engage/references/config-item-list.md +8 -8
  115. package/skills/te-engage/references/config-item-strategy-comparison.md +14 -14
  116. package/skills/te-engage/references/config-item-trigger-report.md +26 -26
  117. package/skills/te-engage/references/copy-config-template.md +16 -16
  118. package/skills/te-engage/references/delete-channel.md +11 -11
  119. package/skills/te-engage/references/delete-config-channel.md +11 -11
  120. package/skills/te-engage/references/delete-config-item.md +12 -12
  121. package/skills/te-engage/references/delete-flow.md +11 -11
  122. package/skills/te-engage/references/flow-ab-split-node-report.md +29 -29
  123. package/skills/te-engage/references/flow-detail.md +19 -19
  124. package/skills/te-engage/references/flow-list.md +8 -8
  125. package/skills/te-engage/references/flow-node-config-schema.md +11 -11
  126. package/skills/te-engage/references/flow-node-detail-report.md +30 -30
  127. package/skills/te-engage/references/flow-node-overview-report.md +27 -27
  128. package/skills/te-engage/references/flow-process-report.md +32 -32
  129. package/skills/te-engage/references/manage-flow.md +44 -44
  130. package/skills/te-engage/references/manage-strategy.md +37 -37
  131. package/skills/te-engage/references/manage-task.md +20 -20
  132. package/skills/te-engage/references/modify-flow-base-info.md +14 -14
  133. package/skills/te-engage/references/save-flow.md +264 -263
  134. package/skills/te-engage/references/strategy-detail.md +16 -16
  135. package/skills/te-engage/references/strategy-list.md +10 -10
  136. package/skills/te-engage/references/task-data-detail.md +47 -47
  137. package/skills/te-engage/references/task-data-overview.md +23 -23
  138. package/skills/te-engage/references/task-detail.md +18 -18
  139. package/skills/te-engage/references/task-experiment-report.md +26 -26
  140. package/skills/te-engage/references/task-list.md +35 -35
  141. package/skills/te-engage/references/task-metric-detail.md +31 -31
  142. package/skills/te-engage/references/task-stats.md +31 -31
  143. package/skills/te-engage/references/update-channel-status.md +13 -13
  144. package/skills/te-engage/references/update-config-channel-status.md +14 -14
  145. package/skills/te-engage/references/validate-flow-node-config.md +15 -15
  146. package/skills/te-engage/references/whitelist-list.md +8 -8
  147. package/skills/te-meta/SKILL.md +5 -5
  148. package/skills/te-meta/references/batch-create-metadata.md +4 -4
  149. package/skills/te-meta/references/batch-edit-metadata.md +3 -3
  150. package/skills/te-meta/references/create-metric.md +12 -12
  151. package/skills/te-meta/references/create-project-mark-time.md +4 -4
  152. package/skills/te-meta/references/create-virtual-event.md +10 -10
  153. package/skills/te-meta/references/create-virtual-property.md +8 -8
  154. package/skills/te-meta/references/delete-project-mark-times.md +3 -3
  155. package/skills/te-meta/references/delete-track-items.md +3 -3
  156. package/skills/te-meta/references/get-metric.md +3 -3
  157. package/skills/te-meta/references/get-project-config.md +3 -3
  158. package/skills/te-meta/references/get-track-program.md +3 -3
  159. package/skills/te-meta/references/list-entities.md +4 -4
  160. package/skills/te-meta/references/list-events.md +4 -4
  161. package/skills/te-meta/references/list-metrics.md +4 -4
  162. package/skills/te-meta/references/list-project-mark-times.md +4 -4
  163. package/skills/te-meta/references/list-project-users.md +3 -3
  164. package/skills/te-meta/references/list-properties.md +4 -4
  165. package/skills/te-meta/references/save-track-items.md +3 -3
  166. package/skills/te-meta/references/update-metric.md +10 -10
  167. package/skills/te-meta/references/update-project-mark-time.md +4 -4
  168. package/skills/te-shared/SKILL.md +8 -8
  169. package/skills/te-community/references/community-release-analysis.md +0 -79
  170. package/skills/te-dataops/references/dataops-operations.md +0 -107
@@ -1,122 +1,122 @@
1
1
  ---
2
2
  name: dataops-table
3
3
  version: 1.0.0
4
- description: "数据表与视图管理:搜索表、查看表详情、创建物理表/视图、批量创建关联视图。触发关键词:建表、创建表、视图、数据字典、表详情、关联视图、linkview、datatable、DDL。"
4
+ description: "Data table and view management: search tables, view table details, create physical tables/views, batch create linked views. Trigger keywords: create table, table creation, view, data dictionary, table details, linked view, linkview, datatable, DDL."
5
5
  metadata:
6
6
  requires:
7
- bins: ["te-cli"]
7
+ bins: ["ae-cli"]
8
8
  ---
9
9
 
10
- # DataOps 数据表与视图管理
10
+ # DataOps Data Table and View Management
11
11
 
12
- > **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
12
+ > **Prerequisites:** Read [`te-dataops/SKILL.md`](../SKILL.md) for general rules.
13
13
 
14
- 使用 `dataops_datatable` 子命令管理数据表。
14
+ Use the `dataops_datatable` subcommand to manage data tables.
15
15
 
16
- **核心规则:**
17
- - 空间任务表的创建/修改/删除**必须用 dataops_datatable**,禁止用 dataops_ide
18
- - 创建前先确认同名表不存在
19
- - 创建视图或数据表时,按照 **Trino DDL 规范**生成 DDL
20
- - 任务表先创建 DEV 环境,再创建 PROD 环境(可同时创建)
16
+ **Core Rules:**
17
+ - Creating/modifying/deleting workspace task tables **must use dataops_datatable**, prohibited to use dataops_ide
18
+ - Confirm no table with the same name exists before creation
19
+ - When creating views or data tables, generate DDL according to **Trino DDL specifications**
20
+ - Create task tables in DEV environment first, then PROD environment (can create simultaneously)
21
21
 
22
22
  ---
23
23
 
24
- ## 工作流 A:搜索并查看表信息
24
+ ## Workflow A: Search and View Table Information
25
25
 
26
26
  ```bash
27
- # 在数据字典中搜索表(按表名/说明模糊匹配)
28
- te-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "user" --maxResults 20
27
+ # Search tables in data dictionary (fuzzy match by table name/description)
28
+ ae-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "user" --maxResults 20
29
29
 
30
- # 获取表的详细信息(字段、DDL、数据血缘)
31
- te-cli dataops_datatable +get_table_detail --spaceCode "${spaceCode}" --tableName "dwd_user_info"
30
+ # Get detailed table information (fields, DDL, data lineage)
31
+ ae-cli dataops_datatable +get_table_detail --spaceCode "${spaceCode}" --tableName "dwd_user_info"
32
32
 
33
- # 分页查询空间已注册的表列表
34
- te-cli dataops_datatable +list_tables_by_page --spaceCode "${spaceCode}" --search "user" --pageNum 1 --pageSize 20
33
+ # Paginated query of registered tables in workspace
34
+ ae-cli dataops_datatable +list_tables_by_page --spaceCode "${spaceCode}" --search "user" --pageNum 1 --pageSize 20
35
35
 
36
- # 按仓库维度获取表层级结构(repo→catalog→schema→tables)
37
- te-cli dataops_datatable +struct_by_repo --spaceCode "${spaceCode}"
36
+ # Get table hierarchy by repository dimension (repo→catalog→schema→tables)
37
+ ae-cli dataops_datatable +struct_by_repo --spaceCode "${spaceCode}"
38
38
 
39
- # 搜索系统表(事件表、用户表、维度表)
40
- te-cli dataops_datatable +list_system_tables --spaceCode "${spaceCode}" --projectName "my_project"
39
+ # Search system tables (event tables, user tables, dimension tables)
40
+ ae-cli dataops_datatable +list_system_tables --spaceCode "${spaceCode}" --projectName "my_project"
41
41
  ```
42
42
 
43
43
  ---
44
44
 
45
- ## 工作流 B:创建物理表
45
+ ## Workflow B: Create Physical Table
46
46
 
47
47
  ```bash
48
- # Step 1: 确认同名表不存在
49
- te-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "dwd_user_info"
48
+ # Step 1: Confirm no table with same name exists
49
+ ae-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "dwd_user_info"
50
50
 
51
- # Step 2: 创建 DEV 环境的物理表(DDL 需遵循 Trino 规范)
52
- te-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
51
+ # Step 2: Create physical table in DEV environment (DDL must follow Trino specifications)
52
+ ae-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
53
53
  --ddl "CREATE TABLE dwd_user_info (user_id VARCHAR, user_name VARCHAR, age INTEGER) WITH (format = 'ORC')" \
54
54
  --repoCode "te_etl" --catalog "hive" --schema "ws_default_dev" --confirmed true
55
55
 
56
- # Step 3: 创建 PROD 环境的物理表(同样 DDL,schema 改为 product 库)
57
- te-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
56
+ # Step 3: Create physical table in PROD environment (same DDL, change schema to product database)
57
+ ae-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
58
58
  --ddl "CREATE TABLE dwd_user_info (user_id VARCHAR, user_name VARCHAR, age INTEGER) WITH (format = 'ORC')" \
59
59
  --repoCode "te_etl" --catalog "hive" --schema "ws_default_product" --confirmed true
60
60
  ```
61
61
 
62
62
  ---
63
63
 
64
- ## 工作流 C:创建视图
64
+ ## Workflow C: Create View
65
65
 
66
66
  ```bash
67
- # Step 1: 确认同名视图不存在
68
- te-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "v_user_info"
67
+ # Step 1: Confirm no view with same name exists
68
+ ae-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "v_user_info"
69
69
 
70
- # Step 2: 创建视图(未指定视图名时默认用 v_${来源表名})
71
- te-cli dataops_datatable +create_view --spaceCode "${spaceCode}" \
70
+ # Step 2: Create view (defaults to v_${source_table_name} if view name not specified)
71
+ ae-cli dataops_datatable +create_view --spaceCode "${spaceCode}" \
72
72
  --ddl "CREATE VIEW v_user_info AS SELECT user_id, user_name FROM hive.ws_default_dev.dwd_user_info" \
73
73
  --repoCode "te_etl" --catalog "hive" --schema "ws_default_dev" --confirmed true
74
74
  ```
75
75
 
76
76
  ---
77
77
 
78
- ## 工作流 D:批量创建直连视图
78
+ ## Workflow D: Batch Create Linked Views
79
79
 
80
80
  ```bash
81
- # Step 1: 列出可用于创建关联视图的源表
82
- te-cli dataops_datatable +linkview_list_source_tables --spaceCode "${spaceCode}" \
81
+ # Step 1: List source tables available for creating linked views
82
+ ae-cli dataops_datatable +linkview_list_source_tables --spaceCode "${spaceCode}" \
83
83
  --srcRepoCode "te_etl" --srcCatalog "hive" --srcSchema "ws_default_hidden"
84
84
 
85
- # Step 2: 批量创建直连视图(异步执行)
86
- te-cli dataops_datatable +batch_create --spaceCode "${spaceCode}" \
85
+ # Step 2: Batch create linked views (async execution)
86
+ ae-cli dataops_datatable +batch_create --spaceCode "${spaceCode}" \
87
87
  --srcRepoCode "te_etl" --srcCatalog "hive" --srcSchema "ws_default_hidden" \
88
88
  --processType 2 --batchCreationMode 1 --owner "${ownerOpenId}" \
89
89
  --viewInfos '[{"viewName":"v_orders","srcTableName":"ta_event_123","srcTableType":"TABLE"}]' \
90
90
  --confirmed true
91
91
 
92
- # Step 3: 轮询批量创建状态(建议 3-5 秒间隔)
92
+ # Step 3: Poll batch creation status (recommend 3-5 second interval)
93
93
  # status: WAIT / RUNNING / SUCCESS / STOP
94
- te-cli dataops_datatable +linkview_get_batch_status --spaceCode "${spaceCode}" --batchId "${batchId}"
94
+ ae-cli dataops_datatable +linkview_get_batch_status --spaceCode "${spaceCode}" --batchId "${batchId}"
95
95
 
96
- # 查看历史批量创建记录
97
- te-cli dataops_datatable +list_batches --spaceCode "${spaceCode}"
96
+ # View historical batch creation records
97
+ ae-cli dataops_datatable +list_batches --spaceCode "${spaceCode}"
98
98
  ```
99
99
 
100
100
  ---
101
101
 
102
- ## 命令速查
103
-
104
- | 命令 | 用途 | 关键 Flags |
105
- |------|------|-----------|
106
- | `+dict_search_tables` | 数据字典搜索 | `--spaceCode` `--search` `--maxResults` |
107
- | `+get_table_detail` | 表详情 | `--spaceCode` `--tableName` |
108
- | `+list_tables_by_page` | 分页列表 | `--spaceCode` `--search` `--pageNum` `--pageSize` |
109
- | `+struct_by_repo` | 按仓库层级 | `--spaceCode` `--search` |
110
- | `+list_system_tables` | 系统表列表 | `--spaceCode` `--projectId`/`--projectName` `--pageNum` `--pageSize` |
111
- | `+create_table` | 创建物理表 | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
112
- | `+create_view` | 创建视图 | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
113
- | `+batch_create` | 批量创建视图 | `--spaceCode` `--srcRepoCode` `--srcCatalog` `--srcSchema` `--processType` `--batchCreationMode` `--owner` `--viewInfos` `--confirmed` |
114
- | `+linkview_get_batch_status` | 批量创建状态 | `--spaceCode` `--batchId` |
115
- | `+list_batches` | 历史批量记录 | `--spaceCode` `--status` |
116
-
117
- ## 参数说明
118
-
119
- - **schema 命名**: DEV 环境用 `ws_${spaceCode}_dev`,PROD 环境用 `ws_${spaceCode}_product`
120
- - **processType**: `1`=仅 DEV | `2`=DEV+PROD
121
- - **batchCreationMode**: `1`=全量同步 | `2`=失败重试
122
- - **表名规则**: `^[a-z][0-9a-z_]{0,127}$`
102
+ ## Command Quick Reference
103
+
104
+ | Command | Purpose | Key Flags |
105
+ |---------|---------|-----------|
106
+ | `+dict_search_tables` | Data dictionary search | `--spaceCode` `--search` `--maxResults` |
107
+ | `+get_table_detail` | Table details | `--spaceCode` `--tableName` |
108
+ | `+list_tables_by_page` | Paginated list | `--spaceCode` `--search` `--pageNum` `--pageSize` |
109
+ | `+struct_by_repo` | By repository hierarchy | `--spaceCode` `--search` |
110
+ | `+list_system_tables` | System table list | `--spaceCode` `--projectId`/`--projectName` `--pageNum` `--pageSize` |
111
+ | `+create_table` | Create physical table | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
112
+ | `+create_view` | Create view | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
113
+ | `+batch_create` | Batch create views | `--spaceCode` `--srcRepoCode` `--srcCatalog` `--srcSchema` `--processType` `--batchCreationMode` `--owner` `--viewInfos` `--confirmed` |
114
+ | `+linkview_get_batch_status` | Batch creation status | `--spaceCode` `--batchId` |
115
+ | `+list_batches` | Historical batch records | `--spaceCode` `--status` |
116
+
117
+ ## Parameter Notes
118
+
119
+ - **schema naming**: DEV environment uses `ws_${spaceCode}_dev`, PROD environment uses `ws_${spaceCode}_product`
120
+ - **processType**: `1`=DEV only | `2`=DEV+PROD
121
+ - **batchCreationMode**: `1`=full sync | `2`=retry failures
122
+ - **Table name rule**: `^[a-z][0-9a-z_]{0,127}$`
@@ -1,211 +1,211 @@
1
1
  ---
2
2
  name: te-engage
3
3
  version: 1.0.0
4
- description: "TE Engage MCP:配置项、流程、渠道设置、任务数据查询与管理"
4
+ description: "TE Engage MCP: config items, flows, channel settings, task data query, and management"
5
5
  metadata:
6
6
  requires:
7
- bins: ["te-cli"]
8
- cliHelp: "te-cli te-engage --help"
7
+ bins: ["ae-cli"]
8
+ cliHelp: "ae-cli engage --help"
9
9
  ---
10
10
 
11
11
  # te-engage
12
12
 
13
- > **前置条件:** 阅读 [`../te-shared/SKILL.md`](../te-shared/SKILL.md) 了解认证、全局参数和安全约束。
13
+ > **Prerequisite:** Read [`../te-shared/SKILL.md`](../te-shared/SKILL.md) for authentication, global parameters, and safety constraints.
14
14
 
15
- ## 概述
15
+ ## Overview
16
16
 
17
- `te-engage` 域提供 Hermes Engage MCP 能力,覆盖配置项、流程、渠道设置和任务数据。命令通过 `te-cli te-engage <command>` 调用。
17
+ The `te-engage` package provides Hermes Engage MCP capabilities across config items, flows, channel settings, and task data. Commands are invoked through `ae-cli engage <command>`.
18
18
 
19
- 适合的场景包括:
19
+ Typical use cases include:
20
20
 
21
- - 查询和管理渠道、配置通道、审批人、白名单
22
- - 查询任务列表、任务详情、实验报表、指标报表
23
- - 查询配置项与策略、复制模板、管理策略状态
24
- - 查询流程列表、节点 schema、流程报表,以及保存/管理流程
21
+ - Querying and managing channels, config channels, approvers, and whitelists
22
+ - Querying task lists, task details, experiment reports, and metric reports
23
+ - Querying config items and strategies, copying templates, and managing strategy status
24
+ - Querying flow lists, node schemas, and flow reports, and saving or managing flows
25
25
 
26
- ## 参数约定
26
+ ## Parameter Conventions
27
27
 
28
- - 简单参数直接使用普通 flags,例如 `--project-id`、`--task-id`、`--flow-uuid`
29
- - 数组参数使用 JSON flags,例如 `--strategy-id-list '["id1","id2"]'`
30
- - 对象参数使用具名 JSON flags,例如 `--req '{...}'`、`--flow-list '[...]'`
31
- - 可选全局参数仍可与其他 domain 一样使用,例如 `--host`、`--mcp-url`、`--dry-run`
28
+ - Use regular flags for simple parameters, for example `--project_id`, `--task_id`, and `--flow_uuid`
29
+ - Use JSON flags for array parameters, for example `--strategy_id_list '["id1","id2"]'`
30
+ - Use named JSON flags for object parameters, for example `--req '{...}'` and `--flow_list '[...]'`
31
+ - Optional global parameters work the same way as in other domains, for example `--host`, `--mcp-url`, and `--dry-run`
32
32
 
33
- ## JSON 参数格式
33
+ ## JSON Parameter Format
34
34
 
35
- 常见 JSON flags 示例:
35
+ Common JSON flag examples:
36
36
 
37
37
  ```bash
38
- --provider-list '["webhook","fcm"]'
39
- --strategy-id-list '["strategy_a","strategy_b"]'
40
- --flow-id-list '["flow_1","flow_2"]'
38
+ --provider_list '["webhook","fcm"]'
39
+ --strategy_id_list '["strategy_a","strategy_b"]'
40
+ --flow_id_list '["flow_1","flow_2"]'
41
41
  --req '{"pageNum":1,"pageSize":20}'
42
42
  ```
43
43
 
44
- ## 常见场景
44
+ ## Common Scenarios
45
45
 
46
46
  ### 1. setting
47
47
 
48
48
  ```bash
49
- # 查询渠道列表
50
- te-cli te-engage +channel-list --project-id 1
49
+ # Query the channel list
50
+ ae-cli engage +channel_list --project_id 1
51
51
 
52
- # 过滤 provider
53
- te-cli te-engage +channel-list --project-id 1 --provider-list '["webhook","fcm"]'
52
+ # Filter by provider
53
+ ae-cli engage +channel_list --project_id 1 --provider_list '["webhook","fcm"]'
54
54
 
55
- # 查询 config channel
56
- te-cli te-engage +config-channel-list --project-id 1
55
+ # Query config channels
56
+ ae-cli engage +config_channel_list --project_id 1
57
57
  ```
58
58
 
59
59
  ### 2. task
60
60
 
61
61
  ```bash
62
- # 查询任务列表
63
- te-cli te-engage +task-list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
62
+ # Query the task list
63
+ ae-cli engage +task_list --project_id 1 --req '{"pageNum":1,"pageSize":20}'
64
64
 
65
- # 查询任务详情
66
- te-cli te-engage +task-detail --project-id 1 --task-id task_123
65
+ # Query task details
66
+ ae-cli engage +task_detail --project_id 1 --task_id task_123
67
67
 
68
- # 查询任务概览
69
- te-cli te-engage +task-data-overview --project-id 1 --task-id task_123 --task-type normal
68
+ # Query the task overview
69
+ ae-cli engage +task_data_overview --project_id 1 --task_id task_123 --task_type normal
70
70
  ```
71
71
 
72
72
  ### 3. config
73
73
 
74
74
  ```bash
75
- # 查询配置项列表
76
- te-cli te-engage +config-item-list --project-id 1
75
+ # Query the config item list
76
+ ae-cli engage +config_item_list --project_id 1
77
77
 
78
- # 查询策略列表
79
- te-cli te-engage +strategy-list --project-id 1 --config-id cfg_123
78
+ # Query the strategy list
79
+ ae-cli engage +strategy_list --project_id 1 --config_id cfg_123
80
80
 
81
- # 查询配置项报表
82
- te-cli te-engage +config-item-trigger-report \
83
- --project-id 1 --config-id cfg_123 \
84
- --start-time 2026-04-01 --end-time 2026-04-07
81
+ # Query a config item report
82
+ ae-cli engage +config_item_trigger_report \
83
+ --project_id 1 --config_id cfg_123 \
84
+ --start_time 2026-04-01 --end_time 2026-04-07
85
85
  ```
86
86
 
87
87
  ### 4. flow
88
88
 
89
89
  ```bash
90
- # 查询流程列表
91
- te-cli te-engage +flow-list --project-id 1
90
+ # Query the flow list
91
+ ae-cli engage +flow_list --project_id 1
92
92
 
93
- # 查询流程详情
94
- te-cli te-engage +flow-detail --project-id 1 --flow-uuid flow_uuid_123
93
+ # Query flow details
94
+ ae-cli engage +flow_detail --project_id 1 --flow_uuid flow_uuid_123
95
95
 
96
- # 查询节点 schema
97
- te-cli te-engage +flow-node-config-schema --node-type message_push
96
+ # Query the node schema
97
+ ae-cli engage +flow_node_config_schema --node_type message_push
98
98
  ```
99
99
 
100
- ## `+save-flow` 关键约束
100
+ ## `+save_flow` Critical Constraints
101
101
 
102
- 当用户要“创建流程 / 生成流程画布 / 保存流程”时,不要把 `+save-flow` 当成普通单命令直接调用,必须按下面流程执行。
102
+ When the user wants to "create a flow / generate a flow canvas / save a flow", do not treat `+save_flow` as a normal single command. You must follow the workflow below.
103
103
 
104
- ### 必须遵守的工作流
104
+ ### Required Workflow
105
105
 
106
- 1. 先确认用户意图已经足够明确,至少要有:
107
- - 业务场景
108
- - 目标用户
109
- - 触达方式
110
- - 是否分流,以及分流条件
111
- 2. 不要从自然语言直接跳到 `--req`,必须先整理出稳定的中间意图结构,再映射成最终 `req`。
112
- 3. 在构造条件相关节点前,必须先调用:
106
+ 1. First confirm that the user intent is specific enough. At minimum you need:
107
+ - The business scenario
108
+ - The target users
109
+ - The touchpoint or delivery method
110
+ - Whether branching is needed, and the branching conditions
111
+ 2. Do not jump directly from natural language to `--req`. You must first organize a stable intermediate intent structure, then map it to the final `req`.
112
+ 3. Before building any condition-related nodes, you must call:
113
113
 
114
114
  ```bash
115
- te-cli te_audience +get_cluster_definition_schema --cluster_type condition
115
+ ae-cli analysis_audience +get_cluster_definition_schema --cluster_type condition
116
116
  ```
117
117
 
118
- 4. 在构造 `message_push`、`wechat_push`、`webhook_push` 等触达节点前,必须先调用:
118
+ 4. Before building touchpoint nodes such as `message_push`, `wechat_push`, or `webhook_push`, you must call:
119
119
 
120
120
  ```bash
121
- te-cli te-engage +channel-list --project-id <projectId>
121
+ ae-cli engage +channel_list --project_id <projectId>
122
122
  ```
123
123
 
124
- 5. `+save-flow` 的最终 `--req` 必须是完整画布请求体,而不是意图描述。至少应包含:
124
+ 5. The final `--req` for `+save_flow` must be the complete canvas request payload, not an intent description. It must contain at least:
125
125
  - `flowName`
126
126
  - `flowDesc`
127
127
  - `nodeList`
128
128
  - `edgeList`
129
- 6. `nodeList[].config` 和 `edgeList[].config` 必须是 JSON 字符串,不是 JSON 对象。
130
- 7. `targetClusterQp` 如果出现在节点 `config` 中,其值通常也应是再次 `JSON.stringify` 后的字符串,而不是原始对象。
131
- 8. 提交前必须自检:
132
- - 只有一个入口节点
133
- - 至少一个 `exit_flow`
134
- - `edge.source` / `edge.target` 都引用有效节点
135
- - 分支节点的 `sourceBranchId` 已在上游节点 `config` 中声明
136
- - 整张图是 DAG,不能有环
129
+ 6. `nodeList[].config` and `edgeList[].config` must be JSON strings, not JSON objects.
130
+ 7. If `targetClusterQp` appears inside a node `config`, its value should usually also be a string produced by `JSON.stringify`, not a raw object.
131
+ 8. You must self-check before submitting:
132
+ - There is exactly one entry node
133
+ - There is at least one `exit_flow`
134
+ - `edge.source` and `edge.target` both reference valid nodes
135
+ - Any branch node `sourceBranchId` has already been declared in the upstream node `config`
136
+ - The whole graph is a DAG and contains no cycles
137
137
 
138
- ### 明确禁止
138
+ ### Explicitly Forbidden
139
139
 
140
- - 不要凭空编造 `channelId`
141
- - 不要在用户信息不足时自行脑补分流逻辑
142
- - 不要把业务语义节点直接当成最终 `nodeList` 节点提交
143
- - 不要把 `config` 写成对象后直接塞进 `--req`
140
+ - Do not invent a `channelId`
141
+ - Do not fill in branching logic when the user has not provided enough information
142
+ - Do not submit business-semantic nodes directly as final `nodeList` nodes
143
+ - Do not put `config` into `--req` as an object
144
144
 
145
- ### 推荐顺序
145
+ ### Recommended Order
146
146
 
147
147
  ```text
148
- 用户需求
149
- -> 整理意图
150
- -> te_audience +get_cluster_definition_schema --cluster_type condition
151
- -> +channel-list --project-id <projectId>
152
- -> 构造 nodeList / edgeList
153
- -> 自检
154
- -> +save-flow
148
+ User request
149
+ -> Organize intent
150
+ -> analysis_audience +get_cluster_definition_schema --cluster_type condition
151
+ -> +channel_list --project_id <projectId>
152
+ -> Build nodeList / edgeList
153
+ -> Self-check
154
+ -> +save_flow
155
155
  ```
156
156
 
157
- 更细的生成规则优先参考:
157
+ For more detailed generation rules, consult these references first:
158
158
 
159
159
  - `references/save-flow.md`
160
160
  - `references/flow-node-config-schema.md`
161
161
  - `references/validate-flow-node-config.md`
162
162
 
163
- ## dry-run 调试
163
+ ## Dry-Run Debugging
164
164
 
165
165
  ```bash
166
- te-cli --dry-run te-engage +channel-list --project-id 1
167
- te-cli --dry-run te-engage +task-list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
168
- te-cli --dry-run te-engage +flow-list --project-id 1
166
+ ae-cli --dry-run engage +channel_list --project_id 1
167
+ ae-cli --dry-run engage +task_list --project_id 1 --req '{"pageNum":1,"pageSize":20}'
168
+ ae-cli --dry-run engage +flow_list --project_id 1
169
169
  ```
170
170
 
171
171
  ## References
172
172
 
173
- 更细的单命令说明见按业务拆分的 `references/` 目录:
173
+ More detailed single-command guidance is available in the business-oriented `references/` directory:
174
174
 
175
175
  - `references/channel-list.md`
176
176
  - `references/task-list.md`
177
177
  - `references/config-item-list.md`
178
178
  - `references/flow-list.md`
179
179
 
180
- 这种拆包方式更适合后续继续扩展,因为对象入参较复杂的命令会集中在 `references/` 根目录维护。
180
+ This split documentation structure is easier to extend later, because commands with more complex object inputs can stay centralized in the `references/` root directory.
181
181
 
182
- ## 命令分组
182
+ ## Command Groups
183
183
 
184
184
  ### setting
185
185
 
186
- `+channel-list`, `+channel-detail`, `+update-channel-status`, `+delete-channel`, `+add-channel`, `+whitelist-list`, `+add-approver`, `+approver-list`, `+cancel-query-by-request-id`, `+config-channel-detail`, `+config-channel-list`, `+delete-config-channel`, `+update-config-channel-status`
186
+ `+channel_list`, `+channel_detail`, `+update_channel_status`, `+delete_channel`, `+add_channel`, `+whitelist_list`, `+add_approver`, `+approver_list`, `+cancel_query_by_request_id`, `+config_channel_detail`, `+config_channel_list`, `+delete_config_channel`, `+update_config_channel_status`
187
187
 
188
188
  ### task
189
189
 
190
- `+task-data-overview`, `+task-data-detail`, `+task-metric-detail`, `+task-experiment-report`, `+task-detail`, `+task-list`, `+task-stats`, `+manage-task`
190
+ `+task_data_overview`, `+task_data_detail`, `+task_metric_detail`, `+task_experiment_report`, `+task_detail`, `+task_list`, `+task_stats`, `+manage_task`
191
191
 
192
192
  ### config
193
193
 
194
- `+config-item-trigger-report`, `+config-item-analysis-report`, `+config-item-strategy-comparison`, `+config-item-list`, `+config-item-detail`, `+delete-config-item`, `+copy-config-template`, `+strategy-list`, `+strategy-detail`, `+manage-strategy`
194
+ `+config_item_trigger_report`, `+config_item_analysis_report`, `+config_item_strategy_comparison`, `+config_item_list`, `+config_item_detail`, `+delete_config_item`, `+copy_config_template`, `+strategy_list`, `+strategy_detail`, `+manage_strategy`
195
195
 
196
196
  ### flow
197
197
 
198
- `+save-flow`, `+flow-node-config-schema`, `+flow-detail`, `+flow-list`, `+flow-node-overview-report`, `+manage-flow`, `+flow-ab-split-node-report`, `+flow-process-report`, `+validate-flow-node-config`, `+flow-node-detail-report`, `+delete-flow`, `+modify-flow-base-info`
198
+ `+save_flow`, `+flow_node_config_schema`, `+flow_detail`, `+flow_list`, `+flow_node_overview_report`, `+manage_flow`, `+flow_ab_split_node_report`, `+flow_process_report`, `+validate_flow_node_config`, `+flow_node_detail_report`, `+delete_flow`, `+modify_flow_base_info`
199
199
 
200
- ## 日期格式
200
+ ## Date Format
201
201
 
202
- 涉及日期参数的命令通常使用 `yyyy-MM-dd`,例如 `--start-time 2026-04-01`。
202
+ Commands that accept date parameters usually use `yyyy-MM-dd`, for example `--start_time 2026-04-01`.
203
203
 
204
- ## 写操作提醒
204
+ ## Write Operation Reminder
205
205
 
206
- 以下命令属于写操作,执行前应确认用户明确意图:
206
+ The following commands are write operations. Confirm that the user intent is explicit before executing them:
207
207
 
208
- - 渠道与配置通道:`+add-channel`, `+delete-channel`, `+update-channel-status`, `+delete-config-channel`, `+update-config-channel-status`
209
- - 策略与配置项:`+delete-config-item`, `+copy-config-template`, `+manage-strategy`
210
- - 流程:`+save-flow`, `+modify-flow-base-info`, `+manage-flow`, `+delete-flow`
211
- - 任务:`+manage-task`
208
+ - Channels and config channels: `+add_channel`, `+delete_channel`, `+update_channel_status`, `+delete_config_channel`, `+update_config_channel_status`
209
+ - Strategies and config items: `+delete_config_item`, `+copy_config_template`, `+manage_strategy`
210
+ - Flows: `+save_flow`, `+modify_flow_base_info`, `+manage_flow`, `+delete_flow`
211
+ - Tasks: `+manage_task`
@@ -1,24 +1,24 @@
1
- # te-engage +add-approver
1
+ # te-engage +add_approver
2
2
 
3
- > **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
3
+ > **Prerequisite:** Read [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
4
4
 
5
- 批量添加审批人。
5
+ Batch add approvers.
6
6
 
7
- 映射命令: `te-cli te-engage +add-approver`
7
+ Mapped command: `ae-cli engage +add_approver`
8
8
 
9
9
  ## Flags
10
10
 
11
- | Flag | 类型 | 必填 | 说明 |
11
+ | Flag | Type | Required | Description |
12
12
  |------|------|------|------|
13
- | `--project-id` / `-p` | number | 是 | 项目 ID |
14
- | `--approvers` | json | 是 | 审批人 open ID JSON 数组 |
13
+ | `--project_id` / `-p` | number | Yes | Project ID |
14
+ | `--approvers` | json | Yes | approver open ID JSON array |
15
15
 
16
- ## 安全约束
16
+ ## Safety Constraints
17
17
 
18
- 此命令为 **写操作**,会修改项目审批人配置。
18
+ This command is a **write operation** and and modifies the project approver configuration.
19
19
 
20
- ## 示例
20
+ ## Examples
21
21
 
22
22
  ```bash
23
- te-cli te-engage +add-approver --project-id 1 --approvers '["ou_xxx","ou_yyy"]'
23
+ ae-cli engage +add_approver --project_id 1 --approvers '["ou_xxx","ou_yyy"]'
24
24
  ```