Agent Skills
返回列表
BesChannels 遗留数据清洗

BesChannels 遗留数据清洗

数据分析 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9f2dfcc6/xiepro-beschannels-legacy-clean。

技能介绍

这个技能解决什么问题

把一份历史遗留的 Excel 或 CSV 导入 BesChannels 时,最常见的失败不是格式没对上,而是清洗动作本身太"自信":直接改源文件、按显示名合并重复表头、把看起来重复的行删掉、把 手机号2 当成电话号码处理、或者把日期列统一转成 yyyy-MM-dd,等真正导入才发现目标对象要求的是 DateTime,或者租户侧根本不认这个序列化格式。

这个技能把清洗拆成一组必须先确认、再执行的步骤,避免在缺少证据时替业务做决定。

它如何工作

  1. 检查源文件:用 scripts/inspect_workbook.py 记录源文件 SHA256、sheet、编码、行列数、精确表头、重复表头、空列和高风险字段。源文件一旦有哈希漂移,后续步骤全部停止。
  2. 确认目标与字段映射:在清洗前返回确认卡,用中文逐项确认目标对象、首个身份字段(默认手机号)、目标字段显示名、是否去重及去重键、手机号2 的处理方式、重复表头如何映射,以及日期列到底是 Date 还是 DateTime。
  3. 在副本上清洗:除非用户明确批准删除或合并,保留每一行;只清空不安全的字段,而不是删记录或做弱猜测。清洗先于去重,去重只用确认过的非空键。
  4. 探测动态契约:字段类型、选项标签、租户行为、导入器版本都是会变的。用 2–50 行的 probe 隔离单一原因,再扩展规则。
  5. 验证并打包:用 scripts/validate_cleaned_output.py 校验零行变化、零表头变化、编码与换行合法,并生成字段级审计。

适用边界

  • 不包含 CLI 运行时和客户凭据,是一个独立的清洗 Skill,依赖项目已具备的共享契约。
  • 本地验证通过只代表产物合规,不等于目标系统已经导入成功。
  • 如果确认卡中的关键决策缺失,流程只走到计划完成,状态为 blocked,不会执行清洗。
  • 停止条件包括:哈希漂移、表头或行数异常变化、租户或对象无法验证、选项标签歧义、重复表头映射未确认、probe 同时测试多个原因。

使用场景

  • 把历史线索 Excel 导入 BesChannels 前,需确认手机号、邮箱、单位、微信 openid 的键映射与去重策略
  • 历史 CSV 存在重复表头,需逐列确认每条重复列映射到哪个目标字段,而不是按显示名合并
  • 日期列混有 Excel 序列号与带时区的时间,需先确认每列是 Date 还是 DateTime 再决定转换格式
  • 导入后被目标系统拒绝且只拿到回执,需用小样本 probe 隔离是字段类型、选项标签还是租户配置问题

适合人员

  • 线索运营:每周要把多份历史线索表导入 BesChannels,担心手机号、邮箱被误删或错误合并
  • 数据清洗工程师:负责历史数据迁移,需要字段级审计记录证明每处改动都有依据和规则 ID
  • 实施顾问:为客户准备导入文件,需要在客户确认前先给出确认卡而不是直接改数据
  • 租户管理员:多租户场景下字段类型与选项标签会变,需要 probe 验证当前对象的实际契约