前言¶
在对话里点一杯外带咖啡，常见做法是打开 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。
