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