金谷园饺子馆 Skill
金谷园饺子馆信息查询与在线排队取号。通过金谷园官方 API 查询店铺、排队和菜品信息;内置真实排队动作仅用于在线取号、本人排队进度查询、取消排队。 Skill: 金谷园饺子馆 Skill Owner: jinguyuan Summary: 金谷园饺子馆信息查询与在线排队取号。通过金谷园官方 API 查询店铺、排队和菜品信息;内置真实排队动作仅用于在线取号、本人排队进度查询、取消排队。 Tags: latest:3.2.1 Version history: v3.2.1 | 2026-08-28T17:31:53.275Z | user 修复美团授权会话路径和 authStatus 状态码语义 v3.1.2 | 2026-08-20T15:49:14.681Z | user 同步 queue-status.v2 排队状态契约,明确实时新鲜度与立冬冬至特殊日期口径 v3.1.1 | 2026-08-01T10:24:12.975Z | user 移除 Skill 抽奖能力,仅保留公开查询和排队动作 v3.1.0 | 2026-07-31T00:42:39.322Z | user
Rank
62
Safety
84
Downloads
4.1k
Updated
Oct 9, 2026
Version
3.2.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 4.1K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 4.1K downloadsadoption · observed Oct 9, 2026
- Latest release
- 3.2.1release · observed Aug 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17dydejc127drzwty5stpct5183k62a:jinguyuan-dumpling-skill- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-jinguyuan-jinguyuan-dumpling-skill/snapshot"
Documentation
CLAWHUB
160,000 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: jinguyuan-dumpling-skill
description: 金谷园饺子馆信息查询与在线排队取号。通过金谷园官方 API 查询店铺、排队和菜品信息;内置真实排队动作仅用于在线取号、本人排队进度查询、取消排队。
version: 3.2.1
alwaysApply: false
metadata:
openclaw:
requires:
bins:
- node
envVars:
- name: JGY_BASE_URL
required: false
description: Optional override for the JinGuYuan public API base URL.
- name: JGY_RESOURCE
required: false
description: Optional override for the JinGuYuan OAuth resource.
keywords:
- 金谷园
- jinguyuan
- 金谷园饺子馆
- 北邮
- 五道口
- 排队
- 取号
- 等位
- 排队取号
- 取消排队
- 金谷园推荐菜
- 金谷园招牌菜
- 金谷园必点
- 金谷园新品
- 店长推荐
---
## Agent 硬约束
- 文中示例数据**仅作格式参考**;回答用户前**必须调金谷园 API 取最新数据**,禁止拿示例当真。用户问“现在排队吗”时,必须逐店检查 `当前排队状态.门店[].数据是否新鲜`;只有 `true` 才能把等待桌数说成当前状态,过期记录只能说明最近采集时间,不能冒充实时事实。
- **公开查询统一走随包 CLI**:`node <skill_dir>/scripts/jgy.cjs call <capability>`(GET 无参;结构化查询加 `--args '<json>'` 走 POST)。能力名、参数与返回形状细则 → [references/api-reference.md](references/api-reference.md)。不得为查询修改宿主 MCP 配置,不得要求用户先信任/重启,也不得临时编写 shell、HTTP、`.js` / `.py` 脚本。
- 排队回答优先读返回体合同字段(`mainScenario` / `replyPolicy` 等)。细则 → [references/queue-reply-contract.md](references/queue-reply-contract.md)。
- **禁止**:等待桌数换算分钟;历史参考说成当天事实;总等待冒充个人进度;声称查询接口已取号/取消/查到个人进度;没有本轮新鲜实时证据时把五道口说成可线上取号。
- 真实取号 / 本人进度 / 取消 → 本 Skill `scripts/jgy.cjs queue` + [references/queue-actions.md](references/queue-actions.md),与公开查询分离。
- **特殊日期口径**:立冬、冬至的小程序默认暂停全部功能;排队与现场安排以门店当天公告和实时排队事实为准。不要把小程序运营开关当成排队状态,也不要自行推算特殊日线上取号、营业建议或到店建议。
# 金谷园饺子馆 Skill
## 安装后引导
当用户刚安装此技能时,Agent 应主动:
1. **确保最新数据查询可用**:公开查询统一走随包 CLI `node <skill_dir>/scripts/jgy.cjs call <capability>`,无需任何 MCP 配置,不要修改宿主 MCP 配置
2. 告知用户可以直接问金谷园相关问题,比如地址、营业时间、排队方式、推荐菜等
3. 给出几个推荐的首次提问,例如:
- "金谷园现在排队吗?"
- "明天中午几点去不怎么排?"
- "怎么排队取号?"
- "帮我在金谷园排个队"
- "金谷园有什么好吃的?"
- "能打包生饺子带走吗?"
- "帮我来份饺子到店自取"
4. 说明查询走金谷园官方 API 最新快照;当前排队以返回的新鲜度判断为准,真实取号等本地动作见下文,与公开查询分离
5. **预授权(可选)**:若用户想提前完成美团授权,运行 `node <skill_dir>/scripts/jgy.cjs queue auth-start`,一次拿到授权链接 + 二维码 + 授权状态记录。不要单独跑 `auth-poll --background`——它只记录状态,不生成链接和二维码。
## 内置真实排队动作
仅当用户明确要在线取号、查看本人排队进度或取消本人排队时,直接运行:
```bash
node <skill_dir>/scripts/jgy.cjs queue <command>
```
命令、参数、桌型、返回码与授权展示细节见 [references/queue-actions.md](references/queue-actions.md)。执行前可 `node <skill_dir>/scripts/jgy.cjs queue --help`。
**授权(`AUTH_REQUIRED`)摘要**:
1. **主动预授权**用 `auth-start`(一条命令拿到链接 + 二维码 + 授权状态记录)。业务命令(`index` / `take-number` 等)发现没 Token 时也会自动走同一流程。**禁止**单独跑 `auth-poll --background` 来发起授权——它只记录状态,不生成链接和二维码;**禁止** `auth-poll --wait` 堵对话。
2. PNG 直接在当前工作区根目录,文件名为 **`jinguyuan-auth-qr-<authRunId>.png`**(非隐藏、无子目录;`data.qrImagePath` = **绝对路径**)。始终使用返回路径,不猜文件名;推荐原样贴 `data.userReplyMarkdown`。
3. **主气泡必须**有:``(有图时)+ 可点链接与明文 URL。仅 Read / 仅附件侧栏 / 步骤卡「已展示」**不算**。
4. 告知用户授权后稍候;宿主若未自动继续,用户可回复“已授权”。收到回复后短查 `auth-status`,再继续原任务。部分宿主能自动续跑,部分不能,**禁止**说“无需回复”或保证一定自动通知。无 `authLink` 时先 `logout` 成功再重跑。Token:`~/.jinguyuan/passport-auth.json`。
5. **授权成功不携带门店,也不等于新的业务请求**:若本轮只是 `auth-start` / “只授权”,只报告成功后结束,不追问、不推荐取号、不从记忆续接旧任README.md
# 金谷园饺子馆 Skill     这是一个 AI Skill——安装后,你的 AI 助手就能帮你查金谷园在哪、几点开门、这会儿排不排队、几点去更稳,也能查推荐菜、外卖和生饺子打包怎么煮;需要时,还能帮你在线排队取号。 开了快二十年的饺子馆,有了自己的AI服务。 ## 关于金谷园 北邮旁边的饺子馆。官网:[jinguyuan.cloud](https://jinguyuan.cloud) | 项目 | 内容 | |------|------| | 餐厅名称 | 金谷园饺子馆 | | 营业时间 | 10:00 - 22:00(以实际查询为准) | | 北邮店 | 杏坛路文教产业园K座南2层 | | 五道口店 | 五道口东源大厦4层 | ## 这个 Skill 能做什么 金谷园饺子馆的官方信息服务,可以查店、查活动、查推荐菜,也能处理到店自取和排队取号这些具体场景: | 能力 | 你可以问 | |------|----------| | 餐厅信息 | "金谷园在哪?""几点开门?""能外卖吗?""Wi-Fi 密码?" | | 推荐菜 | "有什么好吃的?""今天吃什么""招牌菜" | | **到店自取** | "帮我来份饺子""提前点餐到店取" | | 排队信息&建议 | "这会儿排队吗?""晚上七点去用排么?""几点去不用排?" | | **排队取号** | "帮我排个队""取消排队""排队进度" | | 生饺子打包 | "能打包吗?""生饺子怎么煮?" | | 最新消息 | "有什么新活动?" | ## 在线排队取号 本 Skill 内置了基于**美团排队**的真实动作,AI 助手可以帮你取号、查本人订单和取消排队。美团授权使用随包明文 Passport 实现,用户扫码确认后 Token 仅缓存在本机 `~/.jinguyuan/passport-auth.json`。 **支持的操作:** | 操作 | 说明 | 你可以说 | |------|------|----------| | 查询排队状态 | 查看当前等待桌数和排队压力 | "金谷园现在排队情况怎么样?" | | 查询餐段事实 | 查询已经发生的午市/晚市实际观测 | "今天中午几点开始排?" | | 查询餐段建议 | 参考前一天和上周同日,给未来餐段建议 | "明天中午几点去比较稳?" | | 取号 | 选择桌型和人数,在线取号 | "帮我在北邮店排个队,2个人" | | 查询进度 | 查看当前排队号、前方等待桌数 | "我前面还有几桌?" | | 取消排队 | 取消已有的排队订单 | "取消排队" | **使用流程:** 1. 告诉 AI 助手你要在北邮店排队 2. AI 查询可选桌型,跟你确认桌型和人数 3. 确认后自动取号,返回排队号和等待信息 4. 随时可查进度或取消 首次使用需完成美团账号授权(AI 助手会引导你完成)。 ## 运行环境 支持 Windows、macOS 和 Linux,需要 Node.js 18 或更高版本,无需 npm 安装。 ## 安装 直接拷贝下面这句话发给你的 AI 助手: > 安装 https://gitee.com/JinGuYuan/jinguyuan-dumpling-skill Agent 会自动克隆仓库并安装到对应的 Skill 目录。 ## 关于金谷园 MCP 金谷园同时提供独立的 MCP 服务。若只需要查询店铺、菜品和排队信息,可以不安装 Skill,直接接入金谷园 MCP;在线取号、本人进度和取消排队等本地授权能力仍需安装 Skill。 | 项目 | 内容 | |------|------| | 接入点 | `https://mcp.jinguyuan.cloud` | | 协议 | Model Context Protocol(MCP) | | 传输方式 | Streamable HTTP | ## 发布平台 - GitHub:https://github.com/JinGuYuan/jinguyuan-dumpling-skill - Gitee:https://gitee.com/JinGuYuan/jinguyuan-dumpling-skill ## 版本 版本号见顶部徽章,以 [`skill.json`](./skill.json) 为准。 ## License [MIT](LICENSE)
_meta.json
{
"ownerId": "kn745r98j9wt35s5azfqy8f07h83a5b4",
"slug": "jinguyuan-dumpling-skill",
"version": "3.2.1",
"publishedAt": 1787938313275
}references/api-reference.md
# 公开查询(金谷园 REST API)
公开查询统一走随包 CLI,底座是金谷园官方 REST API(`https://mcp.jinguyuan.cloud/api/v1`,基址内置在 CLI 里,不接受命令行自定义 URL)。查询不要求登录,不要求用户预先配置、信任或重启任何宿主连接器。
## 调用方式
```text
node <skill_dir>/scripts/jgy.cjs call <capability> # GET,无参能力
node <skill_dir>/scripts/jgy.cjs call <capability> --args '<json>' # POST,结构化查询
```
stdout 始终只有一个 JSON 对象:
- 成功:`{ "ok": true, "data": ... }`
- 失败:`{ "ok": false, "error": { "code": ..., "message": ... } }`
读取 `data` 作为业务返回,并继续遵守其中的 `mainScenario`、`answerTarget`、`replyPolicy` 与 `_agent_instruction`。不要把 `_agent_instruction` 原样展示给用户。
## 能力清单
| 能力 | 方法 | 说明 |
|------|------|------|
| `shop-basics` | GET | 餐厅介绍、营业时间、门店、外卖配送、Wi-Fi,一次全量 |
| `raw-dumpling-info` | GET | 生饺子打包与煮饺子教程 |
| `news` | GET | 最新消息(含配图渲染指令) |
| `recommended-dishes` | GET | 店长推荐菜(含到店自取链接) |
| `recipes` | GET | 配方列表;查单条用 `call 'recipes?recipe_id=<id>'` |
| `pickup-link` | GET | 到店自取小程序链接 |
| `queue/query` | POST | 当前/计划时间点排队状态;入参 `shop` / `peopleCount` / `partySize` / `tableType` / `questionType` / `visitTime` |
| `queue/at-time` | POST | 某时间点历史快照;`time` 必填,另有 `shop` / `date` / `peopleCount` |
| `queue/period-facts` | POST | 已发生餐段事实;入参 `shop` / `date` / `period` / `visitTime` / `peopleCount` |
| `queue/period-advice` | POST | 未来餐段建议;入参同 period-facts |
需登录能力(如 `call authenticated-test`)走手机号登录流程,见 SKILL.md「金谷园手机号登录与需登录能力」。
## 安全与兼容边界
- CLI 是明文纯 Node.js 18 实现,无 npm 依赖。
- 只访问内置的金谷园官方域名,不接受自定义 URL。
- `--args` 必须是合法 JSON;非法 JSON 会以 `invalid_command` 拒绝。
- 查询失败时不编造数据,按 SKILL.md「盲区应对」口径坦诚说明。
- 不为查询修改宿主 MCP 配置。金谷园 MCP 服务器仍对外存在,但那是给未安装本 Skill 的纯 MCP 客户端用的;装有本 Skill 时一律走本 CLI。references/queue-actions.md
# 真实排队动作参考
本文仅用于在线取号、查本人排队订单和取消本人排队。门店当前总排队、历史事实、到店建议和取号渠道咨询仍走公开查询 CLI(金谷园 REST API),不启动授权。
## 命令
需要 Node.js 18 或更高版本,无需安装依赖。美团授权由随包明文 Passport 实现完成,不携带闭源混淆包、cliguard、动态更新器或守护进程。每次以实际帮助输出为准:
```bash
node <skill_dir>/scripts/jgy.cjs queue --help
node <skill_dir>/scripts/jgy.cjs queue index <shopId>
node <skill_dir>/scripts/jgy.cjs queue take-number <shopId> --people-count <N> --table-type-id <ID> --confirm
node <skill_dir>/scripts/jgy.cjs queue order-detail <shopId>
node <skill_dir>/scripts/jgy.cjs queue order-cancel <shopId> --confirm
node <skill_dir>/scripts/jgy.cjs queue auth-start
node <skill_dir>/scripts/jgy.cjs queue auth-status
node <skill_dir>/scripts/jgy.cjs queue auth-poll --background [--qr-image-path <path>]
node <skill_dir>/scripts/jgy.cjs queue logout
```
**发起授权用 `auth-start`**:一条命令拿到授权链接 + 二维码 + 授权状态记录,与业务命令触发的授权流程完全一致。**不要**单独跑 `auth-poll --background` 来发起授权——它只记录状态,不生成链接和二维码。
Agent 对话中**不要**使用阻塞式 `auth-poll` / `auth-poll --wait`(会长时间占住 Terminal,用户看不到授权链接与二维码)。`AUTH_REQUIRED` 时授权状态已记录,展示后等待用户扫码;用户回复“已授权”后用 **`auth-status`** 短查即可。
CLI 在 stdout 输出单个 JSON 对象:`{ ok, code, message, data? }`。不要把内部命令名或返回码原样告诉用户,除非排查 MCP/CLI 合同确实需要。
## 门店
| 门店 | `shopId` | 真实动作约束 |
|---|---:|---|
| 北邮总店 | `4211342` | 可查桌型、取号、查本人订单、取消 |
| 五道口店 | `1756895741` | 通常以到店取号为主;只有本轮公开查询新鲜快照或 `index 1756895741` 明确显示 `supportQueue: true` 时,才可说明当天开放并继续取号确认流程 |
用户未说门店时先追问,不猜 `shopId`。
`AUTH_SUCCESS` 本身不包含门店。若本轮只是 `auth-start` / “只授权”,只报告授权成功后结束,不追问下一步,也不从记忆、旧任务或其他 Skill 推断门店。仅当授权由本轮明确业务命令触发时,才恢复该原命令;合法门店只采用上表映射或该原命令已有的 `shopId`。
## 桌型与确认
1. 取号前先运行 `index`,只使用其 `data.tables[]` 返回的 `tableTypeId`、`tableTypeName`和 `capacity`。
2. 用户同时说人数和桌型时,将自然语言桌型匹配到返回的标准桌型;不把“大的”“两人桌”等原话当作 ID。
3. 只说人数时,按 `capacity.min/max` 筛选:唯一匹配可作为建议,多个匹配列出后请用户选择。只说桌型时,追问就餐人数。
4. 在运行 `take-number` 前,明确复述门店、人数和标准桌型,必须取得用户对本次真实取号的明确确认,再带 **`--confirm`** 执行。没有 `--confirm` 时 CLI 返回 `CONFIRM_REQUIRED`,**不会**取号。
5. 在运行 `order-cancel` 前,先用 `order-detail` 说清待取消的订单,必须取得用户明确确认后,再执行 `order-cancel <shopId> --confirm`。
之前对话中的宽泛意向不等于本次动作确认。**授权成功也不等于确认取号或取消**——授权成功后应重新展示桌型/订单并再问一句「确认取号/取消吗?」,用户答应后再带 `--confirm`。
## 授权状态
`AUTH_REQUIRED` 可能是新授权流程,也可能是业务缓存 Token 过期后仍未拿到新授权链接;不能假定其 `data` 一定包含 `authLink`。
美团 Passport 轮询以 `data.token` 为最终成功凭据:实测 `authStatus=4` 且同时返回 `data.token` 表示用户已确认授权;`authStatus=1` 表示等待,`authStatus=2` 表示用户取消,`authStatus=3` 表示风控拒绝,`authStatus=5` 表示超时。不要把 `authStatus=4` 当成取消,也不要仅凭状态码判定成功。
收到 `AUTH_REQUIRED` 后:**阶段 A 内联图 + 链接** → **阶段 B `auth-status`**。本机用 `~/.jinguyuan/auth-poll-current.json` 指向本次 run 的独立状态文件;Agent 只需调用 `auth-status`,不要自行读取或改写状态。
1. **有 `authLink`**
- **图**:`data.authRunId` 标识本次授权;`data.qrImagePath` = **绝对路径**(文件直接在工作区根目录,形如 `jinguyuan-auth-qr-<authRunId>.png`,非隐藏、无子目录);可选 `qrImagePathRelative`。**不要**用 `~/.jinguyuan`,也不要猜固定文件名。
- **阶段 A(对齐 V1)**:
1. 有图时:`Read` 绝对路径 PNG,并在主气泡正文写 ``(推荐直接贴 `userReplyMarkdown`)。
2. ⚠️ 仅 Read / 仅附件侧栏 / 步骤卡「已展示」**不算**——用户扫不到码。
3. **链接必含**(可点 + 明文 URL);云端主通道是 https。
- **阶段 B**:告知用户授权后稍候;宿主若未自动继续,用户AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/jinguyuan/skills/jinguyuan-dumpling-skill",
"sourceUrl": "https://clawhub.ai/jinguyuan/skills/jinguyuan-dumpling-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T05:59:26.211Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jinguyuan-jinguyuan-dumpling-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jinguyuan-jinguyuan-dumpling-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T05:59:26.211Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "4.1K downloads",
"href": "https://clawhub.ai/jinguyuan/jinguyuan-dumpling-skill",
"sourceUrl": "https://clawhub.ai/jinguyuan/jinguyuan-dumpling-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T05:59:26.211Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "3.2.1",
"href": "https://clawhub.ai/jinguyuan/jinguyuan-dumpling-skill",
"sourceUrl": "https://clawhub.ai/jinguyuan/jinguyuan-dumpling-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T17:31:53.275Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-jinguyuan-jinguyuan-dumpling-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-jinguyuan-jinguyuan-dumpling-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 3.2.1",
"description": "修复美团授权会话路径和 authStatus 状态码语义",
"href": "https://clawhub.ai/jinguyuan/jinguyuan-dumpling-skill",
"sourceUrl": "https://clawhub.ai/jinguyuan/jinguyuan-dumpling-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T17:31:53.275Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
