前言¶
在對話裏點一杯外帶咖啡，常見做法是打開 App 自己搜門店、選規格、湊優惠再支付。步驟多，也容易在價格和優惠券上點錯。若希望 Agent 按流程幫你查附近門店、搜商品、預覽價格並走完自提下單，需要一套對接瑞幸業務接口、且帶下單校驗的 Skill，而不是泛泛的「幫我點咖啡」提示詞。
下面介紹 SkillHub 上的 瑞幸咖啡.skill（座標 @lukincoffee/my-coffee），由瑞幸咖啡發佈，面向「門店 → 商品 → 下單 → 支付 → 訂單」的完整鏈路。
這是什麼¶
瑞幸咖啡.skill（My Coffee）是一款瑞幸咖啡智能下單 Skill，基於通用 SKILL.md 格式，在 SkillHub 分類爲 life-service，來源標註爲 enterprise，當前頁面版本爲 v0.8.4。
它解決的是：讓支持 Skills 的 AI 客戶端，在具備合法憑證的前提下，調用瑞幸側能力完成門店查詢、商品搜索、自提下單、支付、訂單狀態查詢與取消訂單，並在流程中做價格預覽、優惠券透傳、Token 安全與下單流程校驗。
官方入口：
- API 元數據：
https://api.skillhub.cn/lukincoffee/my-coffee - SkillHub 頁面：
https://www.skillhub.cn/skills/lukincoffee/my-coffee
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面說明，未單獨列出的接口名不作展開。
- 門店查詢：按場景查找可用門店，爲自提下單選點。
- 商品搜索：在選定門店或業務上下文中檢索飲品與規格。
- 自提下單：走自提鏈路創建訂單（非泛泛的「推薦一杯」）。
- 支付：銜接支付環節，與下單流程一併由 Skill 約束。
- 訂單狀態查詢與取消：下單後可查狀態，必要時取消訂單。
- 流程內建能力：價格預覽、優惠券透傳、Token 安全、下單流程校驗，用於減少漏步、誤價或未完成支付就以爲下單成功的情況。
SkillHub 標籤包含 requires_api_key=true，表示啓用前需要配置 API Key（或等價憑證）；具體字段名與獲取方式以安裝後 Skill 包內 SKILL.md 及瑞幸側說明爲準，本文不臆造配置項。
安裝與啓用¶
官方頁面給出的安裝提示是：讓 AI 按 SkillHub 安裝文檔處理座標 @lukincoffee/my-coffee。文檔地址爲 https://skillhub.cn/install/skillhub.md。
1、確認 skillhub CLI¶
先檢查本機是否已有 CLI：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝到當前 Agent 的 skills 目錄¶
SkillHub 文檔要求：安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認裝到 ./skills/ 可能不會被加載。
skillhub install @lukincoffee/my-coffee --dir <skills 目錄>
常用客戶端路徑（摘自 SkillHub 安裝文檔，按你實際使用的客戶端擇一）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安裝完成後，按各客戶端要求重啓或刷新 Skills，並按要求配置 API Key（requires_api_key=true）。
也可直接向 AI 發送官方頁面同款提示（便於在對話裏完成安裝）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@lukincoffee/my-coffee`。
典型用法¶
官方資料未附帶逐步對話腳本，典型用法應圍繞已聲明的能力，用自然語言驅動流程，由 Skill 執行校驗與接口調用。可參考下列順序（表述可按習慣調整，邏輯需覆蓋門店與自提）：
- 選門店：說明大致位置或門店名，請求查詢附近可自提門店並確認一家。
- 選商品：給出飲品名、規格（如溫度、糖度、杯型），請求搜索並展示價格預覽。
- 優惠：若有可用優惠券，說明希望使用的券或讓 Agent 在透傳規則下選用。
- 下單與支付：確認自提時間與門店後，請求創建訂單並完成支付；未收到支付成功或訂單號前，不要當作已下單。
- 售後：用訂單查詢確認狀態；需要時用取消訂單能力處理未取餐訂單。
經過上面的步驟，Agent 應依賴 Skill 內的下單流程校驗，而不是跳過支付或門店步驟。
適用場景與注意¶
適合誰
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills，且能配置 API Key 的開發者或重度用戶。
- 希望把「查門店 → 搜商品 → 自提下單 → 查單/取消」收攏到對話裏，並依賴企業側 Skill 做流程約束的場景。
限制與注意
- 能力邊界以官方簡介爲準：自提下單與支付相關，不涉及未聲明的配送或其他渠道。
- 必須滿足
requires_api_key=true的憑證要求；無 Key 時不應假設能調用瑞幸接口。 - SkillHub 頁面展示的評分爲 100000，下載 4967（抓取時點數據，以頁面實時爲準）；選用前可在 SkillHub 查看版本與說明是否更新。
- 涉及真實支付與個人信息，建議在測試門店或小單驗證流程後再日常使用。
結尾¶
瑞幸咖啡.skill 把瑞幸 My Coffee 的門店、商品、自提下單、支付與訂單管理封裝成企業來源的 life-service Skill，並強調價格預覽、優惠券透傳與下單校驗。若你正在 SkillHub 上找可落地的「對話點咖啡」能力，可從官方頁面查看說明並安裝 @lukincoffee/my-coffee：https://www.skillhub.cn/skills/lukincoffee/my-coffee。
