ocean-sr-data-preprocess

name: ocean-SR-data-preprocess description: 海洋超分辨率数据预处理技能 - 专用于超分辨率场景的NC到NPY数据格式转换 version: 3.3.0 author: kongzhiquan contributors: leizheng last_modified: 2026-02-05

海洋数据预处理技能

核心原则

1. 数据预处理定义：不破坏原有数据结构，不做标准化，只做格式转换
2. 警告优先：任何警告必须暂停询问用户，不能自动继续
3. 禁止自动决策：所有变量选择、参数设置必须由用户确认
4. 错误不自动重试：遇到错误展示给用户，等待指示

可用工具

4 阶段强制确认流程

工具在每个阶段强制返回，Agent 无法跳过确认步骤。

调用工具（无 dyn_vars）
    ↓
⛔ 阶段 1: awaiting_variable_selection
    │  → 展示动态变量，询问"您要研究哪些变量？"
    ↓
⛔ 阶段 2: awaiting_static_selection
    │  → 展示静态/掩码变量，询问"需要保存哪些？使用哪些掩码？"
    ↓
⛔ 阶段 3: awaiting_parameters
    │  → 询问"下采样倍数？插值方法？划分比例？"
    ↓
⛔ 阶段 4: awaiting_execution
    │  → 展示完整参数汇总，等待"确认执行"
    ↓
✅ 执行处理 (A→B→C→D→E)
    ↓
📊 调用 ocean_sr_preprocess_metrics 计算指标
    ↓
📝 调用 ocean_sr_preprocess_report 生成报告

Token 机制：每个阶段返回 confirmation_token，下次调用必须携带，防止跳过阶段。

快速参数参考

ocean_sr_preprocess_full 核心参数

完整参数说明：见 references/parameters.md

禁止行为（核心）

两种超分模式

日期文件名（默认开启）

输出文件名示例：20200101.npy, 20200102.npy（自动从 NC 文件提取日期）

完整工作流程

1. 收集信息 → 数据目录、输出目录
2. 分析数据 → ocean_inspect_data 或 ocean_sr_preprocess_full
3. 用户选择 → 研究变量、静态变量、掩码变量
4. 确认参数 → scale、method、划分比例
5. 执行前确认 → 展示所有参数，等待"确认执行"
6. 执行处理 → ocean_sr_preprocess_full (user_confirmed=true)
7. 计算指标 → ocean_sr_preprocess_metrics（必须）
8. 生成报告 → ocean_sr_preprocess_report + Agent 填写分析

详细流程：见 references/workflow-detail.md

参考文档索引

详细信息请按需读取以下文档：

输出目录结构

output/
├── train/
│   ├── hr/         ← 高分辨率数据
│   └── lr/         ← 低分辨率数据
├── valid/
├── test/
├── static_variables/
├── visualisation_data_process/
├── metrics_result.json
└── preprocessing_report.md