| name | cross_field_comparison_check |
| description | 跨字段比较校验工具。读取结构化数据文件(CSV、TSV、Excel等),检查两个字段之间的逻辑约束关系
是否满足(如 start < end、min ≤ max、price >= cost),支持六种比较运算符,多约束可组合使用。
当用户提到跨字段校验、字段间比较、逻辑约束检查、大小关系验证等需求时使用此skill。
即使用户没有明确说出"跨字段",只要任务涉及验证两个字段值之间的逻辑关系,就应该使用此skill。
|
| name_zh | cross_field_comparison_check_跨字段比较校验算子 |
| input_params | [{"name":"input_path","type":"string","required":true,"description":"输入文件路径(支持CSV/TSV/Excel/SPSS等)"},{"name":"output_path","type":"string","required":true,"description":"输出文件路径(带质控标识的结果文件)"},{"name":"constraints","type":"string","required":true,"description":"约束表达式,| 分隔。格式:左字段,运算符,右字段。如 start,<,end|min,<=,max"},{"name":"qc_mark","type":"string","required":true,"description":"质控标识(如QC标识)"},{"name":"mark_field_name","type":"string","required":false,"default":"QC0000","description":"质控标识字段名"}] |
| output_params | [{"name":"output_path","type":"csv_file","description":"带质控标识的输出文件"}] |
| tag | 数据校验 |
| publisher | COMMUNITY |
cross_field_comparison_check 跨字段比较校验Skill
功能概述
本skill用于逐行验证两个字段值之间的逻辑关系是否成立。典型应用场景:
- 时间区间校验:
start_time < end_time
- 数值范围校验:
min_value <= max_value
- 价格逻辑校验:
cost < price
- 库存校验:
sold <= total
支持运算符
| 运算符 | 含义 | 示例 |
|---|
< | 小于 | start,<,end |
<= | 小于等于 | min,<=,max |
> | 大于 | end,>,start |
>= | 大于等于 | current,>=,baseline |
== | 等于 | computed,==,expected |
!= | 不等于 | status,!=,deleted |
约束格式
- 每个约束:
左字段,运算符,右字段
- 多个约束用
| 分隔
- 约束之间为 AND 关系(任一违反即标记)
- 示例:
start,<,end|min,<=,max 表示同时满足 start<end 且 min≤max
触发条件
当用户请求以下任务时,应使用此skill:
- 跨字段比较校验
- 字段间逻辑约束检查
- 大小关系验证
- 字段值一致性比对
- 数据逻辑规则检查
处理逻辑
- 读取输入数据表
- 解析 constraints 字符串,拆分出每个约束(按
| 分割)
- 对每行数据:
a. 提取左右字段的值并转为数值(numeric)
b. 按指定运算符比较
c. 违反任一约束 → 标记
qc_mark
- 非数值数据(如字符串)转为 NaN 后跳过该约束的比较
- 输出标记结果和统计摘要
支持的文件格式
- CSV (.csv)
- TSV (.tsv)
- Excel (.xls, .xlsx)
- SPSS (.sav)
使用方法
步骤1:获取用户输入输出路径及参数
向用户确认:
- 输入文件路径(需要校验的文件)
- 输出文件路径(校验结果文件)
- 约束表达式(格式:左字段,运算符,右字段|...)
- 质控标识
步骤2:执行跨字段比较校验脚本
在 scripts/ 目录下找到 cross_field_comparison_check.py,使用Python执行: