代理商MSL专用·医用胶原蛋白临床思维参谋
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @baitongai/agent-msl-medical-collagen-clinical-thinking-consultant
技能介绍
它解决什么问题
这是一个面向代理商 MSL(医学科学联络官)的医用胶原蛋白临床思维参谋技能,同时是一个受保护能力:核心推理指令不随技能包一起下发,而是放在服务端,只有完成平台鉴权后才能拉取。
这引出一个很常见的工程坑:Agent 首次使用时本地没有凭证,会收到 AUTH_REQUIRED / CREDENTIALS_MISSING,于是直接停下来向用户报错。但这其实是一次正常的首次绑定,不是故障。技能的价值之一,就是把这类「可自动修复」的信号和真正的鉴权失败区分开,要求 Agent 自动走完绑定流程,而不是把问题抛回给用户。
技能如何工作
1. Python 环境检测(必须最先执行)
执行任何脚本前先静默检测 PYTHON_CMD:成功则直接执行,失败才报告。如果用户已经给出 Python 全路径,直接用该路径,不必再猜。Windows 上 python 命令可能打开 Microsoft Store 而非执行脚本,推荐改用 py -3 启动器。
2. 授权检查统一收口
凭证缓存、WorkBuddy 用户绑定、平台校验、错误信号输出全部由 scripts/auth.py 处理。不要在 SKILL.md 里手动解析 JWT、拼接 AppKey/AppSecret 或自行调用绑定接口,也不要向用户展示或提及密钥明文。
3. 可自动修复 vs 真正失败
AUTH_REQUIRED/CREDENTIALS_MISSING:首次使用、本地无凭证,不要停,不要报告,立即发起绑定AUTH_INVALID/CREDENTIALS_INVALID:凭证过期或失效,用新 JWT 覆盖旧缓存后重试- 绑定后再次
--ensure仍失败:这才是真正失败,此时才向用户输出报告并停止使用本技能
4. 拉取受保护指令
只有 scripts/protected.py 成功返回 protected instructions 后,才按返回内容继续执行;未拿到时必须停止,不得凭本地提示或历史上下文继续生成。
适用边界与注意点
- 鉴权门禁与业务输出是互斥关系:鉴权未通过就禁止产出业务结果,也不允许在末尾轻描淡写补一句「另外鉴权有点问题」。
- 需要同时观察 stdout 信号与 stderr 文本:网络错误(
network error、non-JSON response)和鉴权拒绝(authorization failed、HTTP 401)的处理建议不同,不能混为一谈。 - 失败时给出明确的分步操作清单,不要用「系统繁忙,稍后再试」这类模糊提示。
- 重试上限为 1 次;两次失败说明是服务端问题,应告知数据服务暂时不可用并停止重试。
- 技能包内
_meta.json的slug是服务端维护的技能编号(如BT_98C8922F),不是展示名称,不要手动传错。 - 真正的临床思维参谋内容由服务端下发,本地
SKILL.md不包含这部分,因此在离线或未授权状态下无法产出该技能的核心结论。
使用场景
- 技能首次运行,本地无凭证,需自动完成 WorkBuddy 绑定而不是直接报错。
- 凭证过期返回 `AUTH_INVALID`,需要用新 JWT 覆盖缓存后重试一次。
- Windows 上 `python` 打开 Microsoft Store,需改用 `py -3` 执行脚本。
- 鉴权门禁失败时,必须停止业务推理,禁止继续产出临床内容。
适合人员
- 需要把 Agent 封装成技能包供他人安装的医药行业开发者,关心鉴权链路是否可靠。
- 负责 Agent 平台权限的工程师,需要区分可自动修复的绑定和真正的鉴权失败。
- 经常给 Agent 写 SKILL.md 的技术写作者,想参考受保护技能的门禁写法。