Agent Skills
返回列表
省市区级联

省市区级联

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/iwj20262006。

技能介绍

它要解决的问题

客户线索表里经常出现这样的字段:address 一坨字符串,前端筛不出“北京市的所有记录”,运营想按城市做统计只能全文匹配。更麻烦的是历史数据里存了 北京市朝阳区 这种展示文案,行政区划调整后无人维护,code 缺失导致无法和统计局口径对接。另一个常见坑是手写一份省市区 JSON——数据早就过时,来源也没标注。

技能如何工作

这个技能封装了 element-china-area-data 的级联逻辑,核心是“存 code,顺带存中文”:

  • 用包导出的 regionData 直接喂给 Element Plus 的 el-cascader,不用自己拼树
  • 提交时同时写出 区划 code、拼接中文和 detail 详细地址
  • 回显时用已存的 codes 赋给 v-model,避免反向查中文

Agent 的执行路径很明确:

  1. 安装包,把 regionData 接到 el-cascader
  2. 提交:codes + text + detail 三个字段一起入库
  3. 回显:把数据库里的 codes 塞回 v-model
  4. 自测:选到区级、清空、回显一致

关键约束是不要只存展示文案。code 是筛选、排序、对接外部区划数据的锚点,中文只是给人看的冗余。

适用边界

  • 数据以 npm 包版本区划为准,库更新后区划会有变化,别假设是固定快照
  • 港澳台与海外地址不要塞进同一个强制三级结构,应可跳过或另设字段
  • 级联值变更时不要清空用户已填的门牌号,除非产品明确要求
  • 手写 JSON 属于“不要做”:过时且不注明来源的区划数据比没有数据更危险

使用场景

  • CRM 线索表的地址字段还是一整串文本,需要拆成省市区 code + 中文名 + 详细地址,支持按城市筛选
  • 用 Element Plus 的 el-cascader 做省市区选择器,提交时同时落 code、拼接中文和详细地址三个字段
  • 列表页要按城市维度筛记录,历史数据只存了地址字符串,需要补齐区划 code 回填能力
  • 做统计局口径对齐前的准备工作,用带版本的 npm 区划数据替换过时的手写 JSON

适合人员

  • 后端工程师:提交表单时要同时落省市区 code、中文名和详细地址,之后能按城市筛选排序
  • 前端工程师:想直接用包里的 regionData 接 el-cascader,不愿手写和维护区划 JSON
  • CRM 线索运营:需要按城市维度筛选客户地址,而不是在整串地址里全文搜索
  • 数据对接人员:后续要和统计局口径对齐,需要区划 code 来源明确且随包版本更新