前言¶
在 Agent 里帮用户买蛋糕、鲜花或零食,常见做法是再挂一层 MCP 或手写一堆 HTTP 封装。蛋叔商城(dangaoss.com)本身提供 WorkBuddy 侧的 JSON-RPC 接口,参数嵌套和返回结构都不算直观。若把「拿 token、选城市、管地址、搜 SKU、出支付链接」拆成零散脚本,维护成本高,也容易在 Windows 与 Linux 上踩编码和调用方式的问题。
下面介绍 SkillHub 社区技能 蛋糕叔叔商城点单助手(坐标 @user_c70e116b/dgss,当前版本 1.0.29)。它把蛋叔商城点单流程写进标准 SKILL.md,Agent 按步骤驱动;底层通过 curl 访问官方端点,并附带 scripts/dgss.py 作为 Windows 等环境下的调用封装,无需额外 MCP 代理。SkillHub 分类为 business-ops,标签含 requires_api_key=true(实际业务侧使用用户提供的 user_token)。
这是什么¶
蛋糕叔叔商城点单助手是面向蛋叔商城(dangaoss.com)的订购 Skill:蛋糕、甜品、零食、鲜花等品类的查找、选购与预订。发布者为社区用户 user_c70e116b,来源为 community。当用户提到购买蛋糕、甜品、零食、鲜花,或出现「蛋叔」「蛋糕」「下单」「订购」等意图时,Agent 应自动加载该 Skill。
官方入口:
- Skill 包地址:https://api.skillhub.cn/user_c70e116b/dgss
- SkillHub 页面:https://www.skillhub.cn/skills/user_c70e116b/dgss
核心功能¶
以下能力均来自 Skill 说明与安装包内容,可按步骤复现。
触发与工具约束¶
- 触发场景:蛋糕预订、生日下单、甜品/零食/鲜花订购、查找附近门店好物等自然语言请求。
- 允许工具:
execute_command、read_file(由 Agent 执行脚本或 curl,并读写本地 token 文件)。 - 协议:请求
https://www.dangaoss.com/dsapi/workbuddy/mcp_server,JSON-RPC 2.0;业务成功码为code: 200;响应为双层 JSON(外层 RPC →result.content[0].text→ 内层{code, data, msg})。请求超时约 60 秒。
地址与城市¶
- 用户主动提供 user_token(禁止复用他人 token),并写入本地
dgss_token.md。 - 询问配送城市,名称规范到「市」一级(如「北京」→「北京市」);不接受省、区县等非标准城市名。
- 调用 getAddrList 列出该城市已保存地址,用户选择
id作为 aid;无地址时通过 addAddrList 新增(字段名须用area、addr,而非district、detail)。 - 可将
default_city、default_aid记入dgss_token.md,下次优先确认是否沿用。
商品搜索¶
- 分类 cat_id:
1蛋糕、5零食、8鲜花;关键词模糊时 Skill 要求向用户确认品类。 - 调用 sweets_lst:必填
user_token、aid、keyword、cat_id;可选page分页。 - 列表需按 Skill 规定的六列展示(序号、品牌、商品名称、规格、价格、详情链接)。
下单与订单查询¶
- 调用 getOrderaddr 生成下单 URL(参数含
spec_id、quantitys、city_name等);下单前须校验规格 ID 与规格名称一致。 - 从返回 URL 中解析
scene参数,可写入dgss_token.md便于复购或查询。 - 调用 getOrderStatus 按
scene查询订单状态;用户发送 8–20 位纯数字时,Skill 约定可识别为 scene 凭证。
调用方式¶
- Linux / macOS:优先尝试
curl;亦可直接执行python "<skills目录>/dgss/scripts/dgss.py" <命令> '<JSON参数>'。 - Windows:
curl对中文参数易乱码,Skill 要求用cmd /c包裹 Python 调用,路径使用%USERPROFILE%下的 skills 目录。 - 首次探测成功的执行方式可记入
MEMORY.md的dgss_exec_method,后续复用。
安装与启用¶
安装 SkillHub CLI(未安装时)¶
先检查是否已有 CLI:
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方安装文档执行完整安装(示例为文档中的推荐命令):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。本 Skill 的搜索结果显示的安装方式为:
skillhub install dgss --namespace user_c70e116b --dir <你的 Agent skills 目录>
也可让 AI 按 SkillHub 安装说明操作,提示词示例(来自 SkillHub 页面):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_c70e116b/dgss`。
常见 Agent 的 skills 路径(摘自 SkillHub 安装文档):
| 环境 | 默认 skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装完成后,按你所用客户端要求重启或刷新 Agent,使 SKILL.md 被加载。
凭证与本地文件¶
- 用户在浏览器打开 https://www.dangaoss.com/web/wb_index.html 登录后,将 USER_TOKEN 提供给 Agent;Skill 要求写入
dgss_token.md,且勿将含 token 的文件提交到 Git。 - SkillHub 元数据标记
requires_api_key=true,落地时即对应用户 token 的配置与保管。
典型用法¶
下面按 Skill 规定的顺序说明一次完整点单;实际对话中由 Agent 逐步提问,无需用户记忆接口名。
1. 提供 token
用户完成蛋叔账号登录后,把 token 发给 Agent。Agent 更新 dgss_token.md 中的 user_token。
2. 确认城市与地址
Agent 询问配送城市,必要时调用地址列表(Linux/macOS 示例路径请替换为你的 skills 安装位置):
python "~/.cursor/skills/dgss/scripts/dgss.py" getAddrList '{"user_token":"TOKEN","city_name":"北京市"}'
3. 搜索商品
确定 cat_id 与关键词后搜索,例如巧克力蛋糕:
python "~/.cursor/skills/dgss/scripts/dgss.py" sweets_lst '{"user_token":"TOKEN","aid":"10806796","keyword":"巧克力","cat_id":1,"page":1}'
4. 生成下单链接
用户选定序号对应规格后:
python "~/.cursor/skills/dgss/scripts/dgss.py" getOrderaddr '{"user_token":"TOKEN","aid":"10806796","spec_id":1,"city_name":"北京市","quantitys":1}'
返回的 data 字段为可打开的下单 URL(如 https://www.dangaoss.com/web/wb_order.html?scene=...),用户在微信等环境中完成支付。
快捷口令(Skill 内置)
- 「再来一单」「复购」:读取
dgss_token.md中上次订单信息,在默认地址上重复下单。 - 「买某某商品」:若已有默认地址,可跳过城市与地址步骤直接搜索。
- 「换地址」「换 token」:清除或更新
dgss_token.md中对应字段后重新走流程。
适用场景与注意¶
适合谁
- 需要在 Cursor、Claude Code、Codex 等支持 Agent Skills 的环境里,用自然语言完成蛋叔商城选品与出单链接的团队或个人。
- 希望避免单独部署 MCP,仅依赖
curl/ 脚本与execute_command的场景。
限制与注意
- 支付、物流、退款、发票等未在 Skill 流程中实现的能力,Skill 明确要求用固定话术回应,不引导至其他平台。
- 下单仅支持单个
spec_id;部分城市或区域可能返回无法配送(如业务码 405)。 - token 与地址信息存放在 Agent 工作区本地文件中,需自行做好权限与备份;勿在公开场合粘贴 token。
- SkillHub 页面统计(截至资料抓取):评分 100000,下载 1932 次,安装 117 次;以 SkillHub 实时数据为准。
结尾¶
蛋糕叔叔商城点单助手把蛋叔商城 JSON-RPC 点单链路固化成可执行的 Skill 流程:token 登录、城市与地址、分类搜索、生成下单链接与订单查询,并区分 Windows 与 Unix 的调用方式。若你正在集成生活类电商能力,可从官方地址获取最新包与版本说明:
https://api.skillhub.cn/user_c70e116b/dgss