@thinkingai/ae-cli 1.0.1

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

@@ -0,0 +1,73 @@
+# te-engage +strategy-detail
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询单个策略详情。
+
+映射命令: `te-cli te-engage +strategy-detail`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--config-id` | string | 是 | 配置项 ID |
+| `--strategy-uuid` | string | 是 | 策略 UUID |
+
+## 返回值里的常见枚举
+
+### `status`
+
+- `0`: `DRAFT`
+- `1`: `ONLINE`
+- `2`: `SUSPEND`
+- `3`: `OFFLINE`
+
+### `mappingStatus`
+
+- `0`: `DRAFT`
+- `1`: `APPROVE`
+- `2`: `DENY`
+- `3`: `REGISTERING`
+- `4`: `REGISTER_FAIL`
+- `5`: `WAITING`
+- `6`: `ONLINE`
+- `7`: `SUSPEND`
+- `8`: `OFFLINE`
+
+### `targetClusterType`
+
+- `0`: `ALL_USERS`
+- `1`: `CUSTOM_CLUSTER`
+- `2`: `SINGLE_USER`
+
+### `realtime`
+
+- `0`: physical cluster，物理人群
+- `1`: virtual cluster，虚拟人群
+
+### `triggerType`
+
+- `0`: `SCHEDULED_SINGLE`
+- `1`: `SCHEDULED_RECURRING`
+- `2`: `MANUAL`
+
+### `versionType`
+
+- `0`: history version，历史版本
+- `1`: current version，当前版本
+- `2`: update content version，更新内容版本
+
+### `channelType`
+
+- `1`: `WEBHOOK`
+- `2`: `APP_PUSH`
+- `3`: `CLIENT_PUSH`
+- `4`: `WECHAT`
+- `5`: `DOU_YIN`
+
+## 示例
+
+```bash
+te-cli te-engage +strategy-detail --project-id 1 --config-id cfg_123 --strategy-uuid uuid_123
+```

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

@@ -0,0 +1,21 @@
+# te-engage +strategy-list
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询策略列表。
+
+映射命令: `te-cli te-engage +strategy-list`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--config-id` | string | 否 | 配置项 ID |
+| `--strategy-uuid-list` | json | 否 | 策略 UUID JSON 数组 |
+
+## 示例
+
+```bash
+te-cli te-engage +strategy-list --project-id 1 --config-id cfg_123
+```

package/skills/te-engage/references/task-data-detail.md

@@ -0,0 +1,81 @@
+# te-engage +task-data-detail
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询任务详细数据报表。
+
+映射命令: `te-cli te-engage +task-data-detail`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--task-id` | string | 是 | 任务 ID |
+| `--task-type` | string | 是 | 任务类型：`normal` 或 `trigger` |
+| `--detail-type` | string | 是 | 明细类型 |
+| `--start-time` | string | 是 | 开始日期 |
+| `--end-time` | string | 是 | 结束日期 |
+| `--request-id` | string | 否 | 查询 requestId |
+| `--push-language-code` | string | 否 | 推送语言代码 |
+| `--task-instance-id` | string | 否 | 任务实例 ID |
+| `--data-dim-type` | string | 否 | 数据维度类型 |
+| `--retention-type` | string | 否 | 留存类型 |
+| `--data-view-type` | number | 否 | 触发任务视图类型 |
+| `--show-time-zone` | string | 否 | 展示时区偏移 |
+
+## 枚举说明
+
+### `--task-type`
+
+- `normal`: 普通任务
+- `trigger`: 触发式任务
+
+### `--detail-type`
+
+- `time`: 按时间维度查看
+- `instance`: 按执行实例查看
+- `instance_daily`: 查看单个实例的逐日明细
+
+### `--data-dim-type`
+
+- `uv`: 按去重用户数统计
+- `pv`: 按事件/次数统计
+
+### `--retention-type`
+
+- `retention`: 留存分析
+- `lost`: 流失分析
+
+### `--data-view-type`
+
+仅在 `--task-type trigger` 且 `--detail-type time` 时有效：
+
+- `2`: 日期视图
+- `3`: 触发视图
+
+### `--push-language-code`
+
+常见值包括：
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## 参数约束
+
+- `--task-type trigger` 时，`--detail-type` 只能是 `time`。
+- `--detail-type instance_daily` 时，必须传 `--task-instance-id`。
+- `--start-time`、`--end-time` 使用 `yyyy-MM-dd`。
+
+## 示例
+
+```bash
+te-cli te-engage +task-data-detail \
+  --project-id 1 --task-id task_123 \
+  --task-type normal --detail-type time \
+  --start-time 2026-04-01 --end-time 2026-04-07
+```

package/skills/te-engage/references/task-data-overview.md

@@ -0,0 +1,48 @@
+# te-engage +task-data-overview
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询任务漏斗式数据概览。
+
+映射命令: `te-cli te-engage +task-data-overview`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--task-id` | string | 是 | 任务 ID |
+| `--task-type` | string | 是 | 任务类型：`normal` 或 `trigger` |
+| `--request-id` | string | 否 | 查询 requestId |
+| `--push-language-code` | string | 否 | 推送语言代码 |
+| `--data-dim-type` | string | 否 | 数据维度类型 |
+| `--show-time-zone` | string | 否 | 展示时区偏移 |
+
+## 枚举说明
+
+### `--task-type`
+
+- `normal`: 普通任务
+- `trigger`: 触发式任务
+
+### `--data-dim-type`
+
+- `uv`: 按去重用户数统计
+- `pv`: 按事件/次数统计
+
+### `--push-language-code`
+
+常见值包括：
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## 示例
+
+```bash
+te-cli te-engage +task-data-overview --project-id 1 --task-id task_123 --task-type normal
+```

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

@@ -0,0 +1,61 @@
+# te-engage +task-detail
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询单个任务详情。
+
+映射命令: `te-cli te-engage +task-detail`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--task-id` | string | 是 | 任务 ID |
+
+## 返回值里的常见枚举
+
+### `status`
+
+- `0`: `DRAFT`，草稿，未提交
+- `1`: `WORKING`，运行中
+- `2`: `PENDING`，已暂停
+- `3`: `COMPLETE`，已结束
+
+### `mappingStatus`
+
+- `0`: `DRAFT`
+- `1`: `WORKING`
+- `2`: `PENDING`
+- `3`: `COMPLETE`
+- `4`: `APPROVE`，待审批
+- `5`: `DENY`，审批拒绝
+
+### `channelType`
+
+- `1`: `WEBHOOK`
+- `2`: `APP_PUSH`
+- `3`: `CLIENT_PUSH`
+- `4`: `WECHAT`
+- `5`: `DOU_YIN`
+
+### `triggerType`
+
+- `0`: `SCHEDULED_SINGLE`
+- `1`: `SCHEDULED_RECURRING`
+- `2`: `MANUAL`
+- `3`: `TRIGGER_COMPLETE_A`
+- `4`: `TRIGGER_COMPLETE_A_THEN_B`
+- `5`: `TRIGGER_COMPLETE_A_NOT_B`
+- `6`: `CUSTOM_TRIGGER`
+
+### `realtime`
+
+- `0`: physical cluster，物理人群
+- `1`: virtual cluster，虚拟人群
+
+## 示例
+
+```bash
+te-cli te-engage +task-detail --project-id 1 --task-id task_123
+```

package/skills/te-engage/references/task-experiment-report.md

@@ -0,0 +1,51 @@
+# te-engage +task-experiment-report
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询任务实验报表。
+
+映射命令: `te-cli te-engage +task-experiment-report`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--task-id` | string | 是 | 任务 ID |
+| `--task-type` | string | 是 | 任务类型：`normal` 或 `trigger` |
+| `--report-type` | string | 是 | 报表类型：`overview` 或 `detail` |
+| `--start-time` | string | 是 | 开始日期 |
+| `--end-time` | string | 是 | 结束日期 |
+| `--request-id` | string | 否 | 查询 requestId |
+| `--push-language-code` | string | 否 | 推送语言代码 |
+
+## 枚举说明
+
+### `--task-type`
+
+- `normal`: 普通任务
+- `trigger`: 触发式任务
+
+### `--report-type`
+
+- `overview`: 实验概览
+- `detail`: 实验明细
+
+### `--push-language-code`
+
+常见值包括：
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## 示例
+
+```bash
+te-cli te-engage +task-experiment-report \
+  --project-id 1 --task-id task_123 --task-type normal \
+  --report-type overview --start-time 2026-04-01 --end-time 2026-04-07
+```

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

@@ -0,0 +1,91 @@
+# te-engage +task-list
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+分页查询任务列表。
+
+映射命令: `te-cli te-engage +task-list`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--req` | json | 是 | 查询条件 JSON 对象 |
+
+## `--req` 对象字段
+
+常见字段如下，按需传入即可：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `pageNum` | number | 否 | 页码，从 1 开始 |
+| `pageSize` | number | 否 | 每页条数 |
+| `mappingStatus` | number | 否 | 状态过滤 |
+| `triggerType` | number | 否 | 触发类型过滤 |
+| `channelType` | number | 否 | 渠道类型过滤 |
+| `groupId` | number | 否 | 分组 ID |
+| `creator` | string | 否 | 创建人 open_id |
+| `fuzzyField` | string | 否 | 任务 ID 或任务名模糊搜索 |
+| `belongActivity` | number | 否 | 是否关联活动过滤 |
+| `expStatusList` | array | 否 | 实验状态列表 |
+| `expReleaseStatusList` | array | 否 | 实验发布状态列表 |
+| `expTypeList` | array | 否 | 实验类型列表 |
+
+`projectId` 会由 CLI 自动补入 `--req`，通常不需要重复写。
+
+## 枚举说明
+
+### `req.mappingStatus`
+
+- `0`: draft
+- `1`: in progress
+- `2`: paused
+- `3`: ended
+- `4`: approving
+- `5`: denied
+
+### `req.triggerType`
+
+- `0`: scheduled-single
+- `1`: scheduled-recurring
+- `2`: manual
+- `3`: trigger-complete A
+- `4`: trigger-complete A then B
+- `5`: trigger-complete A but not B
+- `6`: custom trigger
+
+### `req.channelType`
+
+- `1`: webhook
+- `2`: app_push
+- `3`: client_push
+- `4`: wechat
+- `5`: dou_yin
+
+### `req.belongActivity`
+
+- `0`: 全部
+- `1`: 已关联活动
+- `2`: 未关联活动
+
+### `req.expStatusList[]`
+
+- `0`: 未创建实验
+- `1`: 已创建实验
+
+### `req.expReleaseStatusList[]`
+
+- `0`: 未发布实验
+- `1`: 已发布实验
+
+### `req.expTypeList[]`
+
+- `0`: normal
+- `1`: orthogonal
+
+## 示例
+
+```bash
+te-cli te-engage +task-list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
+```

package/skills/te-engage/references/task-metric-detail.md

@@ -0,0 +1,56 @@
+# te-engage +task-metric-detail
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询任务指标导向的明细报表。
+
+映射命令: `te-cli te-engage +task-metric-detail`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--task-id` | string | 是 | 任务 ID |
+| `--task-type` | string | 是 | 任务类型：`normal` 或 `trigger` |
+| `--start-time` | string | 是 | 开始日期 |
+| `--end-time` | string | 是 | 结束日期 |
+| `--request-id` | string | 否 | 查询 requestId |
+| `--push-language-code` | string | 否 | 推送语言代码 |
+| `--metric-id-list` | json | 否 | 指标 ID JSON 数组 |
+| `--group-type` | number | 否 | 分组类型 |
+| `--show-time-zone` | string | 否 | 展示时区偏移 |
+
+## 枚举说明
+
+### `--task-type`
+
+- `normal`: 普通任务
+- `trigger`: 触发式任务
+
+### `--group-type`
+
+- `1`: 按批次分组
+- `2`: 按日期分组
+- `3`: 按触发分组
+- `4`: 按实验效果分组
+
+### `--push-language-code`
+
+常见值包括：
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## 示例
+
+```bash
+te-cli te-engage +task-metric-detail \
+  --project-id 1 --task-id task_123 --task-type normal \
+  --start-time 2026-04-01 --end-time 2026-04-07 \
+  --metric-id-list '["metric_1"]'
+```

package/skills/te-engage/references/task-stats.md

@@ -0,0 +1,89 @@
+# te-engage +task-stats
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询任务状态统计。
+
+映射命令: `te-cli te-engage +task-stats`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--req` | json | 是 | 统计条件 JSON 对象 |
+
+## `--req` 对象字段
+
+`+task-stats` 的 `--req` 结构与 `+task-list` 基本一致，常见字段包括：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `mappingStatus` | number | 否 | 状态过滤 |
+| `triggerType` | number | 否 | 触发类型过滤 |
+| `channelType` | number | 否 | 渠道类型过滤 |
+| `groupId` | number | 否 | 分组 ID |
+| `creator` | string | 否 | 创建人 open_id |
+| `fuzzyField` | string | 否 | 任务 ID 或任务名模糊搜索 |
+| `belongActivity` | number | 否 | 是否关联活动过滤 |
+| `expStatusList` | array | 否 | 实验状态列表 |
+| `expReleaseStatusList` | array | 否 | 实验发布状态列表 |
+| `expTypeList` | array | 否 | 实验类型列表 |
+
+`projectId` 会由 CLI 自动补入 `--req`。
+
+## 枚举说明
+
+### `req.mappingStatus`
+
+- `0`: draft
+- `1`: in progress
+- `2`: paused
+- `3`: ended
+- `4`: approving
+- `5`: denied
+
+### `req.triggerType`
+
+- `0`: scheduled-single
+- `1`: scheduled-recurring
+- `2`: manual
+- `3`: trigger-complete A
+- `4`: trigger-complete A then B
+- `5`: trigger-complete A but not B
+- `6`: custom trigger
+
+### `req.channelType`
+
+- `1`: webhook
+- `2`: app_push
+- `3`: client_push
+- `4`: wechat
+- `5`: dou_yin
+
+### `req.belongActivity`
+
+- `0`: 全部
+- `1`: 已关联活动
+- `2`: 未关联活动
+
+### `req.expStatusList[]`
+
+- `0`: 未创建实验
+- `1`: 已创建实验
+
+### `req.expReleaseStatusList[]`
+
+- `0`: 未发布实验
+- `1`: 已发布实验
+
+### `req.expTypeList[]`
+
+- `0`: normal
+- `1`: orthogonal
+
+## 示例
+
+```bash
+te-cli te-engage +task-stats --project-id 1 --req '{"pageNum":1,"pageSize":20}'
+```

package/skills/te-engage/references/update-channel-status.md

@@ -0,0 +1,32 @@
+# te-engage +update-channel-status
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+更新 Engage 渠道状态。
+
+映射命令: `te-cli te-engage +update-channel-status`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--channel-id` | string | 是 | 渠道 ID |
+| `--status` | number | 是 | 渠道状态 |
+
+## 枚举说明
+
+### `--status`
+
+- `0`: disabled
+- `1`: enabled
+
+## 安全约束
+
+此命令为 **写操作**，执行前应确认用户明确希望变更渠道状态。
+
+## 示例
+
+```bash
+te-cli te-engage +update-channel-status --project-id 1 --channel-id <channel-id> --status 1
+```

package/skills/te-engage/references/update-config-channel-status.md

@@ -0,0 +1,32 @@
+# te-engage +update-config-channel-status
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+更新配置通道状态。
+
+映射命令: `te-cli te-engage +update-config-channel-status`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--channel-id` | string | 是 | 配置通道 ID |
+| `--channel-status` | number | 是 | 配置通道状态 |
+
+## 枚举说明
+
+### `--channel-status`
+
+- `1`: enabled
+- `2`: disabled
+
+## 安全约束
+
+此命令为 **写操作**，会修改配置通道状态。
+
+## 示例
+
+```bash
+te-cli te-engage +update-config-channel-status --project-id 1 --channel-id <channel-id> --channel-status 1
+```

package/skills/te-engage/references/validate-flow-node-config.md

@@ -0,0 +1,52 @@
+# te-engage +validate-flow-node-config
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+在保存流程前校验单个节点配置。
+
+映射命令: `te-cli te-engage +validate-flow-node-config`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--node-type` | string | 是 | 节点类型 |
+| `--config` | string | 是 | 节点配置 JSON 字符串 |
+| `--operation-mode` | string | 是 | 校验模式 |
+
+## 枚举说明
+
+### `--node-type`
+
+常见节点类型包括：
+
+- `single_trigger`
+- `repeat_trigger`
+- `event_trigger`
+- `feature_judge`
+- `event_judge`
+- `message_push`
+- `wechat_push`
+- `webhook_push`
+- `config_push`
+- `tag`
+- `time_control`
+- `feature_split_flow`
+- `event_split_flow`
+- `trigger_prop_split_flow`
+- `percent_split_flow`
+- `ab_split_flow`
+- `race_split_flow`
+- `exit_flow`
+
+### `--operation-mode`
+
+- `save_flow`
+- `save_submit_flow`
+
+## 示例
+
+```bash
+te-cli te-engage +validate-flow-node-config \
+  --node-type message_push --operation-mode save_flow --config '{}'
+```