蛋糕叔叔點單:用 Agent 按訂單號查詢蛋糕商品

前言

在企業福利或烘焙電商場景裏,客服、運營或內部工具經常要根據訂單號確認「這筆單對應哪款蛋糕」。如果每次都在瀏覽器裏翻後臺,或臨時查接口文檔再手寫請求,對話式 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:

  • 用戶提到「查訂單」「訂單查詢」「蛋糕訂單」「查蛋糕」,或直接給出訂單號要求查詢。

執行鏈路固定爲四步:

  1. 從用戶話術中提取訂單號(文檔要求爲有效數字)。
  2. 以 GET 方式請求查詢接口。
  3. 解析 JSON,判斷 code 是否爲 200。
  4. 成功則返回 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/ 而可能不被識別。

  1. 檢查 CLI:
command -v skillhub && skillhub --version
  1. 安裝本 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜