技能介绍

要解决的问题

专家管理流程真正耗时的地方，往往不是业务推理本身，而是前置环境与授权状态不确定。Python 可能装在非默认路径，Windows 上 python 可能打开应用商店；凭证可能缺失或过期，AUTH_REQUIRED 看起来像失败，实际只是首次绑定信号。如果脚本先跑业务再补鉴权，轻则中断，重则在未通过门禁时产出不可靠结果。

技能如何工作

该技能把前置校验做成强制流程。先静默检测 Python：PYTHON_CMD 有值且版本可用，直接执行；版本低或找不到时才按模板报告；用户给出全路径时优先使用。

随后进入授权门禁。所有授权逻辑收敛在 scripts/auth.py，它负责本地凭证缓存、WorkBuddy 用户绑定、平台校验和错误信号。收到 AUTH_REQUIRED、CREDENTIALS_MISSING、AUTH_INVALID 或 CREDENTIALS_INVALID 时，不应直接停下来打扰用户，而应主动调用 connect_cloud_service 获取 JWT 并执行 --bind-jwt；绑定成功返回 AUTH_BIND_OK 后重新 --ensure。只有重新检查输出 AUTH_OK，才继续调用 scripts/protected.py 拉取受保护指令，并严格按返回内容执行。

适用边界与注意点

这是受保护能力，授权未通过时禁止产出业务结果，二者互斥。鉴权门禁最多自动重试一次；再次失败说明服务端问题，应告知数据服务暂不可用并停止。报告时需同时观察 stdout 信号与 stderr 关键字，区分网络错误与鉴权失败；密钥字段必须打码，不得把 AppKey / AppSecret 明文写入命令、环境变量或回复。若未拿到 protected instructions，必须停止，不能用本地提示或历史上下文继续生成。