GEO KPI 指标体系选择器
将以下提示词粘贴到你的 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 工作流,关注鉴权失败时的门禁与停止行为