# Time Gradual Change Check

> 时序平缓性检测工具。检测时序数据是否符合渐变规律，包括突变跳点检测（相邻点变化超阈值） 和方向振荡检测（窗口内反复升降），对应功能说明(八)模块中的平缓性检测维度。 当用户提到时序平缓性、渐变规律、突变跳点、方向振荡等需求时使用此skill。

- Skill: `cas-bigdatalab/time-gradual-change-check` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add cas-bigdatalab/time-gradual-change-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cas-bigdatalab/time-gradual-change-check/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cas-bigdatalab (https://skillmd.com/u/cas-bigdatalab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cas-bigdatalab/time-gradual-change-check

---


# time_gradual_change_check 时序平缓性检测Skill

## 功能概述

与 QC13（恒定值检测）互补的平缓性检测。两项检查：(1) 突变跳点——相邻时间点的变化幅度超过 jump_threshold；(2) 方向振荡——滑动窗口内数值升降反转次数超过 oscillation_limit。

## 处理逻辑

1. 读取输入数据表，按时间字段排序
2. 计算相邻点的一阶差分
3. 突变跳点：标记 |Δ| > jump_threshold 的点及前一个点
4. 方向振荡：滑动窗口内统计符号变化次数，超限则标记整个窗口
5. 输出带质控标识的结果文件

## 支持的文件格式

- CSV (.csv) / TSV (.tsv) / Excel (.xls, .xlsx) / SPSS (.sav)

## 使用方法

```bash
python scripts/time_gradual_change_check.py \
    --input_path <输入文件> \
    --output_path <输出文件> \
    --check_field temperature \
    --time_field timestamp \
    --time_format "%Y-%m-%d %H:%M:%S" \
    --jump_threshold 10.0 \
    --qc_mark QC0017 \
    --mark_field_name QC0000
```

## 参数说明

| 参数 | 必填 | 说明 |
|------|------|------|
| `--input_path` | 是 | 输入文件路径 |
| `--output_path` | 是 | 输出文件路径 |
| `--check_field` | 是 | 检测字段 |
| `--time_field` | 是 | 时间字段 |
| `--time_format` | 是 | 时间格式 |
| `--jump_threshold` | 否 | 突变阈值（不设则不检测跳点） |
| `--window_size` | 否 | 振荡窗口（默认5） |
| `--oscillation_limit` | 否 | 窗口最大反转次数（默认2） |
| `--qc_mark` | 是 | 质控标识 |
| `--mark_field_name` | 否 | 质控标识字段名 |

## 输出示例

```
[QC FAIL] 时序平缓性检测未通过 (2 项问题):
  [突变跳点] 1 处相邻变化超过阈值 20.0
  [方向振荡] 存在振荡异常（5 点窗口内反转超过 1 次），共标记 6 个数据点
[OK] 结果已写入 -> output.csv
```

## 注意事项

1. 数据按时间字段排序后再检测
2. jump_threshold 不设则不检测跳点（只检测振荡）
3. 与 QC10_TimeConsistency（变化率）互补：QC17 侧重于变化幅度的平滑性而非速度