@thinkingai/ae-cli 1.0.1

package/skills/te-engage/references/flow-process-report.md

@@ -0,0 +1,59 @@
+# te-engage +flow-process-report
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+查询流程级别的过程报表。
+
+映射命令: `te-cli te-engage +flow-process-report`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--report-type` | string | 是 | 报表类型 |
+| `--flow-id` | string | 否 | Flow ID |
+| `--flow-uuid` | string | 否 | Flow UUID |
+| `--request-id` | string | 否 | 查询 requestId |
+| `--push-language-code` | string | 否 | 推送语言代码 |
+| `--data-dim-type` | string | 否 | 数据维度类型 |
+| `--start-time` | string | 否 | 开始日期 |
+| `--end-time` | string | 否 | 结束日期 |
+| `--show-time-zone` | string | 否 | 展示时区偏移 |
+
+## 枚举说明
+
+### `--report-type`
+
+- `overview`: 流程总览
+- `detail`: 流程明细
+- `exit_detail`: 退出明细
+- `push_detail`: 推送明细
+
+### `--data-dim-type`
+
+- `uv`: 按去重用户数统计
+- `pv`: 按事件/次数统计
+
+### `--push-language-code`
+
+常见值包括：
+
+- `default`
+- `en`
+- `zh-Hans`
+- `zh-Hant`
+- `ja`
+- `ko`
+
+## 参数约束
+
+- `--flow-id` 和 `--flow-uuid` 至少传一个。
+- 当 `--report-type` 为 `detail`、`exit_detail`、`push_detail` 时，`--start-time` 和 `--end-time` 必填。
+- 当 `--report-type` 为 `overview` 时，可以不传时间，也可以成对传入 `--start-time` 和 `--end-time`。
+
+## 示例
+
+```bash
+te-cli te-engage +flow-process-report --project-id 1 --flow-uuid flow_uuid_123 --report-type overview
+```

package/skills/te-engage/references/manage-flow.md

@@ -0,0 +1,94 @@
+# te-engage +manage-flow
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+批量管理流程状态或审批动作。
+
+映射命令: `te-cli te-engage +manage-flow`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--action` | string | 是 | 操作类型 |
+| `--flow-list` | json | 否 | 审批列表 JSON 数组 |
+| `--pause-flow-list` | json | 否 | 暂停列表 JSON 数组 |
+| `--flow-id-list` | json | 否 | Flow ID JSON 数组 |
+| `--reason` | string | 否 | 审批原因 |
+
+## 枚举说明
+
+### `--action`
+
+- `approve`: 审批通过，需配合 `--flow-list`
+- `deny`: 审批拒绝，需配合 `--flow-list`
+- `cancel`: 撤销审批，需配合 `--flow-list`
+- `pause`: 暂停流程，需配合 `--pause-flow-list`
+- `recover`: 恢复流程，需配合 `--flow-id-list`
+- `end`: 结束流程，需配合 `--flow-id-list`
+
+## JSON 参数说明
+
+### `--flow-list`
+
+用于 `approve`、`deny`、`cancel` 这类审批动作。数组元素为对象：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `flowUuid` | string | 是 | Flow UUID |
+| `reason` | string | 否 | 单条审批原因 |
+
+示例：
+
+```json
+[
+  { "flowUuid": "flow_uuid_1", "reason": "approve by ops" }
+]
+```
+
+### `--pause-flow-list`
+
+用于 `pause` 动作。数组元素为对象：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `flowId` | string | 是 | Flow ID |
+| `flowInstanceProcessType` | number | 否 | 流程实例处理方式 |
+
+`flowInstanceProcessType` 枚举：
+
+- `1`: normal，正常暂停
+- `2`: force exit，强制退出实例
+
+示例：
+
+```json
+[
+  { "flowId": "flow_id_1", "flowInstanceProcessType": 1 }
+]
+```
+
+### `--flow-id-list`
+
+用于 `recover`、`end` 这类按 ID 批量操作的场景：
+
+```json
+["flow_id_1", "flow_id_2"]
+```
+
+## 安全约束
+
+此命令为 **写操作**，会改变流程状态。
+
+不同 `action` 需要的参数不同：
+
+- `approve` / `deny` / `cancel`：必须传 `--flow-list`
+- `pause`：必须传 `--pause-flow-list`
+- `recover` / `end`：必须传 `--flow-id-list`
+
+## 示例
+
+```bash
+te-cli te-engage +manage-flow --project-id 1 --action end --flow-id-list '["flow_id_1"]'
+```

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

@@ -0,0 +1,74 @@
+# te-engage +manage-strategy
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+批量管理策略状态或审批动作。
+
+映射命令: `te-cli te-engage +manage-strategy`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--config-id` | string | 是 | 配置项 ID |
+| `--action` | string | 是 | 操作类型 |
+| `--strategy-uuid-list` | json | 否 | 策略 UUID JSON 数组 |
+| `--strategy-list` | json | 否 | 审批条目 JSON 数组 |
+| `--reason` | string | 否 | 审批原因 |
+
+## 枚举说明
+
+### `--action`
+
+- `online`: 上线策略，需配合 `--strategy-uuid-list`
+- `offline`: 下线策略，需配合 `--strategy-uuid-list`
+- `suspend`: 暂停策略，需配合 `--strategy-uuid-list`
+- `delete`: 删除策略，需配合 `--strategy-uuid-list`
+- `approve`: 审批通过，需配合 `--strategy-list`
+- `deny`: 审批拒绝，需配合 `--strategy-list`
+- `cancel`: 撤销审批，需配合 `--strategy-list`
+
+## JSON 参数说明
+
+### `--strategy-uuid-list`
+
+用于 `online`、`offline`、`suspend`、`delete` 这类直接按 UUID 批处理的动作。
+
+```json
+["uuid_1", "uuid_2"]
+```
+
+### `--strategy-list`
+
+用于 `approve`、`deny`、`cancel` 这类审批动作。数组中每一项都是一个对象：
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `strategyUuid` | string | 是 | 策略 UUID |
+| `reason` | string | 否 | 针对该策略的审批原因 |
+
+示例：
+
+```json
+[
+  { "strategyUuid": "uuid_1", "reason": "approve by ops" }
+]
+```
+
+## 安全约束
+
+此命令为 **写操作**，会改变策略状态。
+
+不同 `action` 需要的参数不同：
+
+- `online` / `offline` / `suspend` / `delete`：必须传 `--strategy-uuid-list`
+- `approve` / `deny` / `cancel`：必须传 `--strategy-list`
+
+## 示例
+
+```bash
+te-cli te-engage +manage-strategy \
+  --project-id 1 --config-id cfg_123 --action online \
+  --strategy-uuid-list '["uuid_1"]'
+```

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

@@ -0,0 +1,37 @@
+# te-engage +manage-task
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+执行任务生命周期动作，例如发送、暂停、结束或审批。
+
+映射命令: `te-cli te-engage +manage-task`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--task-id` | string | 是 | 任务 ID |
+| `--action` | string | 是 | 操作类型 |
+| `--reason` | string | 否 | 审批类操作原因 |
+
+## 枚举说明
+
+### `--action`
+
+- `send`: 立即发送，通常用于手动触发且处于 waiting 状态的任务
+- `pause`: 暂停运行中的任务
+- `end`: 结束运行中或暂停中的任务
+- `approve`: 审批通过
+- `deny`: 审批拒绝
+- `cancel`: 撤销审批
+
+## 安全约束
+
+此命令为 **写操作**，会改变任务状态。
+
+## 示例
+
+```bash
+te-cli te-engage +manage-task --project-id 1 --task-id task_123 --action pause
+```

package/skills/te-engage/references/modify-flow-base-info.md

@@ -0,0 +1,27 @@
+# te-engage +modify-flow-base-info
+
+> **前置条件:** 阅读 [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
+
+修改流程画布的基础信息。
+
+映射命令: `te-cli te-engage +modify-flow-base-info`
+
+## Flags
+
+| Flag | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--project-id` / `-p` | number | 是 | 项目 ID |
+| `--flow-uuid` | string | 是 | Flow UUID |
+| `--flow-name` | string | 否 | 新流程名称 |
+| `--flow-desc` | string | 否 | 新流程描述 |
+| `--group-id` | number | 否 | 新分组 ID |
+
+## 安全约束
+
+此命令为 **写操作**，会修改流程基础信息。
+
+## 示例
+
+```bash
+te-cli te-engage +modify-flow-base-info --project-id 1 --flow-uuid flow_uuid_123 --flow-name "新名称"
+```