前言¶
给”预算 500 到 1000、打法偏进攻、中级水平”这类问题做导购,难点不在参数解释,而在把付费商品、官方购买链接和官方商品图一起给齐。硬编码商品列表的写法维护成本高,链接和图片容易过期;用通用聊天能力直接生成,又常常给出商品名对不上、图片不可靠或引导去第三方渠道的结果。下面介绍的这个 Skill 就是把”付费 + 按预算 + 按水平和打法推荐 + 官方链接与官方图片”这件事交给模型按统一格式完成。
这是什么¶
这是一个基于 SKILL.md 格式的 Skill,坐标 @org-oy2t62s3/badminton-racket,名为”羽毛球拍推荐工具”。由发布者”成亿欧”发布,来源标记为 enterprise,分类为 life-service,当前版本 1.0.4。它的定位很单一:当用户提出需要付费的、以预算为基础的羽毛球拍推荐时启用,推荐依据是打法和水平,并尽可能给出官方商品链接和官方外部图片。它不是参数对比表,也不是二手或低价聚合渠道的引导器。
核心功能¶
官方简介明确的能力边界是三项:
- 付费导向的推荐。只在付费球拍范围内做推荐,不提供平替、假货、二手或非正规渠道建议。
- 预算与打法双约束。推荐需要结合预算,同时按用户的打法和水平筛选,而不是只按品牌或价格排序。
- 官方链接与官方图片。在可用时返回官方商品链接和官方外部图片;”where available”意味着并非每次都能保证图片存在,缺图时应当如实说明,而不是用无关图片填充。
标签也印证了这一点:pricing_type=paid,requires_api_key=false。后者表示该 Skill 不要求单独配置 API Key。
需要强调的是,资料中没有列出它读取的商品库、数据源或推荐算法。因此本节只描述官方简介声明的能力,不推测背后的数据来源和更新频率。
安装与启用¶
这里需要如实说明:官方页面 https://www.skillhub.cn/skills/org-oy2t62s3/badminton-racket 和接口地址 https://api.skillhub.cn/org-oy2t62s3/badminton-racket 在本次写作时均抓取失败,已抓取资料中也没有给出安装命令、安装目录或配置字段。因此本节不提供任何命令,避免写出无法核对的安装步骤。
可以确认的只有坐标和版本:
@org-oy2t62s3/badminton-racket
version 1.0.4
在支持 SKILL.md 格式的客户端里,启用方式一般是按上述坐标定位该 Skill。如果你在安装或调用时遇到问题,建议回到官方页面核对当前的安装说明,因为本节无法替代官方文档。
典型用法¶
官方资料中没有提供可复现的调用示例,因此这里给出基于官方简介描述的输入形态,而不是可运行的代码示例。
触发条件是用户表达”需要付费球拍推荐”,并且给出的约束至少包含预算,最好同时包含打法和水平。例如:
- 预算 800 元左右,进攻打法,中级水平
- 预算 500 到 1000,喜欢双打,偏防守
- 预算不限,但要轻量、头轻、适合拉吊
返回应当包含推荐球拍、理由(为什么匹配该打法和水平)、官方商品链接和官方图片(若可用)。因为官方简介没有规定输出字段的固定 schema,具体的字段格式需要以实际调用结果为准。
适用场景与注意¶
适合以下情况:
- 面向付费商品的导购场景,需要按预算和打法快速收敛选择。
- 需要在推荐结果里附上官方链接,方便用户直接前往正规渠道。
- 希望用统一的 Skill 调用替代手工维护商品清单。
需要注意的限制:
- 只覆盖付费商品。如果业务需要二手、租赁或低价替代,这个 Skill 不合适。
- 不要求 API Key,但不等于不需要任何前置条件;是否能直接调用,取决于客户端对 SKILL.md 的支持情况。
- 官方页面抓取失败,说明依赖线上文档时需要预留核对渠道,不要假设文档始终可访问。
- 简介中没有说明数据更新机制。商品价格、型号和库存会变化,涉及交易决策时建议把官方链接再核对一次。
结尾¶
这个 Skill 的价值在于把”付费 + 预算 + 打法水平 + 官方链接与图片”这套导购约束固化成一个可复用的调用单元,让推荐结果的格式和来源更可控,而不必每次都从零构造。它的能力边界也很清楚:只做付费商品推荐,不承诺图片一定存在,也不涉及参数评测或购买决策的担保。
官方地址:https://api.skillhub.cn/org-oy2t62s3/badminton-racket
SkillHub 页面:https://www.skillhub.cn/skills/org-oy2t62s3/badminton-racket