Agent Skills
返回列表
Validator字段校验器

Validator字段校验器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/yrd20261452 到 AI 助手。

技能介绍

为什么需要轻量级字段校验

表单开发中,单字段快速合法性检查的场景很常见——比如失焦时验证邮箱格式、导入数据前批量校验单列URL、手机号形态,但引入完整 Schema 库(如 Zod/Yup)处理这类需求显得冗余,需要一个轻量工具函数快速完成预检。

核心能力与使用方式

  • 封装常用校验函数:提供 checkEmail、checkUrl、checkMobileCN 三个工具函数,其中 checkMobileCN 支持 isMobilePhone(str, 'zh-CN') 或宽松正则,适配中文手机号校验场景。
  • 明确调用时机:在表单失焦事件或提交时触发校验,直接返回中文错误文案(而非仅 false),方便直接写入表单错误提示。
  • 与 Schema 库配合:当项目中已使用 Zod/Yup 时,validator 可作为轻量预检层,先过滤明显格式错误的字段,再交由 Schema 完成对象级规则校验。

适用边界与注意事项

  • 不要试图用 validator 替代完整业务规则引擎,它仅处理单字段格式校验,无法覆盖复杂对象或业务逻辑规则。
  • 格式合法不代表真实有效,比如手机号通过格式校验不代表该号码已实名或可用,这类需求需对接专门的实名校验服务。
  • 若需校验身份证字段,可直接使用本技能或对接专门的“身份证校验解析”Skill,避免重复实现校验逻辑。

使用场景

  • 表单开发中,输入框失焦时需要快速校验邮箱、URL格式并即时显示中文错误文案
  • 数据导入前需要对表格中的手机号、URL列逐一做格式预检,过滤明显非法数据
  • 项目已用Zod做对象校验,想在表单提交前对邮箱、链接等单字段加一层轻量预检

适合人员

  • 前端开发者:需要在表单失焦时快速校验邮箱、URL等字段格式,不想引入完整Schema库
  • 数据导入功能开发者:批量导入前要对单列数据做合法性预检,过滤明显格式错误
  • 中后台开发者:需要为中文用户场景提供手机号等字段的中文错误提示,而非仅返回false