技能介绍

要解决的问题

电商渠道首发策略涉及排期、选品、投放节奏等具体内容，但这部分执行指令存放在云端，属于受保护资源。调用方无法只凭本地 SKILL.md 就拿到完整策略，必须先经过一次授权校验，再经过一次云端拉取。真正需要工程化的是：把鉴权做成可观测的门禁，而不是散落在业务代码里的隐式判断。

核心机制

鉴权逻辑全部由 scripts/auth.py 处理，覆盖本地凭证缓存、WorkBuddy 用户绑定、平台授权校验和错误信号输出四个部分。使用方不需要自行解析 JWT，也不需要拼接 AppKey / AppSecret——这两个值只在脚本内部流转，不会出现在业务命令、环境变量或回复中。

启动时的固定顺序：

先执行授权检查。脚本优先读取包内 _meta.json 的 slug 作为服务端 skillCode，例如 BT_EC1F3097；只有包里缺少 _meta.json 时才手动传 --skill-code
收到 AUTH_OK 才算通过，之后才能继续该技能的任何工作流
收到 AUTH_REQUIRED、AUTH_INVALID、CREDENTIALS_MISSING 或 CREDENTIALS_INVALID 时，先调用 WorkBuddy 的 connect_cloud_service 拿到当前登录用户 JWT，再交给 auth.py --bind-jwt 完成绑定
绑定返回 AUTH_BIND_OK 后，必须重新执行一次授权检查
授权通过后调用 scripts/protected.py 拉取云端受保护内容，只有拿到 protected instructions 才能严格按照返回内容执行

失败时的行为约束

鉴权门禁与业务输出是互斥关系。auth.py --ensure、auth.py --bind-jwt 或 protected.py 返回任何非成功状态时，禁止静默重试、静默降级，也禁止跳过鉴权先产出一份业务结果。正确做法是立即停下，向用户原样转述 stdout 信号与 stderr 关键行，并给出明确的分步操作清单。

stderr 的关键字用于区分故障类型：HTTP 401、authorization failed 指向凭证问题，network error、non-JSON response 指向服务端不可达，VIP_EXPIRED 指向权限到期。网络问题和鉴权问题的处理建议不能混为一谈。

鉴权类错误的重试上限是 1 次。两次都失败说明是服务端问题，此时告知用户数据服务暂时不可用并停止重试，不得再次尝试任何业务推理。此外，错误信息中不得出现 AppKey / AppSecret 明文，密钥相关字段必须打码。