Data Type Converter
Documentsdata_type_converterData Type Converter is an Agent Skill for documents published in the cas-bigdatalab/piflow repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
数据类型转换工具。转换数据字段的类型，支持数值、字符串、日期等类型互转。 当用户提到类型转换、数据格式转换、字段类型修改等需求时使用此skill。 即使用户没有明确说出"类型转换"，只要任务涉及改变字段的数据类型，就应该使用此skill。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/cas-bigdatalab/piflow/blob/HEAD/workspace/skills/data_type_converter/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/data-type-converter, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Data Type Converter 数据类型转换 Skill
功能概述
本skill用于转换数据字段的类型，支持：
- 数值转换：int, float
- 字符串转换：str
- 日期转换：datetime
- 布尔转换：bool
- 分类转换：category
触发条件
当用户请求以下任务时，应使用此skill：
- 数据类型转换
- 字段格式转换
- 日期格式化
- 数值格式化
支持的目标类型
| 类型 | 说明 | 示例 |
|---|---|---|
int | 整数 | "123" → 123 |
float | 浮点数 | "123.45" → 123.45 |
str | 字符串 | 123 → "123" |
datetime | 日期时间 | "2024-01-01" → datetime |
bool | 布尔值 | "true" → True |
category | 分类类型 | 优化内存 |
使用方法
基本类型转换
python scripts/run_data_type_converter.py \
--input data.csv \
--output converted.csv \
--conversions "age:int,score:float,name:str"
日期类型转换
python scripts/run_data_type_converter.py \
--input data.csv \
--output converted.csv \
--conversions "date:datetime" \
--date_format "%Y-%m-%d"
多字段转换
python scripts/run_data_type_converter.py \
--input data.csv \
--output converted.csv \
--conversions "id:int,amount:float,date:datetime,category:category"
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
--input | 是 | 输入文件路径 |
--output | 是 | 输出文件路径 |
--conversions | 是 | 转换规则 |
--date_format | 否 | 日期格式，默认"%Y-%m-%d" |
--errors | 否 | 错误处理，默认"coerce" |
错误处理方式
| 方式 | 说明 |
|---|---|
raise | 遇到错误时抛出异常 |
coerce | 转换失败设为NaN |
ignore | 保留原值 |
输出示例
[OK] Data type conversion completed!
Input file: data.csv
Output file: converted.csv
Conversions:
- age: object → int64
- score: object → float64
- date: object → datetime64[ns]
Total rows: 1000
Conversion errors: 5
环境要求
pip install pandas numpy openpyxl