@thinkingai/ae-cli 1.0.1

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

@@ -0,0 +1,163 @@
+---
+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

@@ -0,0 +1,118 @@
+---
+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

@@ -0,0 +1,246 @@
+---
+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

@@ -0,0 +1,107 @@
+---
+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，不可混用