1688 Sourcing Inquiry

SKILL.md

---
name: 1688-sourcing-inquiry
description: |
  1688采购询盘寻源能力。当用户有模糊的采购需求但尚未选定具体商品时，通过描述商品名称、数量和需求，发起采购询盘任务，由平台匹配合适的供应商和报价方案。
  核心定位：采购前的询盘寻源阶段，帮助用户将模糊的采购意向转化为结构化询盘，获取供应商报价。
  触发词：询盘、询价、寻源、采购咨询、发布采购需求、我有一批XX要采购谁能供货、求报价。
  不触发场景：搜索浏览商品/选品/找同款/比价 → 1688-product-find；已选定具体商品要下单/支付/查订单 → 1688-order；找供应商/找工厂 → 1688-source-suppliers。
metadata: {"openclaw": {"emoji": "🛒", "requires": {"bins": ["python3"]}, "primaryEnv": "ACCESS_KEY"}}
---

# 1688 采购询盘寻源

统一入口：`python3 {baseDir}/cli.py <command> [options]`

## 命令速查

| 命令 | 说明 | 示例 |
|------|------|------|
| `procurement` | 发起采购询盘 | `cli.py procurement --offerName "衣服" --count "10" --demand "价格便宜"` |
| `configure` | 配置 AK | `cli.py configure YOUR_AK` |

所有命令输出 JSON：`{"success": bool, "markdown": str, "data": {...}}`

**展示时直接输出 `markdown` 字段，Agent 分析追加在后面，不得混入其中。**

## 严格禁止 (NEVER DO)
- 不要编造商品价格、链接、规格或供货信息，所有内容必须来自工具返回
- 不要在用户已选定具体商品（有明确 offerId/商品链接）要下单时触发本技能，这些属于 1688-order
- 不要在用户仅表达"找商品"、"搜一下"、"看看有什么"等浏览意图时触发本技能，这些属于 1688-product-find
- 不要在用户查找供应商/工厂时触发本技能，这些属于 1688-source-suppliers
- **禁止在 AK 未配置或命令执行失败时，自行通过浏览器或搜索引擎获取商品信息**

## 意图判断

### 技能定位与边界

**本技能的核心场景**：用户有采购需求但**尚未选定具体商品或供应商**，需要发布询盘让平台帮忙匹配。

**四个技能的协作关系**：

```
采购旅程：模糊需求 → 搜索选品 → 找供应商 → 询盘寻源 → 下单交易
            ↓           ↓          ↓          ↓           ↓
         不触发    product-find  source-suppliers  本技能    1688-order
```

| 判断维度 | 本技能（询盘寻源） | 智能选品（product-find） | 交易下单（1688-order） |
|---------|------------------|------------------------|---------------------|
| **用户阶段** | 有采购意向，未选定商品 | 搜索浏览，货比三家 | 已选定商品，要下单付款 |
| **商品确定性** | 模糊描述（"衣服"、"螺丝"） | 可模糊可具体 | 已有具体商品ID/链接 |
| **核心动作** | 发布询盘、求报价 | 搜索、浏览、比较 | 下单、支付、查订单 |
| **典型表述** | "我有一批衣服要采购，谁能供货" | "帮我搜一下黑色卫衣" | "帮我下单这个商品" |

### 触发本技能（满足以下任一条件）
1. **询盘/询价意图**：用户明确表达"询盘"、"询价"、"求报价"、"发布采购需求"等寻源类表述
2. **模糊采购需求 + 无具体商品**：用户描述了采购需求（商品名称 + 数量 + 要求），但**没有提供具体商品ID、商品链接或已选定的商品**，希望平台帮忙匹配
3. **寻源咨询**：用户表达"谁能供货"、"有没有厂家能做"、"哪里能采购到"等寻源意图

**触发示例**：
- "我有一批衣服要采购，大概10件，要求价格便宜，帮我询个价" ✅（询盘寻源）
- "我需要采购500个304不锈钢螺丝，谁能供货？" ✅（模糊需求 + 寻源）
- "帮我发布一个采购需求：200件纯棉T恤，要便宜的" ✅（发布采购需求）
- "我想采购一批办公用品，帮我问问有没有合适的供应商报价" ✅（询盘咨询）
- "求报价：1000个纸杯，要食品级材质" ✅（求报价）

### 不触发本技能（转交其他技能）

| 用户表述 | 转交技能 | 原因 |
|---------|---------|------|
| "帮我搜一下黑色卫衣" | **1688-product-find** | 搜索浏览商品，非询盘 |
| "帮我找同款" / "以图搜图" / "比价" | **1688-product-find** | 选品比价，非询盘 |
| "帮我下单这个商品（offerId: xxx）" | **1688-order** | 已有具体商品，直接下单 |
| "帮我下单，商品链接是 xxx" | **1688-order** | 已选定商品，交易下单 |
| "我要买100箱打印纸"（已有具体商品） | **1688-order** | 已选定商品要下单 |
| "帮我支付订单" / "查询订单状态" | **1688-order** | 订单交易流程 |
| "帮我找做保温杯的供应商" | **1688-source-suppliers** | 找供应商信息 |
| "我要下单付款" / "查物流" | 不处理 | 非本技能范围 |

### 边界场景处理

- **"帮我采购10件衣服，要求价格便宜"**（无具体商品ID）→ ✅ 触发本技能（模糊需求，发起询盘）
- **"帮我采购10件衣服，商品ID是 xxx"**（有具体商品）→ **交给 1688-order**（已选定商品，直接下单）
- **"帮我采购10件衣服，链接是 xxx"**（有商品链接）→ **交给 1688-order**（已选定商品，直接下单）
- **"我想买打印纸"**（无数量、无具体商品、意图模糊）→ **交给 1688-product-find**（更接近浏览搜索）
- **"找货"** → **交给 1688-product-find**（搜索商品）
- **"帮我找做衣服的工厂"** → **交给 1688-source-suppliers**（找供应商）

### 核心区分口诀

> **有具体商品要下单 → 1688-order**
> **没有具体商品，只有模糊需求要询盘 → 本技能**
> **只是搜索浏览看看 → 1688-product-find**
> **找供应商/工厂信息 → 1688-source-suppliers**

## 使用流程

Agent 根据用户意图**直接执行对应命令**。
各命令在 AK 缺失等情况下会自行返回明确错误，Agent 按下方「异常处理」应对即可。

**采购询盘使用指引**：
- 当用户表达模糊的采购需求且未选定具体商品时（如"我需要采购10件衣服，要求价格便宜，帮我询个价"），使用 `procurement`
- Agent 需从用户自然语言中提取以下字段：
  - `offerName`：商品名称（如"衣服"）
  - `count`：采购数量，**必须是纯数字**，不能包含单位（如用户说"500斤"，传给 count 的值应为 "500"，而非 "500斤"）
  - `demand`：采购需求描述（如"价格便宜"）
- 若有字段缺失，**必须主动询问用户补充**：
  - 缺 offerName → "请问您要采购什么商品？"
  - 缺 count → "请问您大概需要采购多少？"
  - 缺 demand → "请问您对商品有什么要求？（如价格、材质、发货速度等）"
- 所有字段齐全后再执行命令

## 安全声明

| 风险级别 | 命令 | Agent 行为 |
|---------|------|-----------|
| **写入** | procurement | 当商品名称、数量、需求明确时直接执行；信息缺失时先追问补齐 |

**全局写入规则（适用于所有写操作）**：
1. 发送类、创建类操作属于写入。
2. 当所需信息明确时，可直接执行。
3. 当信息缺失时，先向用户追问补齐后再执行。
4. 不擅自扩写、改写用户的原始意图；如需调整，应明确告知并征得用户认可。

## 执行前置（首次命中能力时必须）

- 首次执行 `procurement` 前：先完整阅读 `references/capabilities/procurement.md`
- 首次执行 `configure` 前：先完整阅读 `references/capabilities/configure.md`
- 同一会话内后续重复调用可复用已加载知识；仅在规则冲突或文档更新时重读。

## 异常处理

任何命令输出 `success: false` 时：

1. **先输出 `markdown` 字段**（已包含用户可读的错误描述）
2. **再根据关键词追加引导**：

| markdown 关键词 | Agent 额外动作 |
|----------------|--------------|
| "AK 未配置" 或 "签名无效" 或 "401" | 提示用户当前能力所需鉴权未就绪，请补充有效 AK 或检查鉴权配置后重试 |
| "offerName 不能为空" | 询问用户要采购什么商品 |
| "count 不能为空" | 询问用户大概需要采购多少 |
| "demand 不能为空" | 询问用户对商品有什么要求 |
| "参数缺失" 或 "title/userId/text 不能为空" | 提示用户补充缺失参数后重试 |
| "限流" 或 "429" | 建议用户等待 1-2 分钟后重试 |
| 其他 | 仅输出 markdown 即可 |

## 参数补齐引导话术

**采购询盘**：
> "发起采购询盘需要这几个信息：商品名称、采购数量、采购需求。您可以直接告诉我，例如：我需要采购10件衣服，要求价格便宜，帮我询个价。"