@thinkingai/ae-cli 1.0.1

package/skills/te-dataops/references/dataops-query.md

@@ -0,0 +1,111 @@
+---
+name: dataops-query
+version: 1.0.0
+description: "数据探索与 SQL 查询：浏览数仓元数据、搜索表、执行 SQL 查询、获取结果。触发关键词：查询、SQL、数据探索、搜索表、查看表结构、浏览数据、IDE、catalog、select。"
+metadata:
+  requires:
+    bins: ["te-cli"]
+---
+
+# DataOps 数据探索与 SQL 查询
+
+> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
+
+使用 `dataops_ide` 子命令进行数据探索和 SQL 查询。
+
+**核心规则：IDE 只允许查询操作，禁止创建/修改/删除数据表（任务表 DDL 请用 dataops_datatable）。**
+
+---
+
+## 工作流 A：浏览数仓元数据
+
+逐步探索数据仓库结构：仓库 → catalog → schema → 表 → 列。
+
+```bash
+# Step 1: 列出可用仓库
+te-cli dataops_ide +list_repos --spaceCode "${spaceCode}"
+
+# Step 2: 列出仓库下所有 catalog 及其 schema
+te-cli dataops_ide +list_catalogs --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}"
+
+# Step 3: 列出 schema 下的表/视图
+te-cli dataops_ide +list_tables --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
+  --catalog "${catalog}" --schema "${schema}" --isView false --pageNum 1 --pageSize 100
+
+# Step 4: 获取表的详细元数据（列定义、DDL、分区、行数）
+te-cli dataops_ide +get_table_detail --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
+  --catalog "${catalog}" --schema "${schema}" --tableName "${tableName}" \
+  --engineType "TASK_ENGINE_TRINO" --isView false
+```
+
+---
+
+## 工作流 B：搜索并查看表
+
+当不知道表的确切位置时，通过关键词搜索。
+
+```bash
+# 跨 catalog/schema 模糊搜索表
+te-cli dataops_ide +search_tables --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
+  --searchKey "user" --size 20
+
+# 跨表模糊搜索列名
+te-cli dataops_ide +search_columns --spaceCode "${spaceCode}" --repoCode "${repoCode}" \
+  --searchKey "user_id" --tables '[{"catalog":"hive","isView":false,"schema":"ws_default_dev","tableName":"dwd_user"}]' \
+  --engineType "TASK_ENGINE_TRINO" --pageNum 1 --pageSize 100
+
+# 根据表名和列名生成 SELECT SQL
+te-cli dataops_ide +generate_sql --spaceCode "${spaceCode}" --repoCode "${repoCode}" \
+  --catalog "hive" --schema "ws_default_dev" --tableName "dwd_user" \
+  --engineType "TASK_ENGINE_TRINO" --selectColumns '["user_id","user_name","age"]'
+```
+
+---
+
+## 工作流 C：执行 SQL 查询（完整异步流程）
+
+这是最重要的工作流，包含 3 步：执行 → 轮询进度 → 获取结果。
+
+```bash
+# Step 1: 异步执行 SQL（返回 requestId）
+te-cli dataops_ide +execute_sql --spaceCode "${spaceCode}" --repoCode "te_etl" \
+  --sql "SELECT * FROM hive.ws_default_dev.dwd_user LIMIT 10" \
+  --engineType "TASK_ENGINE_TRINO" --confirmed true
+
+# Step 2: 查询执行进度（用 Step 1 返回的 requestId，建议 2-5 秒轮询）
+# state 可能值: QUEUED / RUNNING / FINISHED / FAILED / CANCELLED
+te-cli dataops_ide +get_query_progress --requestId "${requestId}"
+
+# Step 3: state=FINISHED 后，获取查询结果
+# recordId 从查询历史或进度信息中获取
+te-cli dataops_ide +get_query_result --spaceCode "${spaceCode}" --connType "SPACE" \
+  --repoCode "te_etl" --recordId "${recordId}"
+
+# （可选）取消正在执行的查询
+te-cli dataops_ide +cancel_query --requestId "${requestId}" --confirmed true
+```
+
+---
+
+## 命令速查
+
+| 命令 | 用途 | 关键 Flags |
+|------|------|-----------|
+| `+list_repos` | 列出仓库 | `--spaceCode` |
+| `+list_catalogs` | 列出 catalog/schema | `--spaceCode` `--connType` `--repoCode` |
+| `+list_tables` | 列出表 | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` `--isView` `--pageNum` `--pageSize` |
+| `+get_table_detail` | 表元数据 | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` `--tableName` `--engineType` `--isView` |
+| `+get_schema_info` | schema 统计 | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` |
+| `+search_tables` | 模糊搜索表 | `--spaceCode` `--connType` `--repoCode` `--searchKey` `--size` |
+| `+search_columns` | 模糊搜索列 | `--spaceCode` `--repoCode` `--searchKey` `--tables` (JSON) `--engineType` `--pageNum` `--pageSize` |
+| `+generate_sql` | 生成 SELECT | `--spaceCode` `--repoCode` `--catalog` `--schema` `--tableName` `--engineType` `--selectColumns` (JSON) |
+| `+execute_sql` | 执行 SQL | `--spaceCode` `--repoCode` `--sql` `--engineType` `--confirmed` |
+| `+get_query_progress` | 查询进度 | `--requestId` |
+| `+get_query_result` | 获取结果 | `--spaceCode` `--connType` `--repoCode` `--recordId` |
+| `+cancel_query` | 取消查询 | `--requestId` `--confirmed` |
+
+## 参数说明
+
+- **connType**: `SPACE`（数据仓库日常查询，默认）| `ETL`（ETL 引擎）| `APP`（应用仓对外服务）
+- **engineType**: `TASK_ENGINE_TRINO`（默认，交互式查询）| `TASK_ENGINE_STARROCKS`（实时分析、高并发）
+- **isView**: `false` 查物理表 | `true` 查视图

package/skills/te-dataops/references/dataops-table.md

@@ -0,0 +1,122 @@
+---
+name: dataops-table
+version: 1.0.0
+description: "数据表与视图管理：搜索表、查看表详情、创建物理表/视图、批量创建关联视图。触发关键词：建表、创建表、视图、数据字典、表详情、关联视图、linkview、datatable、DDL。"
+metadata:
+  requires:
+    bins: ["te-cli"]
+---
+
+# DataOps 数据表与视图管理
+
+> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
+
+使用 `dataops_datatable` 子命令管理数据表。
+
+**核心规则：**
+- 空间任务表的创建/修改/删除**必须用 dataops_datatable**，禁止用 dataops_ide
+- 创建前先确认同名表不存在
+- 创建视图或数据表时，按照 **Trino DDL 规范**生成 DDL
+- 任务表先创建 DEV 环境，再创建 PROD 环境（可同时创建）
+
+---
+
+## 工作流 A：搜索并查看表信息
+
+```bash
+# 在数据字典中搜索表（按表名/说明模糊匹配）
+te-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "user" --maxResults 20
+
+# 获取表的详细信息（字段、DDL、数据血缘）
+te-cli dataops_datatable +get_table_detail --spaceCode "${spaceCode}" --tableName "dwd_user_info"
+
+# 分页查询空间已注册的表列表
+te-cli dataops_datatable +list_tables_by_page --spaceCode "${spaceCode}" --search "user" --pageNum 1 --pageSize 20
+
+# 按仓库维度获取表层级结构（repo→catalog→schema→tables）
+te-cli dataops_datatable +struct_by_repo --spaceCode "${spaceCode}"
+
+# 搜索系统表（事件表、用户表、维度表）
+te-cli dataops_datatable +list_system_tables --spaceCode "${spaceCode}" --projectName "my_project"
+```
+
+---
+
+## 工作流 B：创建物理表
+
+```bash
+# Step 1: 确认同名表不存在
+te-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "dwd_user_info"
+
+# Step 2: 创建 DEV 环境的物理表（DDL 需遵循 Trino 规范）
+te-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
+  --ddl "CREATE TABLE dwd_user_info (user_id VARCHAR, user_name VARCHAR, age INTEGER) WITH (format = 'ORC')" \
+  --repoCode "te_etl" --catalog "hive" --schema "ws_default_dev" --confirmed true
+
+# Step 3: 创建 PROD 环境的物理表（同样 DDL，schema 改为 product 库）
+te-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
+  --ddl "CREATE TABLE dwd_user_info (user_id VARCHAR, user_name VARCHAR, age INTEGER) WITH (format = 'ORC')" \
+  --repoCode "te_etl" --catalog "hive" --schema "ws_default_product" --confirmed true
+```
+
+---
+
+## 工作流 C：创建视图
+
+```bash
+# Step 1: 确认同名视图不存在
+te-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "v_user_info"
+
+# Step 2: 创建视图（未指定视图名时默认用 v_${来源表名}）
+te-cli dataops_datatable +create_view --spaceCode "${spaceCode}" \
+  --ddl "CREATE VIEW v_user_info AS SELECT user_id, user_name FROM hive.ws_default_dev.dwd_user_info" \
+  --repoCode "te_etl" --catalog "hive" --schema "ws_default_dev" --confirmed true
+```
+
+---
+
+## 工作流 D：批量创建直连视图
+
+```bash
+# Step 1: 列出可用于创建关联视图的源表
+te-cli dataops_datatable +linkview_list_source_tables --spaceCode "${spaceCode}" \
+  --srcRepoCode "te_etl" --srcCatalog "hive" --srcSchema "ws_default_hidden"
+
+# Step 2: 批量创建直连视图（异步执行）
+te-cli dataops_datatable +batch_create --spaceCode "${spaceCode}" \
+  --srcRepoCode "te_etl" --srcCatalog "hive" --srcSchema "ws_default_hidden" \
+  --processType 2 --batchCreationMode 1 --owner "${ownerOpenId}" \
+  --viewInfos '[{"viewName":"v_orders","srcTableName":"ta_event_123","srcTableType":"TABLE"}]' \
+  --confirmed true
+
+# Step 3: 轮询批量创建状态（建议 3-5 秒间隔）
+# status: WAIT / RUNNING / SUCCESS / STOP
+te-cli dataops_datatable +linkview_get_batch_status --spaceCode "${spaceCode}" --batchId "${batchId}"
+
+# 查看历史批量创建记录
+te-cli dataops_datatable +list_batches --spaceCode "${spaceCode}"
+```
+
+---
+
+## 命令速查
+
+| 命令 | 用途 | 关键 Flags |
+|------|------|-----------|
+| `+dict_search_tables` | 数据字典搜索 | `--spaceCode` `--search` `--maxResults` |
+| `+get_table_detail` | 表详情 | `--spaceCode` `--tableName` |
+| `+list_tables_by_page` | 分页列表 | `--spaceCode` `--search` `--pageNum` `--pageSize` |
+| `+struct_by_repo` | 按仓库层级 | `--spaceCode` `--search` |
+| `+list_system_tables` | 系统表列表 | `--spaceCode` `--projectId`/`--projectName` `--pageNum` `--pageSize` |
+| `+create_table` | 创建物理表 | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
+| `+create_view` | 创建视图 | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
+| `+batch_create` | 批量创建视图 | `--spaceCode` `--srcRepoCode` `--srcCatalog` `--srcSchema` `--processType` `--batchCreationMode` `--owner` `--viewInfos` `--confirmed` |
+| `+linkview_get_batch_status` | 批量创建状态 | `--spaceCode` `--batchId` |
+| `+list_batches` | 历史批量记录 | `--spaceCode` `--status` |
+
+## 参数说明
+
+- **schema 命名**: DEV 环境用 `ws_${spaceCode}_dev`，PROD 环境用 `ws_${spaceCode}_product`
+- **processType**: `1`=仅 DEV | `2`=DEV+PROD
+- **batchCreationMode**: `1`=全量同步 | `2`=失败重试
+- **表名规则**: `^[a-z][0-9a-z_]{0,127}$`

package/skills/te-engage/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: te-engage
+version: 1.0.0
+description: "TE Engage MCP：配置项、流程、渠道设置、任务数据查询与管理"
+metadata:
+  requires:
+    bins: ["te-cli"]
+  cliHelp: "te-cli te-engage --help"
+---
+
+# te-engage
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../te-shared/SKILL.md) 了解认证、全局参数和安全约束。
+
+## 概述
+
+`te-engage` 域提供 Hermes Engage MCP 能力，覆盖配置项、流程、渠道设置和任务数据。命令通过 `te-cli te-engage <command>` 调用。
+
+适合的场景包括：
+
+- 查询和管理渠道、配置通道、审批人、白名单
+- 查询任务列表、任务详情、实验报表、指标报表
+- 查询配置项与策略、复制模板、管理策略状态
+- 查询流程列表、节点 schema、流程报表，以及保存/管理流程
+
+## 参数约定
+
+- 简单参数直接使用普通 flags，例如 `--project-id`、`--task-id`、`--flow-uuid`
+- 数组参数使用 JSON flags，例如 `--strategy-id-list '["id1","id2"]'`
+- 对象参数使用具名 JSON flags，例如 `--req '{...}'`、`--flow-list '[...]'`
+- 可选全局参数仍可与其他 domain 一样使用，例如 `--host`、`--mcp-url`、`--dry-run`
+
+## JSON 参数格式
+
+常见 JSON flags 示例：
+
+```bash
+--provider-list '["webhook","fcm"]'
+--strategy-id-list '["strategy_a","strategy_b"]'
+--flow-id-list '["flow_1","flow_2"]'
+--req '{"pageNum":1,"pageSize":20}'
+```
+
+## 常见场景
+
+### 1. setting
+
+```bash
+# 查询渠道列表
+te-cli te-engage +channel-list --project-id 1
+
+# 过滤 provider
+te-cli te-engage +channel-list --project-id 1 --provider-list '["webhook","fcm"]'
+
+# 查询 config channel
+te-cli te-engage +config-channel-list --project-id 1
+```
+
+### 2. task
+
+```bash
+# 查询任务列表
+te-cli te-engage +task-list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
+
+# 查询任务详情
+te-cli te-engage +task-detail --project-id 1 --task-id task_123
+
+# 查询任务概览
+te-cli te-engage +task-data-overview --project-id 1 --task-id task_123 --task-type normal
+```
+
+### 3. config
+
+```bash
+# 查询配置项列表
+te-cli te-engage +config-item-list --project-id 1
+
+# 查询策略列表
+te-cli te-engage +strategy-list --project-id 1 --config-id cfg_123
+
+# 查询配置项报表
+te-cli te-engage +config-item-trigger-report \
+  --project-id 1 --config-id cfg_123 \
+  --start-time 2026-04-01 --end-time 2026-04-07
+```
+
+### 4. flow
+
+```bash
+# 查询流程列表
+te-cli te-engage +flow-list --project-id 1
+
+# 查询流程详情
+te-cli te-engage +flow-detail --project-id 1 --flow-uuid flow_uuid_123
+
+# 查询节点 schema
+te-cli te-engage +flow-node-config-schema --node-type message_push
+```
+
+## `+save-flow` 关键约束
+
+当用户要“创建流程 / 生成流程画布 / 保存流程”时，不要把 `+save-flow` 当成普通单命令直接调用，必须按下面流程执行。
+
+### 必须遵守的工作流
+
+1. 先确认用户意图已经足够明确，至少要有：
+   - 业务场景
+   - 目标用户
+   - 触达方式
+   - 是否分流，以及分流条件
+2. 不要从自然语言直接跳到 `--req`，必须先整理出稳定的中间意图结构，再映射成最终 `req`。
+3. 在构造条件相关节点前，必须先调用：
+
+```bash
+te-cli te_audience +get_cluster_definition_schema --cluster_type condition
+```
+
+4. 在构造 `message_push`、`wechat_push`、`webhook_push` 等触达节点前，必须先调用：
+
+```bash
+te-cli te-engage +channel-list --project-id <projectId>
+```
+
+5. `+save-flow` 的最终 `--req` 必须是完整画布请求体，而不是意图描述。至少应包含：
+   - `flowName`
+   - `flowDesc`
+   - `nodeList`
+   - `edgeList`
+6. `nodeList[].config` 和 `edgeList[].config` 必须是 JSON 字符串，不是 JSON 对象。
+7. `targetClusterQp` 如果出现在节点 `config` 中，其值通常也应是再次 `JSON.stringify` 后的字符串，而不是原始对象。
+8. 提交前必须自检：
+   - 只有一个入口节点
+   - 至少一个 `exit_flow`
+   - `edge.source` / `edge.target` 都引用有效节点
+   - 分支节点的 `sourceBranchId` 已在上游节点 `config` 中声明
+   - 整张图是 DAG，不能有环
+
+### 明确禁止
+
+- 不要凭空编造 `channelId`
+- 不要在用户信息不足时自行脑补分流逻辑
+- 不要把业务语义节点直接当成最终 `nodeList` 节点提交
+- 不要把 `config` 写成对象后直接塞进 `--req`
+
+### 推荐顺序
+
+```text
+用户需求
+-> 整理意图
+-> te_audience +get_cluster_definition_schema --cluster_type condition
+-> +channel-list --project-id <projectId>
+-> 构造 nodeList / edgeList
+-> 自检
+-> +save-flow
+```
+
+更细的生成规则优先参考：
+
+- `references/save-flow.md`
+- `references/flow-node-config-schema.md`
+- `references/validate-flow-node-config.md`
+
+## dry-run 调试
+
+```bash
+te-cli --dry-run te-engage +channel-list --project-id 1
+te-cli --dry-run te-engage +task-list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
+te-cli --dry-run te-engage +flow-list --project-id 1
+```
+
+## References
+
+更细的单命令说明见按业务拆分的 `references/` 目录：
+
+- `references/channel-list.md`
+- `references/task-list.md`
+- `references/config-item-list.md`
+- `references/flow-list.md`
+
+这种拆包方式更适合后续继续扩展，因为对象入参较复杂的命令会集中在 `references/` 根目录维护。
+
+## 命令分组
+
+### setting
+
+`+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`
+
+### task
+
+`+task-data-overview`, `+task-data-detail`, `+task-metric-detail`, `+task-experiment-report`, `+task-detail`, `+task-list`, `+task-stats`, `+manage-task`
+
+### config
+
+`+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`
+
+### flow
+
+`+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`
+
+## 日期格式
+
+涉及日期参数的命令通常使用 `yyyy-MM-dd`，例如 `--start-time 2026-04-01`。
+
+## 写操作提醒
+
+以下命令属于写操作，执行前应确认用户明确意图：
+
+- 渠道与配置通道：`+add-channel`, `+delete-channel`, `+update-channel-status`, `+delete-config-channel`, `+update-config-channel-status`
+- 策略与配置项：`+delete-config-item`, `+copy-config-template`, `+manage-strategy`
+- 流程：`+save-flow`, `+modify-flow-base-info`, `+manage-flow`, `+delete-flow`
+- 任务：`+manage-task`

package/skills/te-engage/references/add-approver.md

@@ -0,0 +1,24 @@
+# te-engage +add-approver
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+批量添加审批人。
+
+映射命令: `te-cli te-engage +add-approver`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--approvers` | json | 是 | 审批人 open ID JSON 数组 |
+
+## 安全约束
+
+此命令为 **写操作**，会修改项目审批人配置。
+
+## 示例
+
+```bash
+te-cli te-engage +add-approver --project-id 1 --approvers '["ou_xxx","ou_yyy"]'
+```

package/skills/te-engage/references/add-channel.md

@@ -0,0 +1,74 @@
+# te-engage +add-channel
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+创建新的 Engage 渠道。
+
+映射命令: `te-cli te-engage +add-channel`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--req` | json | 是 | 渠道创建请求 JSON 对象 |
+
+## `--req` 对象字段
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `channelType` | number | 是 | 渠道类型 |
+| `channelSubBizType` | string | 是 | 渠道子类型，例如 `webhook`、`fcm`、`aurora` |
+| `channelName` | string | 是 | 渠道名称 |
+| `pushIdType` | string | 是 | 推送目标 ID 字段名 |
+| `config` | string | 是 | 渠道配置 JSON 字符串 |
+| `enableTouchEvent` | number | 是 | 触达事件开关 |
+| `eventClickName` | string | 是 | 点击事件名 |
+| `eventDeliveryName` | string | 是 | 送达事件名 |
+| `touchEventSource` | string | 是 | 触达事件来源 |
+
+`projectId` 会由 CLI 自动写入 `--req` 对象中，无需重复手动填写；如果写了同名字段，最终以顶层 `--project-id` 为准。
+
+## 枚举说明
+
+### `req.channelType`
+
+- `1`: `WEBHOOK`
+- `2`: `APP_PUSH`
+- `3`: `CLIENT_PUSH`
+- `4`: `WECHAT`
+- `5`: `DOU_YIN`
+
+### `req.channelSubBizType`
+
+常见可选值如下，通常应与 `channelType` 对应：
+
+- `webhook`: Webhook 渠道
+- `fcm`: App Push, Firebase Cloud Messaging
+- `aurora`: App Push, Aurora
+- `apns`: App Push, Apple Push Notification Service
+- `client`: Client Push
+- `wechat_mini_game`: 微信小游戏
+- `dou_yin_recommended_game_card`: 抖音推荐游戏卡
+
+### `req.enableTouchEvent`
+
+- `0`: 关闭触达事件
+- `1`: 开启触达事件
+
+## 补充约束
+
+- `req.config` 必须是 JSON 字符串，不是 JSON 对象。
+- `req.channelSubBizType` 建议和实际渠道能力保持一致，例如 `channelType=1` 时通常使用 `webhook`。
+- 如果需要送达/点击回传，建议同时检查 `eventDeliveryName`、`eventClickName` 和 `touchEventSource` 是否完整。
+
+## 安全约束
+
+此命令为 **写操作**，会创建新渠道。执行前应检查 `--req` 的字段是否完整。
+
+## 示例
+
+```bash
+te-cli te-engage +add-channel --project-id 1 \
+  --req '{"channelType":1,"channelSubBizType":"webhook","channelName":"demo","pushIdType":"user_id","config":"{}","enableTouchEvent":0,"eventClickName":"","eventDeliveryName":"","touchEventSource":""}'
+```

package/skills/te-engage/references/approver-list.md

@@ -0,0 +1,19 @@
+# te-engage +approver-list
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询项目审批人列表。
+
+映射命令: `te-cli te-engage +approver-list`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+te-cli te-engage +approver-list --project-id 1
+```

package/skills/te-engage/references/cancel-query-by-request-id.md

@@ -0,0 +1,23 @@
+# te-engage +cancel-query-by-request-id
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+按 requestId 取消正在执行的数据查询。
+
+映射命令: `te-cli te-engage +cancel-query-by-request-id`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--request-id` | string | 是 | 查询 requestId |
+
+## 安全约束
+
+此命令为 **写操作**，会取消已有查询。
+
+## 示例
+
+```bash
+te-cli te-engage +cancel-query-by-request-id --request-id 00000000-0000-0000-0000-000000000000
+```

package/skills/te-engage/references/channel-detail.md

@@ -0,0 +1,52 @@
+# te-engage +channel-detail
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询单个 Engage 渠道详情。
+
+映射命令: `te-cli te-engage +channel-detail`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--channel-id` | string | 是 | 渠道 ID |
+
+## 返回值里的常见枚举
+
+### `channelStatus`
+
+- `0`: disabled
+- `1`: enabled
+
+### `channelType`
+
+- `1`: `WEBHOOK`
+- `2`: `APP_PUSH`
+- `3`: `CLIENT_PUSH`
+- `4`: `WECHAT`
+- `5`: `DOU_YIN`
+
+### `channelSubBizType`
+
+常见值包括：
+
+- `webhook`
+- `fcm`
+- `aurora`
+- `apns`
+- `client`
+- `wechat_mini_game`
+- `dou_yin_recommended_game_card`
+
+### `enableTouchEvent`
+
+- `0`: 关闭触达漏斗
+- `1`: 开启触达漏斗
+
+## 示例
+
+```bash
+te-cli te-engage +channel-detail --project-id 1 --channel-id <channel-id>
+```

package/skills/te-engage/references/channel-list.md

@@ -0,0 +1,41 @@
+# te-engage +channel-list
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询项目下的 Engage 渠道列表。
+
+映射命令: `te-cli te-engage +channel-list`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--provider-list` | json | 否 | Provider 列表 JSON 数组 |
+| `--channel-status` | number | 否 | 渠道状态过滤 |
+
+## 枚举说明
+
+### `--channel-status`
+
+- `0`: disabled
+- `1`: enabled
+
+### `--provider-list`
+
+可传的 provider / channelSubBizType 常见值：
+
+- `webhook`
+- `fcm`
+- `aurora`
+- `apns`
+- `client`
+- `wechat_mini_game`
+- `dou_yin_recommended_game_card`
+
+## 示例
+
+```bash
+te-cli te-engage +channel-list --project-id 1
+te-cli te-engage +channel-list --project-id 1 --provider-list '["webhook","fcm"]'
+```