docs(skill): force ckjia-shopping output to include real purchase URL + structured price/platform/history block

This commit is contained in:
matevip 2026-05-03 17:15:59 +08:00
parent 551f2994a0
commit 292da11ead

View File

@ -36,11 +36,36 @@ tags:
2. **附带图片 / 拍照识物**`ckjia_image_recognize(image_url)` → 拿到 `suggested_query` 后再 `ckjia_shopping_recommend(suggested_query)`
3. **transport 健康自检**`ckjia_ping("hello")`,验证 MCP 链路通
## 输出渲染建议
## 输出格式(必须遵守)
每个 ProductCard **必须输出以下信息,缺一不可**——这是用户做购买决策的关键信号:
1. **商品名 + 平台**:用 `[name](url)` markdown 链接形式,**链接必须是 ProductCard.url 字段的真实跳转地址**,否则用户没法点开购买
2. **现价 + 原价**`¥currentPrice`(划掉 `~~原价~~` 如果有 `originalPrice`+ 折扣率 `discountPct`
3. **平台 + 店铺**`[platformLabel] shopName`(用 `platformLabel` 不是 `platformCode`
4. **历史最低价对比**:如果 `lowestPrice``price` 低很多,明确提示"当前比历史最低高 ¥X可以再等等"
5. **purchaseAdvice**:如果有,原样附在卡片末尾
### 推荐输出模板
```markdown
**1. [当日发货 Apple iPhone 17 Pro](https://uland.taobao.com/coupon/edetail?...)**
- 💰 ¥9,999 ~~¥10,999~~ (省 ¥1,0009 折)
- 🛒 淘宝 · {shopName}
- 📊 评分 4.8 · 销量 1.2 万
- 💡 历史最低 ¥9,4992025-12当前略高可观察
```
### 严禁的错误
- ❌ 只列商品名不带链接 / 链接是占位符
- ❌ 只说"在淘宝有售"不给具体跳转 URL
- ❌ 拼接虚构的 URL必须用 `ProductCard.url` 原文)
## 其它字段处理
- `recommendations: ProductCard[]` 在 chat UI 自动渲染成卡片网格(移动端单列、桌面端多列)
- `intent` 字段是给 agent 自己看的"我理解对了吗"——拿到后若 `budgetRange` 与用户原话不符,应主动澄清
- `needsClarification=true` 时,把 `clarificationQuestion` + `clarificationOptions` 直接抛给用户选
- `needsClarification=true` 时,把 `clarificationQuestion` + `clarificationOptions` 直接抛给用户选,不要硬猜
## 注意