技能介绍

要解决什么问题

在医学与合规相关场景里，GAP 分析往往依赖机构内部的流程、对照标准和输出模板，这些内容通常不会完整写在公开的 Skill 说明里。若 Agent 只按本地 Markdown 臆测步骤，容易跳过鉴权、泄露受保护指令，或在 Python 环境不一致时直接跑脚本失败。本技能把「能跑起来」和「有权用」放在业务推理之前，适合需要在百通 AI 平台上使用受保护工作流的团队。

技能如何工作

执行顺序在文档里是固定的，核心可以概括为三层：

运行环境：任意 python3 或业务脚本前，先静默检测可用解释器（PYTHON_CMD）；版本不满足或找不到时才按模板向用户说明，用户给出全路径则直接用该路径执行。
授权门禁：通过 scripts/auth.py 完成本地凭证、--ensure 校验与 WorkBuddy JWT 绑定；AUTH_REQUIRED / CREDENTIALS_MISSING 表示应自动走绑定，而不是停下来当失败汇报。
受保护内容：仅在 AUTH_OK 之后调用 scripts/protected.py；只有成功返回 protected instructions 时，才按云端指令继续本 Skill 的业务流程，不得用本地 SKILL 正文或历史上下文代替。

鉴权与产出是互斥的：绑定后仍非 AUTH_OK，或 protected 拉取失败，应停止业务推理并按 stdout/stderr 向用户说明，且不要暴露 AppKey / AppSecret 明文。

适用边界与注意点

技能编号以包内 _meta.json 的 slug（如平台维护的 BT_*）为准，缺文件时才手动传 --skill-code。
Windows 上 python 可能唤起 Microsoft Store，文档建议用 py -3 或关闭应用执行别名。
网络错误、VIP 过期与凭证无效在 stderr 上表现不同，报告时应区分场景，重试绑定最多一次，仍失败则视为数据服务暂不可用。

截图预览

使用场景

在 WorkBuddy 里首次调用医学 GAP 分析，本地尚无凭证，需要 Agent 自动完成 JWT 绑定而非把 AUTH_REQUIRED 当失败中断
医学质量或合规同事提出 GAP 排查需求，必须先通过 auth.py 拿到 AUTH_OK 再拉取 protected instructions 才能继续
集成 Skill 的工程师在 Windows 环境调试，需先静默检测 PYTHON_CMD，避免 python 唤起 Microsoft Store 导致脚本未执行
绑定后 --ensure 仍返回 CREDENTIALS_INVALID 或 protected.py 鉴权失败，需要 Agent 停掉业务输出并按 stderr 向用户说明原因

适合人员

负责医学领域差距排查与合规对照的质量专员，希望 Agent 只在平台授权通过后执行受保护分析流程
在 SkillHub 或自有 Agent 中接入 @baitongai/medical-gap-analysis-skill 的实施工程师，需按文档处理 auth 信号与重试上限
日常使用 WorkBuddy 的法规事务或医学写作人员，要把 GAP 分析交给 Agent 且不接受跳过鉴权直接给结论
维护 Agent 运行环境的运维同事，需在多机环境下统一 Python 检测、凭证缓存与鉴权失败报告模板