前言¶
在企业福利或烘焙电商场景里,客服、运营或内部工具经常要根据订单号确认「这笔单对应哪款蛋糕」。如果每次都在浏览器里翻后台,或临时查接口文档再手写请求,对话式 Agent 很难直接帮用户完成查询。
下面介绍 SkillHub 上的社区 Skill「蛋糕叔叔点单」(坐标 @user_c70e116b/dgss-order)。安装后,Agent 可按 SKILL.md 中的约定识别订单号、调用蛋糕叔叔交易侧接口,并把商品名称整理成自然语言回复。
这是什么¶
「蛋糕叔叔点单」是 SkillHub 社区来源(community)的 Agent Skill,发布者为 user_c70e116b,分类为 business-ops,当前索引版本为 1.1.3。SkillHub 页面将其概括为全国性烘焙甜品聚合与企业福利相关能力,覆盖线上订购、全国派送、同城配送、同城自提,以及蛋糕、零食、鲜花、电影等品类。
就本版本包内唯一的 SKILL.md 而言,技能定位更具体:通过订单号查询蛋糕商品名称,调用 trade.dangaoss.cn 上的 cake_api/ck_orders 接口。标签标明 requires_api_key=false,与文档中「当前接口无需认证(测试模式)」一致。若你需要完整的商城浏览、地址管理与生成下单链接,同发布者下另有索引条目「蛋糕叔叔商城点单助手」(@user_c70e116b/dgss),能力描述与本文 Skill 不同,安装前请先对照 SkillHub 简介。
官方入口:
- API 页:https://api.skillhub.cn/user_c70e116b/dgss-order
- 社区页:https://www.skillhub.cn/skills/user_c70e116b/dgss-order
核心功能¶
依据 SKILL.md,Agent 在以下意图下应启用本 Skill:
- 用户提到「查订单」「订单查询」「蛋糕订单」「查蛋糕」,或直接给出订单号要求查询。
执行链路固定为四步:
- 从用户话术中提取订单号(文档要求为有效数字)。
- 以 GET 方式请求查询接口。
- 解析 JSON,判断
code是否为200。 - 成功则返回
data中的商品名称;失败则向用户展示msg。
接口约定如下。
请求
GET https://trade.dangaoss.cn/cake_api/ck_orders?order_id={订单号}
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| order_id | string | 是 | 订单号 |
成功响应示例
{
"code": 200,
"msg": "获取成功",
"data": "蓝莓千层拿破仓 Blueberry Mille-feuilles"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 200 表示成功 |
| msg | string | 响应消息 |
| data | string | 蛋糕商品名称 |
安装与启用¶
SkillHub 建议先按 安装说明 准备 skillhub CLI,再用 --dir 指向当前 Agent 实际使用的 skills 目录,否则默认会装到 ./skills/ 而可能不被识别。
- 检查 CLI:
command -v skillhub && skillhub --version
- 安装本 Skill(索引给出的命令):
skillhub install dgss-order --namespace user_c70e116b --dir <你的 skills 目录>
常见客户端 skills 路径(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下的.agents/skills/
也可在 SkillHub 页面将下列提示交给 Agent,由其按安装文档拉取 @user_c70e116b/dgss-order:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_c70e116b/dgss-order`。
安装完成后重启或刷新 Agent,使 SKILL.md 进入技能列表。
典型用法¶
下列对话来自官方 SKILL.md 中的示例,可直接用来验证 Agent 是否按流程工作。
用户: 帮我查一下订单 43
助手: 订单 43 对应的蛋糕是:蓝莓千层拿破仓 Blueberry Mille-feuilles
若用户只说「查蛋糕订单」而未带订单号,Agent 应先追问订单号,再发起请求。文档中的另一条示例:用户提供订单号 88 后,助手返回对应草莓慕斯蛋糕名称。
你也可以在终端手动核对接口(与 Skill 内请求一致):
curl -s "https://trade.dangaoss.cn/cake_api/ck_orders?order_id=43"
适用场景与注意¶
适合谁
- 已在蛋糕叔叔(蛋叔)交易体系内产生订单,需要在对话里快速核对商品名的客服、运营或内部脚本编排场景。
- 希望用标准 Agent Skill(
SKILL.md)约束触发词与 API 调用方式,减少每次重复写 curl 的团队。
限制与注意
- 本包当前只实现「按订单号查商品名」,不等同于 SkillHub 简介中的全品类订购与配送编排;选型时以
SKILL.md为准。 - 文档注明接口处于测试模式、无需认证;若生产环境后续增加鉴权,需要发布者更新 Skill 与你本地的环境配置。
- 订单号无效或业务失败时,应直接展示接口返回的
msg,不要臆造商品名。 - SkillHub 统计(以抓取资料为准):评分 100000,下载 1227,安装 23;社区 Skill 使用前请自行评估接口可用性与合规要求。
结尾¶
「蛋糕叔叔点单」把订单号查询收口成可安装的 Agent Skill:触发词清晰、接口与响应字段在 SKILL.md 中写全,且无需 API Key 即可按文档试通。若你的痛点是福利或烘焙场景下的订单核对,可先按上文命令装入 Cursor 或其他兼容客户端,再用示例订单号走一遍对话与 curl 校验。
更多信息见官方地址:https://www.skillhub.cn/skills/user_c70e116b/dgss-order