🍷 SipSiip 按杯/单杯酒价查询 Skill

一句话：告诉 AI 助手"查杯卖酒"，它就能自动查询合作门店的实时在架酒单与价格。

能力概览

工作流

用户提问："半山腰今晚有什么杯卖酒？"
        ↓
  Step 1: resolve_store(keywords="半山腰")
        ↓
  返回: match=AMBIGUOUS → candidates=[8家门店]
        ↓
  让用户选: "请问是哪家？"（列出选项）
        ↓
  用户选定: "凤凰汇那家"
        ↓
  Step 2: list_glass_wines(tenantId=1005)
        ↓
  返回: 8款酒（品名/规格/价格）
        ↓
  回答用户: 逐款展示酒单 ✅

详细规则

1. 已有 tenantId 或门店名唯一 → 直接调用 list_glass_wines(tenantId=…) 拉取酒单。

2. 只有店名/地点关键词 → 先调用 resolve_store(keywords=用户原话)：

   • match=NONE → 告知用户未找到该门店，建议换个关键词
   • match=SINGLE → 用返回的 tenantId 直接调 list_glass_wines
   • match=AMBIGUOUS → 用 candidates[] 列出选项让用户二选一/多选一，不得替用户猜！ 选定后再调

3. 回答格式要求：

   • 逐款说明：品名 / 规格 / 可售杯量及对应价格
   • 缺字段明确告知「无公开数据」，不猜价格
   • 价格为 ¥0 时提示可能未定价，建议现场确认
   • 白酒/红葡萄酒/起泡酒可分类展示，提升可读性

4. 禁止事项：

   • ❌ 编造价格或酒款
   • ❌ 多候选门店时替用户直接选定
   • ❌ 回答工具未提供的数据（如"全城排名""库存量"等）
   • ❌ 使用缓存数据替代实时接口结果

工具定义

工具一：resolve_store — 门店解析

响应结构 (result 字段)：

{
  "match": "NONE | SINGLE | AMBIGUOUS",
  "tenantId": "唯一命中时的门店ID（SINGLE 时有值）",
  "candidates": [
    {
      "id": "门店ID（用作 tenantId）",
      "name": "门店全称",
      "companyAddress": "详细地址"
    }
  ]
}

工具二：list_glass_wines — 酒单价格

响应结构 (result.items[])：

{
  "storeProductId": "商品ID",
  "title": "酒款名称",
  "imageUrl": "酒瓶图片URL",
  "bigGlassMl": 120,
  "bigGlassPriceYuan": 39.00,
  "midGlassMl": 120,
  "midGlassPriceYuan": null,
  "smallGlassMl": null,
  "smallGlassPriceYuan": null
}

注：规格字段（big/mid/small）可能为 null，表示该门店不提供此规格。价格为 0 时通常表示尚未定价。

HTTP 接口速查

可直接在浏览器中打开测试，无需任何 API Key。

MCP 接入方式（可选）

对于支持 MCP 协议的 AI 助手（Cursor / Claude Code / Trae / Windsurf 等），可通过 skill.json 配置 stdio MCP 服务端，实现更规范的工具暴露。详见仓库中的 skill.json 和 tools/sip-glass-wines-mcp/ 目录。

相关链接