风湿科KOL观念培育参谋企业版

它解决什么问题

风湿科 KOL 观念培育这类企业工作流里，本地 skill 往往只是入口，真正干活的是云端下发的 protected instructions。跨环境调用时最常见的两类故障都不是内容不对，而是：

• Python 不可用或版本不符：脚本静默失败，报错信息指向 python 命令本身；
• 鉴权被误判：首次使用拿到 AUTH_REQUIRED 就当成失败上报，用户被无谓打断。

这个技能把这两类问题前置成固定执行顺序：先探测环境、再校验授权、最后拉取受保护内容，任何一层未通过都不得继续。

它如何工作

流程分三层，顺序不可颠倒。

1. Python 环境检测（必须最先执行）

• 静默探测可用解释器，成功则直接执行 $PYTHON_CMD scripts/auth.py ...；
• 版本过低或命令为空时才输出错误模板，而不是直接崩掉；
• 用户明确告知全路径时直接采用，不再二次探测；
• Windows 推荐用 py -3 启动器，避免 python 落到 Microsoft Store 别名。

2. 授权检查

• 授权逻辑全部收敛在 scripts/auth.py，本地不手动解析 JWT，也不拼接 AppKey/AppSecret；
• AUTH_REQUIRED、CREDENTIALS_MISSING 属于可自动修复的首次绑定信号，遇到后应主动调用 WorkBuddy 的 connect_cloud_service 取 JWT 并执行 --bind-jwt，而不是停下来问用户；
• AUTH_INVALID、CREDENTIALS_INVALID 先尝试一次自动修复覆盖缓存，仍失败才视为真正失败；
• skillCode 优先读取包内 _meta.json 的 slug，仅在缺失时才手动传 --skill-code。

3. 受保护内容加载

• 授权通过后由 scripts/protected.py 拉取 protected instructions；
• 只有拿到指令才进入业务流程，未拿到则停止，不得凭本地提示或历史上下文继续生成。

适用边界与注意点

• 鉴权失败与业务输出互斥。绑定后再失败，必须按模板原样转述 stdout 信号与 stderr 关键行（如 network error、VIP_EXPIRED），并给出明确的分步清单；严禁静默重试、静默降级，或先出结果再补一句鉴权有问题。
• 重试上限为一次。CREDENTIALS_MISSING、CREDENTIALS_INVALID、HTTP 401/403、authorization failed、签名类关键字，以及 protected.py 非零退出且指向鉴权，都触发一次重新绑定；第二次仍失败即告知数据服务暂时不可用并停止。
• 密钥不得外泄。AppKey/AppSecret 不出现在业务命令、环境变量或回复里，报告中涉及密钥字段需打码（如 app_key=abc****）。
• 本地文档不承载业务内容。公开的 SKILL.md 中看不到云端指令的具体输出能力，完整效果以 protected.py 返回为准；网络抖动与权限过期应分开处理。