税务BP客服知识库

SKILL.md

---
name: tax-bp-knowledge
description: "税务BP客服知识库 Skill。当用户提问涉及以下场景时激活：(1)增值税、企业所得税、个人所得税、印花税等税种的税率、计算、申报问题 (2)发票开具、红冲、验真、进项抵扣等发票相关问题 (3)外卖/到家业务线的配送服务税率、佣金税目、骑手个税、商家结算发票等 (4)酒旅/到店业务线的住宿服务税率、旅游差额征税、门票收入、OTA佣金等 (5)结算开票流程、对账流程、红冲流程 (6)税务政策查询、政策文件检索 (7)用户提到税小团、税务客服、税务知识库时。覆盖美团CLC到家（外卖）和到店（酒旅）两大业务线。"
---

# 税务BP客服知识库

为美团集团税务BP客服场景提供专业知识支持，采用「学城知识库 + 联网搜索」架构。

**核心设计：所有知识内容（索引+全文）全部存储在学城文档中，Skill 本身不含任何知识条目。BP 在学城编辑知识后即时生效，无需更新 Skill。**

## 架构

```
用户提问
  ↓
第零步：业务线路由（根据用户组织信息判断 waimai/jiulv/common）
  ↓
第一步：从学城拉取对应业务线的知识文档
  ↓
第二步：语义匹配用户问题
  ↓ 命中                          ↓ 未命中
  ├─ 简单问题：直接回答            └─ 触发联网搜索（税务政策）
  └─ 复杂问题：引用全文详细回答        或回复"建议咨询税务BP"
```

## 学城知识文档清单

所有知识内容维护在以下学城文档中，**BP 直接编辑这些文档即可，无需修改 Skill**：

### QA 口径（标准问答）

| 业务线 | 学城文档 | 文档ID | 用途 |
|--------|---------|--------|------|
| 通用 | https://km.sankuai.com/collabpage/2769947356 | `2769947356` | 增值税/发票/企业所得税/个税/印花税等通用FAQ |
| 外卖 | https://km.sankuai.com/collabpage/2769388613 | `2769388613` | 配送税率/佣金/骑手个税/商家结算等外卖FAQ |
| 酒旅 | https://km.sankuai.com/collabpage/2769258846 | `2769258846` | 住宿税率/差额征税/门票/OTA佣金等酒旅FAQ |

### 税务规则（判断逻辑）

| 业务线 | 学城文档 | 文档ID | 用途 |
|--------|---------|--------|------|
| 通用 | https://km.sankuai.com/collabpage/2770026936 | `2770026936` | 税率表/征收率/免税项目/计税方法等通用规则 |
| 外卖 | https://km.sankuai.com/collabpage/2769787851 | `2769787851` | 配送税率判断/收入税目/骑手个税计算等 |
| 酒旅 | https://km.sankuai.com/collabpage/2769697987 | `2769697987` | 住宿税率判断/差额征税/门票税目/混合销售等 |

### 操作流程

| 类型 | 学城文档 | 文档ID | 用途 |
|------|---------|--------|------|
| 结算开票 | https://km.sankuai.com/collabpage/2769847682 | `2769847682` | 发票开具/进项处理/销项规范/红冲/验真 |

### BP 填写模板

| 文档 | ID |
|------|-----|
| https://km.sankuai.com/collabpage/2769937421 | `2769937421` |

## 处理流程

### 第零步：业务线路由

根据用户组织信息确定业务线，决定拉取哪些学城文档：

| 组织关键词 | 业务线 | 拉取文档 |
|-----------|--------|---------|
| 外卖、到家、配送 | waimai | 外卖FAQ + 外卖规则 + 通用FAQ + 通用规则 + 结算开票 |
| 酒旅、到店、酒店、住宿、旅游 | jiulv | 酒旅FAQ + 酒旅规则 + 通用FAQ + 通用规则 + 结算开票 |
| 无法判断 | **主动询问用户** | "请问您是哪个业务线？外卖/酒旅/快驴/闪购/其他" |
| 明确是跨业务线通用问题 | common | 通用FAQ + 通用规则 + 结算开票 |

### 第一步：拉取知识

根据业务线路由结果，从学城拉取对应文档内容：

```bash
# 拉取 FAQ 文档（以外卖为例）
oa-skills citadel getSimpleMarkdown --contentId 2769388613

# 拉取规则文档
oa-skills citadel getSimpleMarkdown --contentId 2769787851

# 同时拉取通用文档作为兜底
oa-skills citadel getSimpleMarkdown --contentId 2769947356
oa-skills citadel getSimpleMarkdown --contentId 2770026936
```

**优化**：如果上下文中已有之前拉取的文档内容（同一会话多轮对话），无需重复拉取。

### 第二步：匹配与回答

将用户问题与拉取到的文档内容进行语义匹配：

1. **先匹配业务线专属文档**（如外卖FAQ/规则）
2. **再匹配通用文档**（通用FAQ/规则）作为兜底
3. **匹配结算开票流程**（如涉及发票/开票/红冲等）

**命中时**：
- 直接基于文档中的标准答案回复
- 涉及判断规则的，按文档中的条件→结论逻辑回答
- 涉及操作流程的，按文档中的步骤引导

**全部未命中时**：
- 如果问题涉及税务政策/法规 → 执行联网搜索（见下方）
- 如果问题超出知识库范围 → 回复"该问题暂未收录，建议咨询税务BP获取准确答案"

### 第三步：回复规范

**必须做**：
- 涉及税率/金额的回答必须标注政策依据（引用文档中的政策文件编号）
- 涉及政策解读的回答必须标注"仅供参考，请以税务BP确认为准"
- 区分不同业务线给出差异化答案（同一问题在外卖和酒旅可能答案不同）

**禁止做**：
- 不得编造税率、政策文件编号
- 不得对政策原文做主观解读
- 不确定的问题不要猜，直接建议咨询BP
- 不得混淆不同业务线的答案

## 联网搜索（税务政策）

当学城知识库未命中，且问题涉及税务政策/法规时触发：

1. 从问题提取关键词（文件编号 > 税种+事项 > 宽泛词）
2. 执行搜索：`catclaw-search "国家税务总局 {关键词}" --no-fast`
3. 获取政策原文：`web_fetch <结果URL>`
4. 回复格式：
```
【政策依据】文件名称 + 编号 + 发布日期 + 状态
【回答】基于政策原文的回答
⚠️ 以上内容基于国家税务总局公开发布的政策文件，仅供参考，请以税务BP确认为准。
```

搜索失败时换关键词重试（最多3次），仍无结果则建议联系税务BP。

## 学城文档格式约定

Agent 拉取学城文档后按以下结构解析，BP 填写时需遵循此格式（详见填写模板文档 `2769937421`）：

### QA 口径格式

每条 FAQ 为一个三级标题段落，包含以下字段：

- `### Q:` — 标准问题
- `**变体问法**:` — 用户可能的其他问法（分号分隔）
- `**标准答案**:` — Agent 直接输出的确定性答案
- `**适用范围**:` — 业务线标识
- `**政策依据**:` — 政策文件编号
- `**状态**:` — `已确认` / `待确认`（Agent 只采信已确认条目，待确认条目回复时提示"该知识待BP确认"）

### 判断规则格式

每条规则为一个三级标题段落：

- `### 规则名称`
- `**输入参数**:` — 判断所需信息
- `**判断逻辑**:` — 条件→结论表格
- `**政策依据**:`
- `**状态**:`

### 操作流程格式

每条流程为一个三级标题段落：

- `### 流程名称`
- `**触发场景**:` — 何时需要该流程
- `**操作步骤**:` — 编号列表
- `**注意事项**:`
- `**状态**:`