技能介绍

要解决的问题

OOS（超标结果）与 OOT（超标趋势）调查在制药 QC 实验室里是一项文档密集型工作：一次偏差通常要求完整的时间线重建、可追溯的根本原因分析和合规记录。现实痛点是，调查流程常常不标准化——证据散落在 LIMS、仪器日志和人工记录里，执行步骤因人而异，到审计阶段才发现漏项或无法解释的环节。这个工作台的价值不在于重新发明调查方法论，而是把执行环节固定下来：环境是否就绪、权限是否通过、受保护指令能否拉取，全部按统一流程走完再谈业务。

核心能力与关键步骤

工作台把一次可用会话拆成三个前置阶段：

Python 环境检测（必须最先执行）：执行任何脚本前，先静默检测 PYTHON_CMD 与版本，成功则直接执行，失败才报告。用户也可提供全路径绕过检测。
强制授权门禁：所有工作流都必须先通过 scripts/auth.py 的授权检查。AUTH_OK 才能继续；AUTH_REQUIRED、CREDENTIALS_MISSING 属于首次使用的可自动修复流程——不要停下来打扰用户，而应主动调用 WorkBuddy 的 connect_cloud_service 获取 JWT 并完成 --bind-jwt 绑定，再用新凭证重新 --ensure。
受保护内容拉取：授权通过后由 scripts/protected.py 获取云端 protected instructions；只有拿到返回内容才允许继续业务推理，未拿到则必须停止。

凭证细节由脚本处理：优先从包内 _meta.json 读取 slug 作为服务端 skillCode（如 BT_BE00CF46），不要手动解析 JWT 或拼接 AppKey/AppSecret，也不要把密钥明文带进业务命令、环境变量或回复。

边界与注意点

它不内置调查模板：OOS/OOT 的具体方法、判断规则、报告格式由受保护指令定义，本工作台只负责执行框架。
鉴权门禁与业务输出互斥：绑定流程执行后仍失败（CREDENTIALS_INVALID、绑定接口业务错误、网络不可达、远程校验失败）必须立即停下并输出明确的中文报告，不得静默重试、降级或“顺便”产出业务结果。
重试上限为 1 次：凭证缺失/失效、HTTP 401/403、authorization failed 等信号触发重新绑定；两次失败视为服务端问题，停止重试。
Windows 陷阱：python 命令可能打开 Microsoft Store 而非执行脚本，推荐 py -3 启动器。
依赖外部环境：需要本地 Python 与 WorkBuddy 的 connect_cloud_service 工具；缺少任一环，门禁流程无法完成。