百通AI KA连锁联合生意计划

解决什么问题

KA 连锁（关键客户连锁）场景下的联合生意计划（JBP）制定与实施，通常依赖散落在多份文档、邮件和会议纪要中的信息，缺乏统一的执行入口。这个技能把 JBP 的制定与实施收敛为一条可重复执行的链路：环境检测 → 身份鉴权 → 拉取受保护的业务指令 → 按指令执行。

真正的难点不在业务逻辑本身，而在于该技能包属于受保护能力——没有有效的云端授权，就拿不到实际的 JBP 工作流内容。因此它的设计重点之一，是把「如何安全地把门打开」这件事做严谨。

技能如何工作

核心流程分三个阶段：

• Python 环境检测（必须最先执行）：在运行任何脚本之前先静默检测可用的 Python 命令，命中且版本正常就直接执行，只有检测失败才向用户报告。Windows 上 python 命令可能打开 Microsoft Store 而非真正执行，建议使用 py -3 启动器；若用户已给出全路径，则直接采用该路径。
• 授权门禁：所有工作流都经由 scripts/auth.py 完成，由它统一处理本地凭证缓存、WorkBuddy 用户绑定、平台授权校验与错误信号输出。首次使用时收到 AUTH_REQUIRED / CREDENTIALS_MISSING 属于正常的首次绑定流程，技能会主动调用 connect_cloud_service 获取登录用户 JWT 并完成绑定，不会停下来打断用户；凭证过期时则用新 JWT 覆盖旧缓存。
• 受保护内容拉取：鉴权通过后执行 scripts/protected.py 获取云端 protected instructions，只有成功拿到指令才能继续执行，本地提示词和历史上下文不能替代。

适用边界与注意点

• 鉴权与业务输出互斥：绑定流程执行后 --ensure 仍返回非 AUTH_OK，即为真正的失败，必须立即停止业务推理并向用户报告，不允许「鉴权有问题但先把结果产出」。
• 重试上限为 1 次：连续两次失败说明是服务端问题，告知用户「数据服务暂时不可用」后停止重试。
• 区分错误类型：AUTH_INVALID 配合 stderr 中的 network error 属于网络问题，而 authorization failed、VIP_EXPIRED 属于权限或订阅问题，两者的处理建议不同。
• 密钥不外泄：AppKey / AppSecret 不向用户展示，错误报告中的密钥字段必须打码。
• skillCode 来源：优先读取包内 _meta.json 的 slug（如 BT_F3F8BB95），这是平台维护的技能编号而非展示名称，仅在缺失时才手动传 --skill-code。