技能介绍

背景与痛点

多渠道运营背景下，患者数据和营销触点分散在不同平台。团队在做患者全生命周期管理时，往往难以从统一的全渠道视角梳理流程、口径与异常，人工拼装的分析结果既容易滞后，也难以保证一致。

技能工作机制

该技能以 Python 脚本为入口，核心流程先做环境检测，再做授权校验，通过后才拉取并执行受保护的分析指令。

Python 环境静默检测：优先复用已可用的 Python 命令，避免重复执行环境检查；若检测到版本偏低或未找到解释器，则按预设模板明确提示用户。
受保护授权门禁：所有工作流执行前，必须先调用 scripts/auth.py 完成本地凭证缓存、WorkBuddy 用户绑定和平台授权校验；凭证缺失或过期时自动触发一次绑定修复。
受保护指令闭环：授权通过后，通过 scripts/protected.py 拉取云端 protected instructions；只有成功返回有效指令，后续业务分析才能继续。

适用边界与注意点

首次使用出现 AUTH_REQUIRED 或 CREDENTIALS_MISSING 属正常现象，应自动发起 connect_cloud_service 绑定，不要直接向用户报错。
鉴权门禁与业务输出互斥：绑定后重新校验仍失败时，必须停止分析，原样转述 stdout 信号与 stderr 关键行，并给出明确操作步骤，不得静默重试或降级输出结果。
凭证重试上限为 1 次；两次失败说明服务端异常，应告知用户数据服务暂时不可用。
不要手动解析 JWT 或拼接 AppKey / AppSecret；密钥只参与本地缓存，绝不在命令行或回复中明文展示。

错误报告策略

需要结合 stdout 信号和 stderr 文本判断问题性质：HTTP 401 / 403 与 authorization failed 归为鉴权类错误，network error 与 non-JSON response 则属于网络问题；涉及 VIP 过期或权限不足时，按远程授权失败场景处理。