Agent Skills
返回列表
酒云网AI助手

酒云网AI助手

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,将 @vinehoo/vinehoo-ai-helper 安装到你的 AI 助手中。

技能介绍

在对接葡萄酒电商平台时,直接让大模型解析商品库通常会遇到响应不稳定、合规链接易被截断或改写,以及模型容易把“推荐商品”夸大成“已完成购买”的情况。@vinehoo/vinehoo-ai-helper 不重新造一套商品检索逻辑,而是把请求路由到技能根目录中经过版本校验的 vinehoo CLI,让模型负责理解意图,工具负责返回结构化 JSON。

核心工作机制

  • 严格保留用户请求:技能会原样保留用户提到的前提,例如具体的预算区间、购买数量、饮用场景、款式偏好与品牌措辞,而不是让大模型自行压缩或改写需求。
  • 执行环境校验:所有工具命令前都会运行 vinehoo version,只有输出精确等于 vinehoo 0.1.1 时才会继续执行。如果本地缺少 CLI、下载失败或版本不符,检查脚本会按系统架构重新拉取官方版本并再次校验。
  • CLI 标准输出解析为 JSON:回答商品相关问题时,技能只依据 CLI 返回结果中的字段处理,不给它添加额外的编造项。
  • 会话上下文保持连续:同一轮对话中会保存非空的 session_id,使围绕同一酒款或同一需求的后续追问具备上下文连续性;遇到无关用户或独立新对话时,技能不会复用旧会话。
  • 授权流程优先级最高:一旦 CLI 返回授权 JSON,技能会先展示完整的原始授权 URL,然后立即调用 wait_for_auth 并等待命令结束;只有在命令正常完成后,再用完整原始请求重新执行检索。

输出边界与注意点

  • 只输出五项关键商品字段:当 data.products 非空时,技能只展示商品标题、价格、酒款介绍、150px 宽度缩略图(带有 ?x-oss-process=image/resize,w_150 参数)和购买链接。buy_url 会被原样呈现,不截断、不补全、不重写域名或查询参数。商品图片、购买链接等字段缺失时,直接标记该结果不完整,不假造数据。如果商品推荐为空,也不会自动退回模型生成的其他内容,避免虚假推荐出现。
  • 不负责结账动作:vinehoo-cli 不提供结账命令,因此技能会严格区分“推荐”与“购买”两种状态。除非工具明确返回完成状态,否则模型不会声称订单已创建、已支付或已发货。
  • 满足平台支持要求:默认下载与校验流程面向 macOS、Linux 的 AMD64/ARM64 架构,以及 Windows 的 AMD64/ARM64 架构。目前不支持 Linux ARM64,遇到未支持架构时会停下说明,而不是强行处理。
  • 默认搜索超时为 300 秒:除非发起方明确指定其他时长,技能会保持这个默认超时。遇到 401 时,技能会提示使用者在本地刷新授权,然后重试。

使用场景

  • 在对话里把用户的预算、数量和款式偏好原样传给酒云网 CLI,返回商品推荐
  • 处理授权 JSON 时,先展示完整授权链接,再执行 wait_for_auth 并复跑搜索
  • 在 CLI 标准输出中解析 error_code、session_id 和 data,按字段决定应答
  • 当商品缺少非空 buy_url 时,说明链接不完整,避免伪造购买入口

适合人员

  • 搭建对话式导购 Agent 的后端工程师,需要稳定调用酒云网 CLI
  • 编写工具型技能的开发团队,关注版本校验、JSON 解析和错误处理
  • 维护购买链路、需要区分推荐与下单状态的工程师
  • 处理跨会话上下文,且不能复用 session_id 的 Agent 工程师