@thinkingai/ae-cli 1.0.1 → 1.0.15

package/skills/te-dataops/references/dataops-flow-create.md

@@ -1,163 +0,0 @@
----
-name: dataops-flow-create
-version: 1.0.0
-description: "任务流创建与配置：创建任务流、添加任务节点、配置依赖关系、保存任务定义、配置调度、测试、发布到生产。触发关键词：创建任务流、新建工作流、配置调度、添加任务节点、发布、cron、定时执行。"
-metadata:
-  requires:
-    bins: ["te-cli"]
----
-
-# DataOps 任务流创建与配置
-
-> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
-
-使用 `dataops_flow` 子命令管理任务流生命周期。
-
-**任务流生命周期：创建 → 配置节点 → 配置调度 → DEV 环境测试 → 发布到 PROD → 上线调度**
-
----
-
-## 完整任务流创建流程
-
-按顺序执行以下步骤，从零创建一个可上线的任务流。
-
-### Step 1: 创建任务流
-
-```bash
-te-cli dataops_flow +create_flow --spaceCode "${spaceCode}" \
-  --flowName "每日ETL流程" --remark "处理用户数据" --confirmed true
-# 返回 flowCode，后续步骤都需要
-```
-
-### Step 2: 创建任务节点（可多次调用）
-
-```bash
-# 创建 SQL 任务
-te-cli dataops_flow +create_task --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --taskName "处理用户数据" --taskType "TRINO_SQL" --confirmed true
-# 返回 taskCode
-
-# 创建带前置依赖的任务
-te-cli dataops_flow +create_task --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --taskName "导出结果" --taskType "TRINO_SQL" \
-  --preTaskCode "${upstreamTaskCode}" --confirmed true
-```
-
-**任务节点类型：**
-
-| 类型 | 说明 | 典型用途 |
-|------|------|---------|
-| TRINO_SQL | Trino SQL 查询 | 数据加工、ETL |
-| SHELL | Shell 脚本 | 系统命令、文件操作 |
-| FLOW_CHECK | 流程检查 | 检查上游任务流是否完成 |
-| TASK_CHECK | 任务检查 | 检查指定任务是否完成 |
-| OFFLINE_SYNC | 离线同步 | 集成方案数据同步（需 syncId） |
-| APP_SYNC | 应用同步 | 应用表数据同步（需 syncId） |
-| PLACE_HOLDER | 占位符 | 流程控制、逻辑分组 |
-
-### Step 3: 保存任务定义（配置 SQL/Shell 内容）
-
-```bash
-# SQL 任务
-te-cli dataops_flow +save_task_definition --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --taskCode "${taskCode}" \
-  --taskContentJson '{"sql":"SELECT * FROM dwd_user","repoCode":"te_etl","catalog":"hive","schema":"ws_default_dev"}' \
-  --failRetryTimes 3 --failRetryInterval 30 --timeout 60 --confirmed true
-
-# Shell 任务
-te-cli dataops_flow +save_task_definition --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --taskCode "${taskCode}" \
-  --taskContentJson '{"script":"#!/bin/bash\necho hello"}' \
-  --confirmed true
-```
-
-### Step 4: 校验 SQL（推荐，仅 TRINO_SQL 类型）
-
-```bash
-te-cli dataops_flow +validate_task_sql --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --taskCode "${taskCode}" \
-  --sql "SELECT * FROM dwd_user" --repoCode "te_etl" \
-  --catalog "hive" --schema "ws_default_dev"
-# 检查 valid=true，否则查看 message 和 errorPosition
-```
-
-### Step 5: 添加任务依赖关系（DAG 连线）
-
-```bash
-te-cli dataops_flow +add_task_relation --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --preTaskCode "${upstreamTaskCode}" --taskCode "${downstreamTaskCode}" \
-  --confirmed true
-```
-
-### Step 6: 配置调度
-
-```bash
-# CRON 表达式定时执行
-te-cli dataops_flow +save_schedule_config --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --scheduled 1 --scheduleType "CRON" \
-  --cron "0 0 2 * * ?" --confirmed true
-# 示例：0 0 2 * * ? = 每天凌晨2点
-```
-
-**CRON 格式**（6 字段）：`秒 分 时 日 月 周`
-- `0 0 */4 * * ?` — 每 4 小时
-- `0 30 8 * * 1-5` — 工作日 8:30
-
-### Step 7: DEV 环境测试
-
-```bash
-# 手动触发执行
-te-cli dataops_flow +execute_flow --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --env "DEV" --confirmed true
-
-# 查看执行状态
-te-cli dataops_flow +get_execute_dag --spaceCode "${spaceCode}" --executeId "${executeId}"
-
-# 查看任务日志（从 DAG 获取 bsTaskInstanceId 和 taskCode）
-te-cli dataops_flow +get_task_instance_log --bsTaskInstanceId "${instanceId}" --taskCode "${taskCode}"
-
-# 根据日志调整配置后，重复测试
-```
-
-### Step 8: 发布到生产
-
-```bash
-te-cli dataops_flow +release_flow --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --confirmed true
-# 发布后 PROD 调度立即生效，不会中断运行中的实例
-```
-
----
-
-## 命令速查
-
-| 命令 | 用途 | 关键 Flags |
-|------|------|-----------|
-| `+create_flow` | 创建任务流 | `--spaceCode` `--flowName` `--remark` `--confirmed` |
-| `+create_task` | 创建任务节点 | `--spaceCode` `--flowCode` `--taskName` `--taskType` `--syncId` `--preTaskCode` `--confirmed` |
-| `+save_task_definition` | 保存任务定义 | `--spaceCode` `--flowCode` `--taskCode` `--taskContentJson` `--failRetryTimes` `--failRetryInterval` `--timeout` `--confirmed` |
-| `+validate_task_sql` | 校验 SQL | `--spaceCode` `--flowCode` `--taskCode` `--sql` `--repoCode` `--catalog` `--schema` |
-| `+add_task_relation` | 添加依赖 | `--spaceCode` `--flowCode` `--preTaskCode` `--taskCode` `--confirmed` |
-| `+save_schedule_config` | 配置调度 | `--spaceCode` `--flowCode` `--scheduled` `--scheduleType` `--cron` `--confirmed` |
-| `+get_flow_dag` | 查看 DAG 结构 | `--spaceCode` `--flowCode` `--env` |
-| `+get_task_params` | 查看任务参数 | `--spaceCode` `--flowCode` `--taskCode` `--env` |
-| `+execute_flow` | 手动执行 | `--spaceCode` `--flowCode` `--env` `--confirmed` |
-| `+get_execute_dag` | 查看运行态 DAG | `--spaceCode` `--executeId` |
-| `+get_task_instance_log` | 查看任务日志 | `--bsTaskInstanceId` `--taskCode` `--startOffset` `--limit` |
-| `+release_flow` | 发布到生产 | `--spaceCode` `--flowCode` `--confirmed` |
-
-## 参数说明
-
-- **参数引用**: 任务中通过 `${paramKey}` 引用空间参数（如 `${ws_run_date}`）
-- **环境**: `DEV`（默认）| `PROD`
-- **taskContentJson**: JSON 字符串，格式因 taskType 而异：
-  - TRINO_SQL: `{"sql":"SELECT ...","repoCode":"xxx","catalog":"hive","schema":"db"}`
-  - SHELL: `{"script":"#!/bin/bash\n..."}`
-
-## 注意事项
-
-1. **flowCode 获取**: 通过 `+list_flows` 获取（见 `dataops-flow-monitor` Skill）
-2. **taskCode 获取**: 通过 `+create_task` 返回或 `+get_flow_dag` 查询
-3. **发布影响**: 将 DEV 所有变更同步到 PROD，PROD 调度立即生效
-4. **SQL 校验**: 保存 TRINO_SQL 任务前建议先校验
-5. **不能创建循环依赖**

package/skills/te-dataops/references/dataops-flow-monitor.md

@@ -1,118 +0,0 @@
----
-name: dataops-flow-monitor
-version: 1.0.0
-description: "任务流执行与监控：查看执行实例、运行态 DAG、任务日志、手动执行/停止任务流。触发关键词：执行任务流、运行实例、监控、日志、停止、DAG、排错、实例、flow instance。"
-metadata:
-  requires:
-    bins: ["te-cli"]
----
-
-# DataOps 任务流执行与监控
-
-> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
-
-使用 `dataops_flow` 子命令执行和监控任务流。
-
-**核心概念：**
-- **executeId** — flow_* 工具使用的执行记录 ID（通过 `+list_flow_instances` 获取）
-- **flowInstanceId** — operations_* 工具使用的运维实例 ID（两者不互通，不可混用）
-- **实例列表默认查询 PROD 环境**（与其他工具默认 DEV 不同）
-
----
-
-## 工作流 A：查找并查看任务流执行状态
-
-```bash
-# Step 1: 搜索任务流（获取 flowCode）
-te-cli dataops_flow +list_flows --spaceCode "${spaceCode}" --keyword "etl"
-
-# Step 2: 查看执行实例列表（默认 PROD，按时间倒序）
-te-cli dataops_flow +list_flow_instances --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --env "PROD" --size 30
-
-# Step 3: 查看运行态 DAG（含各节点执行状态）
-te-cli dataops_flow +get_execute_dag --spaceCode "${spaceCode}" --executeId "${executeId}"
-
-# Step 4: 查看执行记录详情
-te-cli dataops_flow +get_execute_record --spaceCode "${spaceCode}" --executeId "${executeId}"
-```
-
----
-
-## 工作流 B：排查任务失败
-
-```bash
-# Step 1: 获取运行态 DAG，定位失败节点
-te-cli dataops_flow +get_execute_dag --spaceCode "${spaceCode}" --executeId "${executeId}"
-# 从返回中找到 status=FAILED 的节点，获取其 bsTaskInstanceId 和 taskCode
-
-# Step 2: 查看失败任务的日志
-te-cli dataops_flow +get_task_instance_log --bsTaskInstanceId "${bsTaskInstanceId}" \
-  --taskCode "${taskCode}" --limit 100
-
-# Step 3: 查看任务定义（确认 SQL/配置）
-te-cli dataops_flow +get_task_params --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --taskCode "${taskCode}"
-
-# Step 4: 修复后重新执行
-te-cli dataops_flow +execute_flow --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --env "DEV" --confirmed true
-```
-
----
-
-## 工作流 C：手动执行与停止
-
-```bash
-# 手动触发执行（默认 DEV，可指定 PROD）
-te-cli dataops_flow +execute_flow --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --env "DEV" --confirmed true
-# 返回 executeId
-
-# 监控执行过程
-te-cli dataops_flow +get_execute_dag --spaceCode "${spaceCode}" --executeId "${executeId}"
-
-# 必要时停止执行（不可撤销）
-te-cli dataops_flow +stop_flow --spaceCode "${spaceCode}" \
-  --flowCode "${flowCode}" --executeId "${executeId}" --confirmed true
-```
-
----
-
-## 工作流 D：查看任务流结构
-
-```bash
-# 查看任务流定义态 DAG（静态结构、依赖关系）
-te-cli dataops_flow +get_flow_dag --spaceCode "${spaceCode}" --flowCode "${flowCode}"
-
-# 查看任务流基本信息
-te-cli dataops_flow +get_flow_detail --spaceCode "${spaceCode}" --flowCode "${flowCode}"
-
-# 查看调度配置
-te-cli dataops_flow +get_schedule_config --spaceCode "${spaceCode}" --flowCode "${flowCode}"
-```
-
----
-
-## 命令速查
-
-| 命令 | 用途 | 关键 Flags |
-|------|------|-----------|
-| `+list_flows` | 搜索任务流 | `--spaceCode` `--keyword` |
-| `+get_flow_detail` | 任务流信息 | `--spaceCode` `--flowCode` `--env` |
-| `+get_flow_dag` | 定义态 DAG | `--spaceCode` `--flowCode` `--env` |
-| `+get_schedule_config` | 调度配置 | `--spaceCode` `--flowCode` `--env` |
-| `+execute_flow` | 手动执行 | `--spaceCode` `--flowCode` `--env` `--confirmed` |
-| `+stop_flow` | 停止执行 | `--spaceCode` `--flowCode` `--executeId` `--confirmed` |
-| `+list_flow_instances` | 实例列表 | `--spaceCode` `--flowCode` `--env` `--size` |
-| `+get_execute_record` | 执行记录 | `--spaceCode` `--executeId` |
-| `+get_execute_dag` | 运行态 DAG | `--spaceCode` `--executeId` |
-| `+get_task_instance_log` | 任务日志 | `--bsTaskInstanceId` `--taskCode` `--startOffset` `--limit` |
-| `+get_task_params` | 任务参数 | `--spaceCode` `--flowCode` `--taskCode` `--env` |
-| `+update_flow` | 更新任务流 | `--spaceCode` `--flowCode` `--flowName` `--remark` `--confirmed` |
-
-## 参数说明
-
-- **env**: `DEV`（开发）| `PROD`（生产，实例列表默认 PROD）
-- **任务状态**: `success` / `failure` / `running` / `waiting`
-- **DAG 区别**: `+get_flow_dag` 返回静态定义结构，`+get_execute_dag` 返回含执行状态的运行态结构

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

@@ -1,246 +0,0 @@
----
-name: dataops-integration
-version: 1.0.0
-description: "数据源与数据集成：创建数据源、创建同步方案、配置字段映射、执行同步、监控同步。触发关键词：数据源、同步、integration、sync、字段映射、数据接入、datasource、MySQL、ClickHouse。"
-metadata:
-  requires:
-    bins: ["te-cli"]
----
-
-# DataOps 数据源与数据集成
-
-> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
-
-使用 `dataops_integration` 子命令管理数据源和同步方案。
-
-**核心规则：**
-- 预置仓（te_etl）与非预置仓的配置参数差异很大，必须严格按照模板生成
-- sourceConfig/sinkConfig/channelConfig/fieldsMapping 都是 JSON 字符串
-- 创建同步方案前先测试数据源连接
-
----
-
-## 工作流 A：创建数据源
-
-```bash
-# Step 1: 查看支持的数据源组件类型
-te-cli dataops_integration +list_datasource_components
-
-# Step 2: 测试连接（临时配置，不保存）
-te-cli dataops_integration +test_datasource_connect --spaceCode "${spaceCode}" \
-  --componentName "MySQL" \
-  --configValue '{"host":"localhost","port":3306,"username":"root","password":"xxx","database":"test"}'
-
-# Step 3: 创建数据源
-te-cli dataops_integration +add_datasource --spaceCode "${spaceCode}" \
-  --componentName "MySQL" --dataSourceName "生产MySQL" \
-  --sharedConfig true \
-  --envJsonList '[{"host":"localhost","port":3306,"username":"root","password":"xxx"}]' \
-  --confirmed true
-```
-
----
-
-## 工作流 B：创建同步方案（完整流程）
-
-### Step 1: 查看可用数据源
-
-```bash
-# 查看空间所有数据源
-te-cli dataops_integration +list_space_datasources --spaceCode "${spaceCode}"
-
-# 查看可用于同步的数据源（按 source/sink 分类）
-te-cli dataops_integration +list_sync_datasources --spaceCode "${spaceCode}"
-```
-
-### Step 2: 浏览源表结构
-
-```bash
-# 列出数据源下的数据库
-te-cli dataops_integration +list_datasource_databases --spaceCode "${spaceCode}" \
-  --datasourceId "${datasourceId}"
-
-# 列出数据库下的表
-te-cli dataops_integration +list_datasource_tables --spaceCode "${spaceCode}" \
-  --datasourceId "${datasourceId}" --database "test"
-
-# 获取表结构（列定义、分区）
-te-cli dataops_integration +get_table_structure --spaceCode "${spaceCode}" \
-  --datasourceId "${datasourceId}" --database "test" --tablePath "users"
-```
-
-### Step 3: 创建同步方案
-
-**关键：必须严格按照下方 JSON 模板生成参数**
-
-```bash
-te-cli dataops_integration +add_sync_solution --spaceCode "${spaceCode}" \
-  --syncName "MySQL到预置仓同步" \
-  --srcComponent "MySQL" --srcDatasourceId "${mysqlDatasourceId}" \
-  --sinkComponent "hive" --sinkDatasourceId "te_etl@TASK_ENGINE_TRINO" \
-  --sourceConfig '{"component":"MySQL","datasourceId":"xxx","database":"test","tablePath":"users"}' \
-  --sinkConfig '{"component":"hive","datasourceId":"te_etl@TASK_ENGINE_TRINO","database":"","tablePath":"ods_users_mysql","tableType":"PHYSICAL_TABLE","bizClassify":"CURRENT","dbBizType":"TASK_ENV_DB","authedSpace":"","partitionKeys":[],"dataSaveMode":1,"batchSize":20000}' \
-  --channelConfig '{"limitType":"0","gatewayConfig":{"engineFlag":"TASK_ENGINE_TRINO","companyId":1,"appDefinition":"APP_GAIA","bizFlag":"BIZ_GAIA_TASK_RELEASE","repoCode":"te_etl","spaceCode":"default"}}' \
-  --fieldsMapping '{"mapping":[{"source":{"name":"id","type":"int","manual":false,"partitionKey":false,"primaryKey":false,"shardingKey":false,"sortingKey":false,"upsertKey":false},"target":{"name":"id","type":"int","manual":false,"partitionKey":false,"primaryKey":false,"shardingKey":false,"sortingKey":false,"upsertKey":false}}]}' \
-  --confirmed true
-```
-
-### Step 4: 执行同步
-
-```bash
-# 手动执行同步方案
-te-cli dataops_integration +exec_sync_solution --spaceCode "${spaceCode}" \
-  --syncId "${syncId}" --confirmed true
-
-# 查看执行历史
-te-cli dataops_integration +list_sync_exec_histories --spaceCode "${spaceCode}" \
-  --syncId "${syncId}" --limit 20
-
-# 查看执行详情
-te-cli dataops_integration +get_sync_exec_info --spaceCode "${spaceCode}" \
-  --syncId "${syncId}" --taskId "${taskId}"
-
-# 必要时停止执行
-te-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
-  --syncId "${syncId}" --taskId "${taskId}" --confirmed true
-```
-
----
-
-## JSON 配置模板
-
-### 预置仓作为目标端（Sink）
-
-```json
-{
-  "component": "hive",
-  "datasourceId": "te_etl@TASK_ENGINE_TRINO",
-  "database": "",
-  "tablePath": "ods_users_mysql",
-  "tableType": "PHYSICAL_TABLE",
-  "bizClassify": "CURRENT",
-  "dbBizType": "TASK_ENV_DB",
-  "authedSpace": "",
-  "partitionKeys": [],
-  "dataSaveMode": 1,
-  "batchSize": 20000
-}
-```
-
-### 非预置仓（如 MySQL）
-
-```json
-{
-  "component": "MySQL",
-  "datasourceId": "ds-uuid-xxx",
-  "database": "test",
-  "tablePath": "users"
-}
-```
-
-### channelConfig（源端或目标端涉及预置仓时必须包含 gatewayConfig）
-
-```json
-{
-  "limitType": "0",
-  "gatewayConfig": {
-    "engineFlag": "TASK_ENGINE_TRINO",
-    "companyId": 1,
-    "appDefinition": "APP_GAIA",
-    "bizFlag": "BIZ_GAIA_TASK_RELEASE",
-    "repoCode": "te_etl",
-    "spaceCode": "default"
-  }
-}
-```
-
-### fieldsMapping（双列映射）
-
-```json
-{
-  "mapping": [
-    {
-      "source": {
-        "name": "id",
-        "type": "int",
-        "manual": false,
-        "partitionKey": false,
-        "primaryKey": false,
-        "shardingKey": false,
-        "sortingKey": false,
-        "upsertKey": false
-      },
-      "target": {
-        "name": "id",
-        "type": "int",
-        "manual": false,
-        "partitionKey": false,
-        "primaryKey": false,
-        "shardingKey": false,
-        "sortingKey": false,
-        "upsertKey": false
-      }
-    }
-  ]
-}
-```
-
----
-
-## 命令速查
-
-| 命令 | 用途 | 关键 Flags |
-|------|------|-----------|
-| `+list_datasource_components` | 支持的组件 | 无 |
-| `+list_space_datasources` | 空间数据源 | `--spaceCode` `--componentName` `--dataSourceName` |
-| `+add_datasource` | 创建数据源 | `--spaceCode` `--componentName` `--dataSourceName` `--sharedConfig` `--envJsonList` `--confirmed` |
-| `+test_datasource_connect` | 测试连接 | `--spaceCode` `--componentName` `--configValue` |
-| `+list_datasource_databases` | 列出数据库 | `--spaceCode` `--datasourceId` |
-| `+list_datasource_tables` | 列出表 | `--spaceCode` `--datasourceId` `--database` |
-| `+get_table_structure` | 表结构 | `--spaceCode` `--datasourceId` `--database` `--tablePath` |
-| `+list_sync_solutions` | 同步方案列表 | `--spaceCode` |
-| `+add_sync_solution` | 创建同步方案 | `--spaceCode` `--syncName` `--srcComponent` `--srcDatasourceId` `--sinkComponent` `--sinkDatasourceId` `--sourceConfig` `--sinkConfig` `--channelConfig` `--fieldsMapping` `--confirmed` |
-| `+exec_sync_solution` | 执行同步 | `--spaceCode` `--syncId` `--confirmed` |
-| `+list_sync_exec_histories` | 执行历史 | `--spaceCode` `--syncId` `--execType` `--limit` |
-| `+get_sync_exec_info` | 执行详情 | `--spaceCode` `--syncId` `--taskId` |
-| `+stop_sync_solution` | 停止同步 | `--spaceCode` `--syncId` `--taskId` `--confirmed` |
-
-## 组件条件必填参数
-
-部分组件存在根据部署模式不同而变化的条件必填参数，`+list_datasource_components` 的 requiredFields 可能不包含这些参数（它们在 optionalFields 或 importantNotes 中说明）。创建数据源时务必根据用户选择的 mode 补齐对应参数。
-
-### MongoDB
-
-| mode 值 | 额外必填参数 | 说明 |
-|----------|-------------|------|
-| `single` | 无 | 单节点模式 |
-| `replicaSet` | `replicaSet` | 副本集名称（如 `rs0`），字段名为 `replicaSet` 而非 `replicaSetName` |
-| `sharded` | 无 | 分片集群模式 |
-
-**MongoDB 各模式 envJsonList 示例：**
-
-单节点：
-```json
-[{"mode":"single","nodes":[{"host":"10.0.0.1","port":"27017"}],"database":"mydb","username":"admin","password":"xxx"}]
-```
-
-副本集群（注意 `replicaSet` 必填）：
-```json
-[{"mode":"replicaSet","nodes":[{"host":"10.0.0.1","port":"27017"},{"host":"10.0.0.2","port":"27017"}],"database":"mydb","username":"admin","password":"xxx","replicaSet":"rs0"}]
-```
-
-分片集群：
-```json
-[{"mode":"sharded","nodes":[{"host":"10.0.0.1","port":"27017"},{"host":"10.0.0.2","port":"27017"}],"database":"mydb","username":"admin","password":"xxx"}]
-```
-
----
-
-## 关键规则
-
-1. **表名规则**: 写入预置仓时，未指定表名则用 `ods_${来源表名}_${组件名小写}`
-2. **tablePath**: PostgreSQL 用 `模式.表名`，其他组件直接用表名
-3. **预置仓 database 为空**，非预置仓 database 必填
-4. **channelConfig**: 涉及预置仓时必须包含 gatewayConfig
-5. **字段映射**: 每个字段对象必须包含 manual/partitionKey/primaryKey/shardingKey/sortingKey/upsertKey 属性
-6. **条件必填参数**: 部分组件（如 MongoDB）根据 mode 不同有额外必填字段，详见上方「组件条件必填参数」

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

@@ -1,107 +0,0 @@
----
-name: dataops-operations
-version: 1.0.0
-description: "运维操作与补数管理：搜索运维实例、重跑失败任务、停止实例、补数任务管理。触发关键词：运维、监控、补数、重跑、告警、operations、实例、backfill。"
-metadata:
-  requires:
-    bins: ["te-cli"]
----
-
-# DataOps 运维操作与补数管理
-
-> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
-
-使用 `dataops_operations` 子命令进行运维操作。
-
-**核心概念：**
-- **flowInstanceId** — operations_* 工具使用的运维实例 ID
-- **executeId** — flow_* 工具使用的执行记录 ID（两者不互通，不可混用）
-- 运维视角关注生产环境的实例管理和补数操作
-
----
-
-## 工作流 A：运维实例查询与操作
-
-```bash
-# Step 1: 搜索任务流实例（支持按状态/负责人/时间筛选）
-te-cli dataops_operations +search_flow_instances --spaceCode "${spaceCode}" \
-  --pageNum 1 --pageSize 20
-
-# Step 2: 查看实例下的所有任务节点及执行状态
-te-cli dataops_operations +list_flow_task_instances --spaceCode "${spaceCode}" \
-  --flowInstanceId "${flowInstanceId}"
-
-# Step 3: 获取任务节点定义详情
-te-cli dataops_operations +get_task_definition --spaceCode "${spaceCode}" \
-  --flowInstanceId "${flowInstanceId}" --taskCode "${taskCode}"
-
-# Step 4: 重跑失败的任务流实例（从失败节点继续）
-te-cli dataops_operations +rerun_flow_instance --spaceCode "${spaceCode}" \
-  --flowInstanceId "${flowInstanceId}" --confirmed true
-
-# Step 5: 停止正在运行的实例
-te-cli dataops_operations +stop_flow_instance --spaceCode "${spaceCode}" \
-  --flowInstanceId "${flowInstanceId}" --confirmed true
-
-# Step 6: 控制实例运行状态（暂停/强制暂停/恢复）
-te-cli dataops_operations +control_flow_instance --spaceCode "${spaceCode}" \
-  --flowInstanceId "${flowInstanceId}" --action "PAUSE" --confirmed true
-```
-
----
-
-## 工作流 B：补数任务管理
-
-补数任务用于批量重跑历史数据。
-
-```bash
-# Step 1: 查询补数任务列表
-te-cli dataops_operations +list_flow_jobs --spaceCode "${spaceCode}" \
-  --pageNum 1 --pageSize 20
-
-# Step 2: 获取补数任务详情（配置、日期范围、并发设置）
-te-cli dataops_operations +get_flow_job_detail --spaceCode "${spaceCode}" \
-  --jobId "${jobId}"
-
-# Step 3: 获取补数任务的执行计划列表（每个日期的状态）
-te-cli dataops_operations +list_flow_job_plans --spaceCode "${spaceCode}" \
-  --jobId "${jobId}"
-
-# Step 4: 停止正在执行的补数任务
-te-cli dataops_operations +stop_flow_job --spaceCode "${spaceCode}" \
-  --jobId "${jobId}" --confirmed true
-```
-
----
-
-## 工作流 C：任务节点实例查询
-
-```bash
-# 搜索任务节点实例（支持按状态/类型/时间筛选）
-te-cli dataops_operations +search_task_instances --spaceCode "${spaceCode}" \
-  --pageNum 1 --pageSize 20
-```
-
----
-
-## 命令速查
-
-| 命令 | 用途 | 关键 Flags |
-|------|------|-----------|
-| `+search_flow_instances` | 搜索任务流实例 | `--spaceCode` `--pageNum` `--pageSize` |
-| `+list_flow_task_instances` | 实例任务节点 | `--spaceCode` `--flowInstanceId` |
-| `+get_task_definition` | 任务节点定义 | `--spaceCode` `--flowInstanceId` `--taskCode` |
-| `+rerun_flow_instance` | 重跑实例 | `--spaceCode` `--flowInstanceId` `--confirmed` |
-| `+stop_flow_instance` | 停止实例 | `--spaceCode` `--flowInstanceId` `--confirmed` |
-| `+control_flow_instance` | 控制实例状态 | `--spaceCode` `--flowInstanceId` `--action` `--confirmed` |
-| `+search_task_instances` | 搜索任务实例 | `--spaceCode` `--pageNum` `--pageSize` |
-| `+list_flow_jobs` | 补数任务列表 | `--spaceCode` `--pageNum` `--pageSize` |
-| `+get_flow_job_detail` | 补数任务详情 | `--spaceCode` `--jobId` |
-| `+list_flow_job_plans` | 补数执行计划 | `--spaceCode` `--jobId` |
-| `+stop_flow_job` | 停止补数任务 | `--spaceCode` `--jobId` `--confirmed` |
-
-## 参数说明
-
-- **action**: `PAUSE`（暂停）| `FORCE_PAUSE`（强制暂停）| `RESUME`（恢复）
-- **实例状态**: `RUNNING` / `SUCCESS` / `FAILURE` / `WAITING` / `STOPPED`
-- **flowInstanceId vs executeId**: 运维工具用 flowInstanceId，flow 工具用 executeId，不可混用