技能介绍

要解决的问题

拜访话术表格生成属于受保护能力，不能像普通本地脚本那样拿到提示词就直接跑。如果缺少硬门禁，常见事故有三类：跳过授权直接产出业务结果、凭证过期后静默重试、把 AppKey/AppSecret 明文拼进命令或环境变量。这里的设计目标不是“让调用更顺滑”，而是让未授权状态下的任何业务输出都不可能发生。

核心能力与关键步骤

授权检查。 运行 python scripts/auth.py --ensure。脚本优先读取包内 _meta.json 的 slug（如 BT_BFHBGSC_20260521）作为服务端 skillCode，本地凭证缓存命中且远程校验通过时输出 AUTH_OK。只有在包内缺少 _meta.json 时才手动传 --skill-code。
绑定流程。 遇到 AUTH_REQUIRED + CREDENTIALS_MISSING、AUTH_INVALID + CREDENTIALS_INVALID，或仅在 --bind-jwt 路径上的 AUTH_INVALID 时，先通过 WorkBuddy 的 connect_cloud_service 工具拿到当前登录用户 JWT，再执行 auth.py --bind-jwt 完成绑定。成功输出 AUTH_BIND_OK 后必须重新执行 --ensure。
受保护内容拉取。 拿到 AUTH_OK 并不意味着可以自由发挥。下一步必须运行 scripts/protected.py，只有它成功返回 protected instructions，才能严格按照返回内容继续执行；未拿到就停止，不得凭本地提示词或历史上下文兜底。
失败报告。 stdout 只有 5 种信号，业务错误细节在 stderr，需要同时观察两者。失败时立即停下手头工作，原样转述 stdout 信号与 stderr 关键行，并给出明确的 1/2/3 步操作清单；密钥字段必须打码，例如 app_key=abc****。
重试上限。 CREDENTIALS_MISSING、CREDENTIALS_INVALID、HTTP 401/403、authorization failed、stderr 出现签名或鉴权关键字，或 protected.py 退出码非 0 且提示鉴权类错误，都触发一次重新绑定；绑定完成后重新 --ensure 拿到 AUTH_OK 才能继续。最多重试 1 次，两次失败即告知数据服务暂时不可用，并停止重试。

适用边界与注意点

鉴权门禁与业务输出是互斥关系：鉴权未通过时禁止产出任何业务结果，不能在末尾轻描淡写补一句鉴权有问题。
不要手动解析 JWT、拼接 AppKey/AppSecret，也不要绕过 scripts/auth.py 自行调用绑定接口。
需要区分网络错误与鉴权错误：network error、non-JSON response 与 VIP_EXPIRED、权限不足给出的处理建议不同。
slug 必须是平台维护的技能编号，而不是展示名称。
最终生成逻辑以 protected.py 返回的 instructions 为准，本地 SKILL.md 不能替代云端受保护内容。