Agent Skills
返回列表
GEO KPI 指标体系选择器

GEO KPI 指标体系选择器

数据分析 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @baitongai/s14-geo-kpi-indicator-system-selector。

技能介绍

做数据分析时,最容易卡壳的往往不是模型本身,而是指标体系不统一:不同业务方对 GMV、转化率、留存率的定义口径不同,导致分析结果无法对齐。S14GEO-KPI 指标体系选择器 就是为了解决这个“指标口径漂移”问题而设计的。

工作原理

该 Skill 首先执行严格的环境前置检查:

  • Python 环境检测:在执行任何脚本前,先静默探测本地 Python 环境。若检测成功且版本达标,则直接调用 scripts/auth.py 进行后续流程;若失败或版本过低,则按规范输出错误报告,并支持使用用户提供的全路径执行。
  • 授权校验与绑定:核心逻辑由 scripts/auth.py 处理,包含本地凭证缓存与平台校验。收到 AUTH_REQUIRED 或 CREDENTIALS_MISSING 信号时,会自动触发 connect_cloud_service 获取 JWT 进行绑定,无需人工干预。
  • 受保护内容拉取:授权通过(AUTH_OK)后,调用 scripts/protected.py 获取云端的保护指令。只有拿到指令后,才会执行实际的指标体系选择逻辑。

适用边界与注意点

  • 鉴权门禁:鉴权状态与业务输出是互斥关系。若绑定后再次校验仍返回失败(如 AUTH_INVALID 或服务端网络错误),必须立即停止业务推理并向用户报告,严禁静默降级或继续输出结果。
  • 重试策略:鉴权类错误(如 HTTP 401、签名过期)自动重试次数上限为 1 次。若再次失败,视为服务端不可用。
  • 密钥安全:严禁在业务命令、环境变量或回复中展示明文的 AppKey / AppSecret。

使用场景

  • 分析师要统一多业务线的 GMV、转化率口径,需先完成 Python 环境检测与授权,再拉取云端受保护的指标体系清单并执行选择
  • 首次运行检测到本地无凭证(AUTH_REQUIRED),需自动绑定 WorkBuddy 用户 JWT,重新校验拿到 AUTH_OK 后才能继续业务
  • 在 Windows 上 python 命令打开 Microsoft Store,需改用 py -3 启动器或关闭执行别名后,再运行 auth.py 完成校验
  • 绑定后 --ensure 仍返回 CREDENTIALS_INVALID 或网络错误,需按模板向用户报告信号与 stderr,并停止业务推理

适合人员

  • 数据分析师:需要统一多业务线 KPI 口径,避免各团队指标定义漂移导致的分析结论对不上
  • 数据分析工程师:需要把指标体系选择接入自动化分析脚本,依赖稳定的环境检测与鉴权流程
  • AI 应用开发者:需要将受保护的指标选择能力嵌入 Agent 工作流,关注鉴权失败时的门禁与停止行为