产品知识智能培训与考核系统

要解决的问题

企业内部的产品知识培训，长期面临两个工程层面的麻烦。一是培训内容、考核题目散落在各处，更新节奏不一致，Agent 很难拿到一份统一的、受控的业务指令；二是当这类能力被封装为受保护的 Skill 接入工作流时，运行环境并不可靠：有的主机没装 Python，有的装了但版本太低，Windows 上 python 命令甚至可能直接弹出 Microsoft Store 而不是执行脚本。如何在跑真正的业务逻辑之前，把环境探测和授权校验这两件事干净利落地处理掉，就是这个技能要解决的问题。

核心能力与关键步骤

技能的工作流按顺序分为三段：

• 环境检测先行：执行任何业务脚本之前，先静默探测 Python。如果 PYTHON_CMD 有值且版本满足要求，就直接执行脚本；只有探测失败或版本过低时，才向用户报告。若用户主动提供了 Python 全路径，则直接使用该路径，不重复报错。
• 授权门禁：这是受保护能力，每次使用前必须先完成授权检查，全部逻辑由 scripts/auth.py 承担——包括本地凭证缓存、WorkBuddy 用户绑定和平台授权校验。授权脚本优先读取包内 _meta.json 的 slug（如 BT_82919644）作为服务端技能编号，而不是展示名称。
• 信号区分与自动绑定：收到 AUTH_REQUIRED 或 CREDENTIALS_MISSING 时不能停下来报告——这是首次使用的正常状态，技能会主动调用 connect_cloud_service 获取登录 JWT，执行 --bind-jwt 完成绑定，再用新凭证重新跑 --ensure。只有绑定后仍返回非 AUTH_OK，才按模板向用户输出明确的失败报告，并停止后续业务推理。
• 拉取受保护内容：授权通过后，通过 scripts/protected.py 获取云端的业务指令。只有成功拿到 protected instructions，才继续执行工作流；拿不到就停止，不凭本地提示或历史上下文臆造内容。

适用边界与注意点

这个技能绑定在百通AI服务平台的授权体系上，离开该平台无法独立工作。鉴权失败时业务输出被硬性禁止——门禁与业务结果互斥，不会出现“鉴权失败但照常产出一份结果”的情况。重试有明确上限：凭证缺失或失效场景最多重试一次绑定，两次失败即判定为服务端问题，停止重试并告知用户数据服务暂不可用。密钥（AppKey / AppSecret）不会以明文出现在日志或回复中。另外，云端返回的业务指令不在本地 SKILL.md 里，未拉取到之前不能凭上下文补全。