Agent Skills
返回列表
市场部知识管理

市场部知识管理

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @baitongai/marketing-knowledge-management。

技能介绍

要解决的问题

受保护技能最常见的故障不是模型不会做，而是「没授权却照做」。很多集成里，凭证缺失、签名过期、权限不足都可能被悄悄吞掉，用户拿到看似正常的结果，实际上根本没有权限。这个技能把授权做成强制门禁：未通过授权检查，就不得开始任何业务推理。

技能如何工作

核心逻辑分两层，全部封装在 scripts/auth.py 中，不需要在提示词里手动拼 AppKey/AppSecret 或解析 JWT：

  • 先执行 auth.py --ensure 做授权检查；服务端技能编号默认取包内 _meta.json 的 slug（如 BT_XSYC），它是平台维护的编号，不是展示名
  • 只有输出 AUTH_OK 才继续
  • 遇到 AUTH_REQUIRED、AUTH_INVALID、CREDENTIALS_MISSING、CREDENTIALS_INVALID 时，先通过 WorkBuddy 的 connect_cloud_service 工具获取登录用户 JWT，再调用 auth.py --bind-jwt 完成绑定
  • 返回 AUTH_BIND_OK 后重新检查；仍未拿到 AUTH_OK 就停止，并按模板向用户报告
  • 授权通过后必须执行 scripts/protected.py 拉取云端 protected instructions，拿到内容才能严格按返回结果继续

适用边界与注意点

  • 鉴权门与业务输出互斥：绝不允许「鉴权失败但仍产出一份结果，末尾轻描淡写提一句」
  • 禁止静默重试或降级：失败时原样转述 stdout 信号与 stderr 关键行，给出明确的操作步骤清单，而不是「稍后再试」
  • 密钥不落地：AppKey/AppSecret 不出现在业务命令、环境变量或回复中，报告中的相关字段必须打码
  • 区分网络错误与鉴权错误：HTTP 401/403、authorization failed 走重新绑定流程；纯网络错误按对应场景处理
  • 重试上限 1 次：两次仍失败说明是服务端问题，应告知「数据服务暂时不可用」并停止

使用场景

  • 首次调用受保护技能时本地没有凭证缓存，需要走 WorkBuddy 登录获取 JWT 并完成绑定后重试授权检查。
  • 运行 `auth.py --ensure` 返回凭证失效或签名过期时，重新绑定 JWT 并再次校验以恢复受保护内容拉取。
  • 绑定接口返回手机号未注册或技能被禁用时，按 stderr 错误信息向用户说明下一步处理方式并停止业务推理。
  • 服务端权限不足或 VIP 过期导致 `protected.py` 拉取被拒时，明确报告鉴权失败原因并终止后续执行。

适合人员

  • 调用受保护技能的 Agent 工程师，需要按规范完成授权检查再拉取云端指令。
  • 负责接入技能凭证体系的开发者，需要处理 JWT 绑定与错误码映射。
  • 管理企业受保护内容的维护者，需要在权限变更后重跑授权流程。
  • 排查鉴权失败问题的用户，需要根据信号和 stderr 定位是凭证还是网络原因。