@zhoujinandrew/te-cli 1.0.0

package/skills/te-audience/references/te-audience-predict-cluster-count.md

@@ -0,0 +1,22 @@
+# te-audience +predict-cluster-count
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+根据条件预估满足分群规则的实体数量。
+
+映射命令: `te-cli audience +predict-cluster-count`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--conditions` | json | 是 | 分群条件 JSON |
+
+## 示例
+
+```bash
+# 预估年龄大于 18 的用户数量
+te-cli audience +predict-cluster-count -p my-project \
+  --conditions '{"property":"age","op":"gt","value":18}'
+```

package/skills/te-meta/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: te-meta
+version: 1.0.0
+description: "TE 元数据查询：事件目录、属性加载、实体、指标、SQL表结构"
+metadata:
+  requires:
+    bins: ["te-cli"]
+  cliHelp: "te-cli meta --help"
+---
+
+# te-meta
+
+> **前置条件:** 请先阅读 [`../te-shared/SKILL.md`](../te-shared/SKILL.md)，了解认证、全局参数和输出格式。
+
+## 概述
+
+`te-cli meta` 域提供 ThinkingEngine 平台的元数据查询能力，覆盖以下核心对象：
+
+| 对象 | 命令 | 说明 |
+|------|------|------|
+| 事件目录 | `+list-events` | 获取项目的完整事件列表 |
+| 事件属性 | `+load-event-props` | 加载事件的可筛选属性 |
+| 度量属性 | `+load-measure-props` | 加载事件的可度量属性 |
+| 分析实体 | `+list-entities` | 获取分析实体列表 |
+| 预定义指标 | `+list-metrics` | 获取预定义指标列表 |
+| SQL 表 | `+list-tables` | 获取可查询的 SQL 表列表 |
+| 表字段 | `+get-table-columns` | 获取指定表的字段定义 |
+
+所有命令均为只读操作（`risk: read`），无需确认即可直接执行。
+
+## 核心场景
+
+### 1. 了解项目有哪些事件
+
+```bash
+te-cli meta +list-events --project-id 1
+```
+
+### 2. 为分析查询准备属性列表
+
+先获取事件列表，再加载对应的可筛选 / 可度量属性：
+
+```bash
+# 加载筛选属性
+te-cli meta +load-event-props -p 1 --events '[{"eventName":"login"}]'
+
+# 加载度量属性
+te-cli meta +load-measure-props -p 1 --events '[{"eventName":"login"}]'
+```
+
+### 3. 查询 SQL 表结构
+
+先列出可用表，再获取目标表的字段定义：
+
+```bash
+te-cli meta +list-tables -p 1
+te-cli meta +get-table-columns -p 1 --table "v_event_1"
+```
+
+### 4. 结合 jq 做字段提取
+
+```bash
+# 只输出事件名称
+te-cli meta +list-events -p 1 --jq '.events[].eventName'
+
+# 只输出指标名称和描述
+te-cli meta +list-metrics -p 1 --jq '.metrics[] | {name, description}'
+```
+
+## 参考文档
+
+详细的命令参数说明见 [`references/`](references/) 目录：
+
+- [+list-events](references/list-events.md)
+- [+load-event-props](references/load-event-props.md)
+- [+load-measure-props](references/load-measure-props.md)
+- [+list-entities](references/list-entities.md)
+- [+list-metrics](references/list-metrics.md)
+- [+list-tables](references/list-tables.md)
+- [+get-table-columns](references/get-table-columns.md)

package/skills/te-meta/references/get-table-columns.md

@@ -0,0 +1,29 @@
+# meta +get-table-columns
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取指定 SQL 表的字段定义，包含字段名、数据类型等信息。用于在编写 SQL 查询前了解表结构。
+
+映射命令: `te-cli meta +get-table-columns`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--table` | string | 是 | 表名 |
+| `--schema` | string | 否 | Schema 名称，默认 `ta` |
+| `--catalog` | string | 否 | Catalog 名称，默认 `hive` |
+
+## 示例
+
+```bash
+# 获取表 v_event_1 的字段定义
+te-cli meta +get-table-columns --project-id 1 --table "v_event_1"
+
+# 指定 schema 和 catalog
+te-cli meta +get-table-columns -p 1 --table "v_event_1" --schema "ta" --catalog "hive"
+
+# 只提取字段名和类型
+te-cli meta +get-table-columns -p 1 --table "v_event_1" --jq '.columns[] | {name, type}'
+```

package/skills/te-meta/references/list-entities.md

@@ -0,0 +1,26 @@
+# meta +list-entities
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取项目的分析实体列表。分析实体定义了可用于分析的主体维度（如用户、设备、账号等）。
+
+映射命令: `te-cli meta +list-entities`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+# 获取项目 1 的分析实体
+te-cli meta +list-entities --project-id 1
+
+# 简写
+te-cli meta +list-entities -p 1
+
+# 表格输出
+te-cli meta +list-entities -p 1 --format table
+```

package/skills/te-meta/references/list-events.md

@@ -0,0 +1,29 @@
+# meta +list-events
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取项目的完整事件目录，包含事件名称、显示名、事件类型等信息。
+
+映射命令: `te-cli meta +list-events`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+# 获取项目 1 的所有事件
+te-cli meta +list-events --project-id 1
+
+# 简写
+te-cli meta +list-events -p 1
+
+# 只提取事件名称
+te-cli meta +list-events -p 1 --jq '.events[].eventName'
+
+# 表格输出
+te-cli meta +list-events -p 1 --format table
+```

package/skills/te-meta/references/list-metrics.md

@@ -0,0 +1,26 @@
+# meta +list-metrics
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取项目的预定义指标列表。预定义指标是平台中已配置好的复合度量，可直接在分析查询中引用。
+
+映射命令: `te-cli meta +list-metrics`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+# 获取项目 1 的预定义指标
+te-cli meta +list-metrics --project-id 1
+
+# 简写
+te-cli meta +list-metrics -p 1
+
+# 只提取指标名称和描述
+te-cli meta +list-metrics -p 1 --jq '.metrics[] | {name, description}'
+```

package/skills/te-meta/references/list-tables.md

@@ -0,0 +1,26 @@
+# meta +list-tables
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+获取项目中可通过 SQL 查询的表列表。常与 `+get-table-columns` 配合使用，先列表再查字段。
+
+映射命令: `te-cli meta +list-tables`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+# 获取项目 1 的可查询表
+te-cli meta +list-tables --project-id 1
+
+# 简写
+te-cli meta +list-tables -p 1
+
+# 表格输出
+te-cli meta +list-tables -p 1 --format table
+```

package/skills/te-meta/references/load-event-props.md

@@ -0,0 +1,27 @@
+# meta +load-event-props
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+加载指定事件的可筛选属性列表。用于构建分析查询时确定可用的筛选条件。
+
+映射命令: `te-cli meta +load-event-props`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--events` | json | 否 | 事件数组，格式: `[{"eventName":"<name>","eventType":"<type>"}]`。`eventType` 可选。省略时加载全部事件属性 |
+
+## 示例
+
+```bash
+# 加载单个事件的筛选属性
+te-cli meta +load-event-props --project-id 1 --events '[{"eventName":"login"}]'
+
+# 加载多个事件的筛选属性
+te-cli meta +load-event-props -p 1 --events '[{"eventName":"login"},{"eventName":"purchase"}]'
+
+# 不指定事件，加载全部
+te-cli meta +load-event-props -p 1
+```

package/skills/te-meta/references/load-measure-props.md

@@ -0,0 +1,24 @@
+# meta +load-measure-props
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+加载指定事件的可度量属性列表。用于构建分析查询时确定可用的度量字段（如求和、均值等聚合操作的目标属性）。
+
+映射命令: `te-cli meta +load-measure-props`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--events` | json | 是 | 事件数组，格式: `[{"eventName":"<name>","eventType":"<type>"}]`。`eventType` 可选 |
+
+## 示例
+
+```bash
+# 加载单个事件的度量属性
+te-cli meta +load-measure-props --project-id 1 --events '[{"eventName":"purchase"}]'
+
+# 加载多个事件的度量属性
+te-cli meta +load-measure-props -p 1 --events '[{"eventName":"login"},{"eventName":"purchase"}]'
+```

package/skills/te-operation/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: te-operation
+version: 1.0.0
+description: "TE 运营管理：任务、流程画布、推送通道、空间导航"
+metadata:
+  requires:
+    bins: ["te-cli"]
+  cliHelp: "te-cli operation --help"
+---
+
+# te-operation
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`] 了解认证、项目选择和通用约定。
+
+## 概述
+
+`te-operation` 域负责 TE 平台的运营管理能力，包括：
+
+- **任务管理** — 创建运营任务、查看任务列表与统计
+- **流程画布** — 保存和管理自动化流程（Flow）
+- **推送通道** — 查看推送通道配置
+- **空间导航** — 获取空间树、时区、标记时间等基础信息
+
+所有命令通过 `te-cli operation +<command>` 调用。
+
+## 核心场景
+
+### 1. 任务管理
+```bash
+# 创建运营任务
+te-cli operation +create-task -p <project-id> --task-config '{"name":"双十一活动","type":"push"}'
+
+# 分页查看任务列表
+te-cli operation +list-tasks -p <project-id> --page 1 --page-size 20
+
+# 查看任务统计数据
+te-cli operation +get-task-stats -p <project-id> --task-id 100
+```
+
+### 2. 流程画布
+```bash
+# 保存流程配置
+te-cli operation +save-flow -p <project-id> --flow-config '{"name":"新用户引导","nodes":[...]}'
+
+# 列出所有流程
+te-cli operation +list-flows -p <project-id>
+
+# 获取流程详情
+te-cli operation +get-flow -p <project-id> --flow-uuid "abc-123-def"
+```
+
+### 3. 推送通道
+```bash
+# 列出推送通道
+te-cli operation +list-channels -p <project-id>
+
+# 获取通道详情
+te-cli operation +get-channel -p <project-id> --channel-id 5
+```
+
+### 4. 空间导航与基础信息
+```bash
+# 获取空间树
+te-cli operation +get-space-tree -p <project-id>
+
+# 获取时区信息
+te-cli operation +get-timezone -p <project-id>
+
+# 列出标记时间
+te-cli operation +list-mark-times -p <project-id>
+```
+
+## 参考文档
+
+详见 `references/` 目录下各命令文档。

package/skills/te-operation/references/te-operation-create-task.md

@@ -0,0 +1,29 @@
+# te-operation +create-task
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+创建运营任务。
+
+映射命令: `te-cli operation +create-task`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--task-config` | json | 是 | 任务配置 JSON |
+
+## 安全约束
+
+此命令为 **写操作**，会在项目中创建新的运营任务。执行前应：
+
+1. 确认用户明确意图创建任务
+2. 检查 `--task-config` 内容是否合理
+3. 向用户确认关键参数（任务名称、类型等）后再执行
+
+## 示例
+
+```bash
+te-cli operation +create-task -p my-project \
+  --task-config '{"name":"双十一推送","type":"push","target_cluster_id":10}'
+```

package/skills/te-operation/references/te-operation-get-channel.md

@@ -0,0 +1,20 @@
+# operation +get-channel
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+获取推送通道详情及元信息。
+
+映射命令: `te-cli operation +get-channel`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--channel-id` | number | 是 | 通道 ID |
+
+## 示例
+
+```bash
+te-cli operation +get-channel -p 1 --channel-id 100
+```

package/skills/te-operation/references/te-operation-get-flow.md

@@ -0,0 +1,20 @@
+# te-operation +get-flow
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+获取指定流程画布的详细配置。
+
+映射命令: `te-cli operation +get-flow`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--flow-uuid` | string | 是 | 流程 UUID |
+
+## 示例
+
+```bash
+te-cli operation +get-flow -p my-project --flow-uuid "abc-123-def-456"
+```

package/skills/te-operation/references/te-operation-get-space-tree.md

@@ -0,0 +1,19 @@
+# operation +get-space-tree
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+获取项目的空间导航树（文件夹、仪表盘、报告层级结构）。
+
+映射命令: `te-cli operation +get-space-tree`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+te-cli operation +get-space-tree -p 1
+```

package/skills/te-operation/references/te-operation-get-task-stats.md

@@ -0,0 +1,20 @@
+# te-operation +get-task-stats
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+获取指定运营任务的统计数据。
+
+映射命令: `te-cli operation +get-task-stats`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--task-id` | number | 是 | 任务 ID |
+
+## 示例
+
+```bash
+te-cli operation +get-task-stats -p my-project --task-id 100
+```

package/skills/te-operation/references/te-operation-get-timezone.md

@@ -0,0 +1,19 @@
+# operation +get-timezone
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+获取项目的时区偏移设置。
+
+映射命令: `te-cli operation +get-timezone`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+te-cli operation +get-timezone -p 1
+```

package/skills/te-operation/references/te-operation-list-channels.md

@@ -0,0 +1,19 @@
+# te-operation +list-channels
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+列出项目下所有推送通道。
+
+映射命令: `te-cli operation +list-channels`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+
+## 示例
+
+```bash
+te-cli operation +list-channels -p my-project
+```

package/skills/te-operation/references/te-operation-list-flows.md

@@ -0,0 +1,19 @@
+# te-operation +list-flows
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+列出项目下所有流程画布。
+
+映射命令: `te-cli operation +list-flows`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+
+## 示例
+
+```bash
+te-cli operation +list-flows -p my-project
+```

package/skills/te-operation/references/te-operation-list-mark-times.md

@@ -0,0 +1,19 @@
+# operation +list-mark-times
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+列出项目的日期标注/里程碑。
+
+映射命令: `te-cli operation +list-mark-times`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+
+## 示例
+
+```bash
+te-cli operation +list-mark-times -p 1
+```

package/skills/te-operation/references/te-operation-list-tasks.md

@@ -0,0 +1,25 @@
+# te-operation +list-tasks
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+分页查看项目下的运营任务列表。
+
+映射命令: `te-cli operation +list-tasks`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--page` | number | 否 | 页码，默认 1 |
+| `--page-size` | number | 否 | 每页条数，默认 20 |
+
+## 示例
+
+```bash
+# 查看第一页任务
+te-cli operation +list-tasks -p my-project
+
+# 查看第 2 页，每页 10 条
+te-cli operation +list-tasks -p my-project --page 2 --page-size 10
+```

package/skills/te-operation/references/te-operation-save-flow.md

@@ -0,0 +1,29 @@
+# te-operation +save-flow
+
+> **前置条件:** 阅读 [`../te-shared/SKILL.md`]
+
+保存或更新流程画布配置。
+
+映射命令: `te-cli operation +save-flow`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | string | 否 | 项目 ID，未指定时使用默认项目 |
+| `--flow-config` | json | 是 | 流程配置 JSON |
+
+## 安全约束
+
+此命令为 **写操作**，会创建或更新流程画布。执行前应：
+
+1. 确认用户明确意图保存流程
+2. 检查 `--flow-config` 结构是否完整
+3. 向用户确认关键参数（流程名称、节点配置等）后再执行
+
+## 示例
+
+```bash
+te-cli operation +save-flow -p my-project \
+  --flow-config '{"name":"新用户引导流程","nodes":[{"type":"trigger","event":"register"}]}'
+```