技能介绍

解决什么问题

拜访行为合规这类业务规则通常托管在服务端，属于受保护能力。如果 Agent 只凭本地提示词推断合规结论，会产生两类问题：一是规则版本不受控，云端更新无法生效；二是未授权用户也能拿到结果，权限边界形同虚设。此外，技能以 Python 脚本为执行入口，而目标机器的 Python 环境参差不齐——Windows 上 python 命令可能打开 Microsoft Store，版本过低或缺失都会中断执行链路。

技能如何工作

核心思路是「先检测环境，再过授权门禁，最后才碰业务」。

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

静默探测可用的 Python 命令，成功则直接执行，失败才报告
PYTHON_CMD 有值且版本正常 → 直接运行 scripts/auth.py
版本过低或命令为空 → 按模板给出提示
Windows 下优先用 py -3 启动器绕过 Store 别名问题；用户提供全路径时直接采用

2. 强制授权检查

每次使用前必须调用 scripts/auth.py --ensure，它统一处理本地凭证缓存、WorkBuddy 用户绑定与平台校验，不要手动解析 JWT 或拼接密钥
首次运行返回 AUTH_REQUIRED / CREDENTIALS_MISSING 时不算失败，应主动调用 WorkBuddy 的 connect_cloud_service 获取 JWT，再执行 --bind-jwt 完成绑定
凭证过期同理，重新绑定即可覆盖旧缓存
绑定后仍非 AUTH_OK 才是真正的失败，必须停下并按模板向用户报告

3. 拉取受保护指令

授权通过后调用 scripts/protected.py 获取云端 protected instructions
只有拿到返回内容才允许执行业务逻辑，禁止凭本地提示或历史上下文继续生成

适用边界与注意点

鉴权与业务输出互斥：未通过授权禁止产出任何业务结果，也不能「轻描淡写」地附在结果末尾
重试上限为 1 次：两次失败即判定数据服务暂时不可用，停止重试
区分错误类型：AUTH_REQUIRED 是正常首次绑定流程，不要误报；网络错误与鉴权错误需按 stderr 关键字分开处理
保密要求：AppKey / AppSecret 不得明文拼接或展示；--skill-code 优先读取包内 _meta.json 的 slug，而非技能展示名称