Pi DataSorting

---
name: Pi_DataSorting
description: |
  数据排序工具。读取结构化数据文件，根据指定字段进行升序或降序排序，最后输出为相同格式的文件。
  当用户提到数据排序、升序排列、降序排列、按某字段排序等需求时使用此skill。
  即使用户没有明确说出"排序"，只要任务涉及对数据进行排序，就应该使用此skill。

name_zh: Pi_数据排序算子
input_params:
  - name: input_path
    type: string
    required: true
    description: 输入文件路径（支持CSV/TSV/Excel等）

  - name: output_path
    type: string
    required: true
    description: 输出文件路径（排序后的文件）

  - name: id_field_name
    type: string
    required: true
    description: 排序字段名，支持多字段用逗号分隔

  - name: sort_order
    type: string
    required: false
    default: asc
    description: 排序方式（asc升序/desc降序）

output_params:
  - name: output_path
    type: csv_file
    description: 排序后的结构化数据文件
tag: 数据衍生
publisher: COMMUNITY
---

# Pi_DataSorting 数据排序Skill

## 功能概述

本skill用于读取结构化数据文件，根据用户指定的字段进行升序或降序排序，然后输出为相同格式的文件。

## 触发条件

当用户请求以下任务时，应使用此skill：
- 数据排序
- 升序排列
- 降序排列
- 按某字段排序
- 排序数据
- 重新排列数据顺序

## 处理逻辑

1. 读取输入的结构化数据文件
2. 解析排序字段（支持多字段，用逗号分隔）
3. 根据指定的排序方式（asc/desc）进行排序
4. 输出排序后的数据文件

## 支持的文件格式

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

## 使用方法

### 步骤1：获取用户输入输出路径及排序参数

向用户确认：
1. 输入文件路径（需要排序的文件）
2. 输出文件路径（排序后的文件）
3. 排序字段名（必填，支持多字段用逗号分隔，如：ID0000,NAME）
4. 排序方式（可选，默认asc升序，可选desc降序）

### 步骤2：执行数据排序脚本

在 `scripts/` 目录下找到 `Pi_DataSorting.py`，使用Python执行：

```bash
python scripts/Pi_DataSorting.py --input_path <输入文件> --output_path <输出文件> --id_field_name <排序字段> [--sort_order asc|desc]
```

### 步骤3：返回结果

告知用户排序结果。

## 参数说明

| 参数 | 必填 | 说明 |
|------|------|------|
| `--input_path` | 是 | 输入文件路径 |
| `--output_path` | 是 | 输出文件路径 |
| `--id_field_name` | 是 | 排序字段名，支持多字段用逗号分隔 |
| `--sort_order` | 否 | 排序方式，asc升序（默认）或desc降序 |

## 输出示例

### 升序排序
```
[OK] Using encoding GB2312 successfully read CSV file
Successfully read file: /path/to/input.csv, shape: (1000, 18)
Successfully written file: /path/to/output.csv
Data sorting completed! Output to: /path/to/output.csv
```

### 降序排序
```
[OK] Using encoding GB2312 successfully read CSV file
Successfully read file: /path/to/input.csv, shape: (1000, 18)
Successfully written file: /path/to/output.csv
Data sorting completed! Output to: /path/to/output.csv
```

### 多字段排序
```
python Pi_DataSorting.py --input_path input.csv --output_path output.csv --id_field_name "ID0000,NAME" --sort_order asc
```

## 注意事项

1. 排序字段必须存在于数据中
2. 支持多字段排序，用逗号分隔
3. 如果用户没有指定输出路径，可以建议使用原文件名加上 `_sorted` 后缀