支付宝租赁行业知识技能

快速导航

关键参考文档：

• [关键词映射表](references/keyword-mapping.md) - 识别知识领域和查询类型
• [知识来源索引](references/rent-knowledge-sources.md) - 文档列表和链接

概述

本技能包专门为支付宝租赁平台设计，提供租赁行业知识的检索问答服务。

核心特点：

• 所有文档从本地读取（无远端访问能力）
• 文档库位于 ${WORKSPACEDIR}/租赁行业知识/ 目录
• 自动检测文档完整性并提示更新
• 智能区分产品知识和技术知识输出格式

⚠️ 系统要求：

• 操作系统：仅支持 macOS 和 Linux，不支持 Windows
• 原因：脚本使用了 Unix 特有的功能（如进程组管理、信号处理、shell 命令等）

⚠️ 工作空间说明：本技能所有操作均基于 ${WORKSPACEDIR}（即 pwd 的位置），所有文档、日志、JSON 文件都存放在 ${WORKSPACEDIR}/租赁行业知识/ 目录下。

⚠️ 前置准备：目录变量定义

重要：由于 Claude Code 的所有工具路径均相对解析，需要在执行任何操作前先定义工作空间目录和技能目录。

在执行任何模块前，必须先定义以下目录变量：

# 定义工作空间目录（当前 pwd 位置）
WORK_SPACE_DIR="$(pwd)"

# 定义技能目录（先搜工作空间，再搜全局安装目录）
_found_skill=$(find "${WORK_SPACE_DIR}" -name "SKILL.md" -path "*/.*/skills/alipay-rental-knowledge-base/*" 2>/dev/null | head -1)
if [ -z "$_found_skill" ]; then
  _found_skill=$(find "$HOME" -maxdepth 5 -name "SKILL.md" -path "*/.*/skills/alipay-rental-knowledge-base/*" 2>/dev/null | head -1)
fi
if [ -n "$_found_skill" ]; then
  SKILL_DIR=$(dirname "$_found_skill")
else
  SKILL_DIR="./skills/alipay-rental-knowledge-base"
fi

echo "工作空间: ${WORK_SPACE_DIR}"
echo "技能目录: ${SKILL_DIR}"

路径说明：

后续所有相对路径基于这两个变量：
- 技能文件路径：${SKILL_DIR}/...
- 知识库文件路径：${WORKSPACEDIR}/租赁行业知识/...

⚠️ 核心处理流程（强制执行）

重要声明：以下 6 个模块必须按顺序完整执行，不可跳过任何步骤。每个步骤都有对应的检查点和必须输出，确保流程完整性。任何输出前必须确认已完成所有 6 个模块。

流程执行追踪表

在处理每个用户请求时，都必须严格按 1→2→3→4→5→6 的流程顺序执行，必须依次完成以下检查点。在内部处理过程中追踪每个步骤的完成状态，所有检查项必须全部完成才能输出最终结果：

流程执行原则（强制遵守）

1. 顺序执行：每一次问答，都必须严格按 1→2→3→4→5→6 的顺序执行，禁止跳跃执行，禁止不同模块之间并行执行；摈弃历史记忆，每次问答都必须从头开始执行。
2. 完整执行：每个模块内的所有检查项或步骤都必须执行完毕，禁止省略任何检查项，禁止私自臆想执行流程，禁止猜测执行路径
3. 验证通过：前一模块的所有检查项完成后，才能进入下一模块
4. 拒绝跳过：即使某些步骤看似"不重要"，也必须执行并记录结果
5. 输出验证：最终输出前，必须确认 6 个模块全部完成
6. 模块隔离：模块2仅负责检查，模块3仅负责下载，禁止混淆职责

流程全景图

┌─────────────────────────────────┐
│  模块1: 用户意图分析（必须执行）   │
│  → 输出: 领域 + 类型              │
└──────────────┬──────────────────┘
               ▼
┌─────────────────────────────────┐
│  模块2: 本地文档检查（必须执行）   │
│  → 输出: 检查结果表格 + 待下载列表 │
└──────────────┬──────────────────┘
               ▼
┌─────────────────────────────────┐
│  模块3: 文档下载（必须执行）       │
│  → 输出: 下载结果 或 确认无需下载  │
│  若无需下载则确认后通过            │
└──────────────┬──────────────────┘
               ▼
┌─────────────────────────────────┐
│  模块4: 本地知识检索（必须执行）   │
│  → 输出: 文档列表 + 内容          │
└──────────────┬──────────────────┘
               ▼
┌─────────────────────────────────┐
│  模块5: 智能知识整理（必须执行）   │
│  → 输出: 结构化回答内容           │
└──────────────┬──────────────────┘
               ▼
┌─────────────────────────────────┐
│  模块6: 结果输出（必须执行）       │
│  → 输出: 完整回答 + 参考表 + 支持  │
└─────────────────────────────────┘

关键依赖说明：

• 模块2 → 模块3：模块2输出待下载列表，模块3负责执行下载
• 模块3 → 模块4：若模块3触发下载，必须等待下载完成后才能进入模块4
• 禁止跳过模块3直接进入模块4

模块一：用户意图分析（必须执行）

检查点：此模块必须完成以下 3 项检查后才能进入下一模块
- ☐ 已识别知识领域
- ☐ 已确定查询类型
- ☐ （可选）意图不明确时已使用 AskUserQuestion 澄清

Step 0: 检查用户自定义 URL（优先处理）

当用户主动提供 URL 时，优先按此流程处理：

1. 检查 URL 是否在知识来源中

- 读取 ${SKILL_DIR}/references/rent-knowledge-sources.md - 检查用户提供的 URL 是否已存在于文档列表中

1. 根据检查结果执行下载

- 如果 URL 已存在：按正常流程更新下载该文档 - 如果 URL 不存在： - 语雀 URL 使用 fetchyuque.py 下载 - 支付宝 URL 使用 fetchalipay.py 下载 - 下载完成后继续按用户意图执行后续流程

1. 内容分析优先级

- 用户主动提供的 URL 内容为主要参考 - 本地其他文档为次要参考 - 输出时优先引用用户指定的 URL 文档

URL 识别规则：

示例流程：

用户输入：帮我分析 https://opendocs.alipay.com/solution/xxx 这个接口

Step 0 处理：
1. 检查 URL 是否在 rent-knowledge-sources.md 中
2. 如果不存在，使用 fetch_alipay.py 下载
3. 下载完成后，以该文档内容为主进行分析
4. 补充引用其他相关文档作为次要参考

Step 1: 识别查询领域

根据用户输入的关键词，匹配知识领域。完整关键词映射表请参考 [keyword-mapping.md](references/keyword-mapping.md)。

常用领域快速识别：

Step 2: 确定查询类型

接口类问题优先级规则：技术接口类问题优先查询支付宝开放平台文档，语雀文档作为补充。

Step 3: 意图确认（可选）

意图不明确时使用 AskUserQuestion 澄清。

模块二：本地文档检查（必须执行）

职责：检查本地文档完整性和时效性，生成 doccheckresult.json 文件。

详细步骤、依赖检查脚本说明请参考 [workflow-guide.md](references/workflow-guide.md#模块二本地文档检查必须执行)

检查点：
- ☐ 已执行依赖安装脚本 install_dependencies.sh
- ☐ 已向用户展示依赖检查和安装结果
- ☐ 已执行 createdoclist.py 脚本
- ☐ 已向用户展示脚本完整输出
- ☐ 已执行 check_docs.py 脚本
- ☐ 已向用户展示检查结果表格和待下载列表
- ☐ 已生成 doccheckresult.json 文件
- ☐ 禁止调用下载器（下载由模块三负责）

必须产出：${WORKSPACEDIR}/租赁行业知识/doccheckresult.json 文件

核心步骤概览

执行顺序：Step 0（依赖检查）→ Step 1（定义变量）→ Step 2/3（根据模式选择）

Step 2: 创建初始文档列表

python3 -u "${SKILL_DIR}/scripts/create_doc_list.py" \
  --source "${SKILL_DIR}/references/rent-knowledge-sources.md" \
  --output "${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json"

Step 3: 运行文档检查脚本

python3 -u "${SKILL_DIR}/scripts/check_docs.py" \
  --input "${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json" \
  --output "${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json"

刷新全部文档模式：在上述两个命令末尾添加 --seconds 0 参数。详细说明见 [workflow-guide.md](references/workflow-guide.md#模块二本地文档检查必须执行)中的 「Step 2 和 Step 3 根据模式选择执行方式」中的 刷新全部文档模式 部分

关键字段

模块完成判定

模块三：文档下载（必须执行）

职责：读取 doccheckresult.json，执行下载/更新，更新 JSON 文件中的 download_status。

详细步骤、用户交互流程请参考 [workflow-guide.md](references/workflow-guide.md#模块三文档下载必须执行)

前置条件：模块二已生成 ${WORKSPACEDIR}/租赁行业知识/doccheckresult.json

⚠️ 禁止事项（违反则流程无效）：
- ❌ 禁止根据用户问题判断"相关文档已存在"而跳过下载
- ❌ 禁止根据用户问题关键词选择性下载部分文档
- ❌ 禁止跳过任何 download_status = false 的文档

检查点：
- ☐ 已读取 doccheckresult.json 文件，确认待下载文档数量
- ☐ 待下载数量 > 0 时，必须执行下载脚本，不可跳过
- ☐ 已执行下载脚本并向用户展示完整下载过程
- ☐ 已向用户展示下载结果汇总
- ☐ 验证所有 download_status = true 或用户确认继续

必须产出：更新后的 ${WORKSPACEDIR}/租赁行业知识/doccheckresult.json

核心步骤

# Step 1: 定义目录变量
WORK_SPACE_DIR="$(pwd)"
_found_skill=$(find "${WORK_SPACE_DIR}" -name "SKILL.md" -path "*/.*/skills/alipay-rental-knowledge-base/*" 2>/dev/null | head -1)
if [ -z "$_found_skill" ]; then
  _found_skill=$(find "$HOME" -maxdepth 5 -name "SKILL.md" -path "*/.*/skills/alipay-rental-knowledge-base/*" 2>/dev/null | head -1)
fi
if [ -n "$_found_skill" ]; then
  SKILL_DIR=$(dirname "$_found_skill")
else
  SKILL_DIR="./skills/alipay-rental-knowledge-base"
fi

# Step 2: 执行下载（使用 -u 参数禁用缓冲，确保输出实时显示）
python3 -u "${SKILL_DIR}/scripts/download_docs.py" \
  --input "${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json" \
  --output "${WORK_SPACE_DIR}/租赁行业知识" \
  --workers 5

提示：刷新全部文档场景已在模块二说明，模块三会自动下载所有 download_status = false 的文档。

模块完成判定

模块四：本地知识检索（必须执行）

职责：验证文档下载状态，从本地文档中检索与用户问题相关的内容。

详细执行步骤、检索策略、脚本命令请参考 [workflow-guide.md](references/workflow-guide.md#模块四本地知识检索必须执行)

前置条件：模块三已完成，doccheckresult.json 已更新

检查点：
- ☐ 已验证 doccheckresult.json 中所有 download_status = true
- ☐ 已输出文档状态汇总（源文档总数、本地已就绪、未就绪/失败）
- ☐ 已执行多策略并行检索（Glob + Grep）
- ☐ 已读取命中文档内容
- ☐ 已验证内容与用户问题的相关性

必须产出：检索到的文档列表 + 文档内容

核心步骤概览

1. 验证文档状态：检查 doccheckresult.json，输出文档状态汇总
2. 定义检索目录：设置 KNOWLEDGEDIR、YUQUEDIR、ALIPAY_DIR 变量
3. 多策略并行检索：文件名检索 + 全文关键词检索 + 分目录检索
4. 检索结果合并：去重、按相关性排序
5. 内容提取验证：读取命中文档，验证相关性

模块五：智能知识整理（必须执行）

前置条件：模块四已完成

检查点：此模块必须完成后才能进入模块六
- ☐ 已根据查询类型选择对应的输出格式（产品知识/技术知识/接入指南/规则说明/问题解决）
- ☐ 已提取关键信息并结构化整理

必须产出：结构化的回答内容

产品知识整理（归纳格式）

适用于：功能介绍、产品说明、业务规则

## 核心概念
[一句话概括产品是什么]

## 主要功能
1. **功能A**：[说明]
2. **功能B**：[说明]

## 应用场景
- 场景1：[说明]
- 场景2：[说明]

## 使用条件
- [条件1]
- [条件2]

技术知识整理（参数表格格式）

适用于：API接口、技术文档、接口参数

## 接口说明
**接口名称**：xxx
**接口地址**：xxx
**请求方式**：POST/GET

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| param1 | String | 是 | 参数说明 |
| param2 | Integer | 否 | 参数说明 |

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| code | Integer | 响应码 |
| msg | String | 响应信息 |
| data | Object | 业务数据 |

## 请求示例
\`\`\`json
{
  "param1": "value1"
}
\`\`\`

## 响应示例
\`\`\`json
{
  "code": 200,
  "msg": "success"
}
\`\`\`

模块六：结果输出（必须执行）

前置条件：模块五已完成

检查点：此模块必须完成以下 3 项检查后才能输出最终结果
- ☐ 已验证回答内容有据可依（每个要点都能在文档中找到来源）
- ☐ 已添加「详细参考」表格（包含序号、文档标题、引用位置）
- ☐ 已添加技术支持提示（b站助理小智链接）

必须产出：完整的最终回答（主体内容 + 参考表格 + 技术支持提示）

⚠️ 流程完整性最终验证：在输出前，确认以下 6 个模块全部完成：
- ☐ 模块1: 用户意图分析 → 已识别领域和类型
- ☐ 模块2: 本地文档检查 → 已执行检查并输出待下载列表
- ☐ 模块3: 文档下载 → 已完成下载并验证日志（或用户拒绝）
- ☐ 模块4: 本地知识检索 → 已检索文档
- ☐ 模块5: 智能知识整理 → 已结构化内容
- ☐ 模块6: 结果输出 → 准备输出

Step 0: 结果验证（必须执行）

在输出结果之前，必须验证回答内容与参考文档的关联性：

验证流程

回答内容构建完成
       ↓
逐条验证每个回答要点
       ↓
在参考文档中查找对应依据
       ↓
┌──────────────────┐
│ 是否找到依据？    │
└────────┬─────────┘
    是 ↓      ↓ 否
  保留内容    剔除内容
       ↓
┌──────────────────┐
│ 是否有任意内容？  │
└────────┬─────────┘
    是 ↓      ↓ 否
  正常输出    未找到答案

验证规则

验证方法

对于每个回答要点：
1. 定位其在参考文档中的来源
2. 确认内容与文档描述一致
3. 记录引用位置（章节/行号）

若无法定位来源：
→ 该内容不可信，必须剔除

验证失败处理

若验证后无任何有效内容：

使用 AskUserQuestion 询问用户：

AskUserQuestion(
  questions: [{
    question: "未在当前知识库中找到相关内容。可能原因：文档缺失或流程未完整执行。是否重新执行完整流程？",
    header: "未找到答案",
    options: [
      { label: "重新执行完整流程", description: "从模块1开始重新执行，确保下载完整文档" },
      { label: "查看其他渠道", description: "前往语雀或支付宝开放平台搜索" }
    ]
  }]
)

用户选择处理：

查看其他渠道的输出：

建议您：
1. 前往租赁行业知识空间搜索：https://xfpzl.yuque.com
2. 前往支付宝开放平台搜索：https://opendocs.alipay.com/solution/0h845w
3. 联系[技术支持](opensupport.alipay.com/support/home)或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)

Step 1: 输出格式（必须执行）

所有输出必须在末尾以表格形式列出远端参考链接，并提供技术支持渠道：

## [问题主题]

[回答内容]

---
**详细参考**

| 序号 | 文档标题 | 引用位置 |
| --- | --- | --- |
| 1 | [文档标题](https://xxx) | 第X.X.X 章节标题（约第X-X行） |

💡 **如需进一步帮助，请联系[技术支持](opensupport.alipay.com/support/home)或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)**

多个参考链接（按权重排序）

多个文档时，按引用权重排序（引用内容最多的或最重要的排在最前面）：

---
**详细参考**

| 序号 | 文档标题 | 引用位置 |
| --- | --- | --- |
| 1 | [租赁行业交易接入指南](https://xfpzl.yuque.com/dgw58m/apg2ie/krlamdgkonw48d6v) | 第3.2 接入流程（约第20-45行） |
| 2 | [租赁交易API](https://opendocs.alipay.com/solution/0h845z?pathHash=a06d35e3) | 约第15-25行 |

💡 **如需进一步帮助，请联系[技术支持](opensupport.alipay.com/support/home)或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)**

单个参考链接

---
**详细参考**

| 序号 | 文档标题 | 引用位置 |
| --- | --- | --- |
| 1 | [租安盾使用指南](https://xfpzl.yuque.com/dgw58m/apg2ie/vp5nb9qrl8ksoqvx) | 第2.1 产品概述（约第10-20行） |

💡 **如需进一步帮助，请联系[技术支持](opensupport.alipay.com/support/home)持或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)**

无法精确定位时

当无法准确定位到具体章节或行号时，不要提供错误或误导性的位置信息：

---
**详细参考**

| 序号 | 文档标题 | 引用位置 |
| --- | --- | --- |
| 1 | [租赁行业交易接入指南](https://xfpzl.yuque.com/dgw58m/apg2ie/krlamdgkonw48d6v) | 参考全文 |
| 2 | [租赁交易API](https://opendocs.alipay.com/solution/0h845z?pathHash=a06d35e3) | 参考相关章节 |

💡 **如需进一步帮助，请联系[技术支持](opensupport.alipay.com/support/home)或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)**

未找到答案时的输出

⚠️ 重要：未找到答案时，必须使用 AskUserQuestion 询问用户是否重新执行完整流程，禁止直接输出"暂无该知识"就结束。

使用 AskUserQuestion 询问用户：

AskUserQuestion(
  questions: [{
    question: "未在当前知识库中找到相关内容。可能原因：文档缺失或流程未完整执行。是否重新执行完整流程？",
    header: "未找到答案",
    options: [
      { label: "重新执行完整流程", description: "从模块1开始重新执行，确保下载完整文档" },
      { label: "查看其他渠道", description: "前往语雀或支付宝开放平台搜索" }
    ]
  }]
)

用户选择"重新执行完整流程"后：从模块1开始重新执行所有6个模块。

用户选择"查看其他渠道"后：

建议您：
1. 前往租赁行业知识空间搜索：https://xfpzl.yuque.com
2. 前往支付宝开放平台搜索：https://opendocs.alipay.com/solution/0h845w?pathHash=619f4f15
3. 联系[技术支持](opensupport.alipay.com/support/home)或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)

标题来源

从 ${SKILL_DIR}/references/rent-knowledge-sources.md 表格中的"标题"列获取文档标题。

排序规则

引用多个文档时，按以下权重降序排列：

1. 核心文档优先：直接回答问题的文档排在前面
2. 引用量优先：引用内容越多的文档排在前面
3. 重要性优先：官方规范、接入指南等核心文档优先于示例、FAQ等辅助文档

完整工作流程示例

示例：产品功能查询（文档完整）

用户输入：租安盾是什么？有什么功能？

【模块1: 用户意图分析】
- 领域=租安盾, 类型=产品知识 → ☑ 完成

【模块2: 本地文档检查】
- 检查结果：所有文档存在 → ☑ 完成，待下载列表为空

【模块3: 文档下载】
- 无待下载文档 → ☑ 完成，无需下载

【模块4: 本地知识检索】
- 检索：Glob("**/*租安盾*") + Grep("租安盾")
- 读取：《租安盾使用指南》 → ☑ 完成

【模块5: 智能知识整理】
- 格式：产品知识归纳格式 → ☑ 完成

【模块6: 结果输出】
- 验证依据 + 参考表格 + 技术支持 → ☑ 完成

更多示例：文档缺失处理、下载验证失败等场景的详细示例请参考 [workflow-guide.md](references/workflow-guide.md)。

Error handling

Output rules（输出规则）

流程完整性规则（最高优先级）

1. 流程完整性要求：所有输出必须确认已完整执行 6 个模块的流程

- 禁止跳过任何模块 - 禁止跳过模块内的任何检查项 - 输出前必须在内部确认：6 个模块全部完成

内容输出规则

1. 始终使用中文输出
2. 产品知识采用归纳整理格式（要点列表）
3. 技术知识采用接口参数表格格式
4. 所有输出末尾必须以表格形式列出远端参考链接
5. 表格格式：序号列 + 文档标题（含链接）列 + 引用位置列
6. 标题来源：rent-knowledge-sources.md 表格的"标题"列
7. 引用位置格式（必须精准，禁止误导）：

- 有章节/标题的文档：第X.X.X 章节标题（约第X-X行） - 无章节/标题的文档：约第X-X行 - 无法精确定位时：直接显示 参考全文 或 参考相关章节 - ⚠️ 严禁提供非关联位置或错误位置，这会产生严重误导

1. 多个文档按权重排序：核心文档优先、引用量优先、重要性优先
2. 接口类问题优先级：技术接口类问题（API、参数、字段等）优先查询和引用支付宝开放平台文档，语雀文档作为补充
3. 所有输出末尾必须包含技术支持提示："如需进一步帮助，请联系[技术支持](opensupport.alipay.com/support/home)或 b站助理小智"
4. 如本地文档缺失或过期，优先提示用户更新
5. 明确说明"所有文档从本地读取，无远端访问能力"
6. 前端 JSAPI 接口（my.tradePay、my.checkBeforeAddOrder）采用特殊处理：简要说明用途后引导用户访问原文查看完整文档

前端接口特殊处理

前端 JSAPI 接口列表

以下接口为前端 JSAPI 接口，涉及小程序端调用，文档包含大量交互示例、效果演示等内容，建议用户直接访问原页面查看：

处理规则

当用户咨询上述接口或回答内容引用了这些接口时：

1. 简要说明接口用途：用 1-2 句话概括接口功能
2. 引导用户访问原文：提供原文链接，说明原文包含完整的代码示例、效果演示和交互说明
3. 输出格式示例：

**my.tradePay** 是支付宝小程序端发起支付的接口，支持 JSAPI 支付和预授权支付两种模式。

由于该接口涉及前端交互、收银台唤起、回调处理等内容，文档包含大量代码示例和效果演示，建议您直接访问原文查看完整说明：

👉 [my.tradePay 接口文档](https://opendocs.alipay.com/solution/b934d23a_my.tradePay?pathHash=dc58408e)

---

💡 **如需进一步帮助，请联系技术支持或 [b站助理小智](https://b.alipay.com/page/recycle-im/home)**

触发条件

满足以下任一条件时，应用此规则：

• 用户明确询问 my.tradePay 或 my.checkBeforeAddOrder 接口
• 回答内容需要引用这两个接口的文档
• 用户询问"小程序支付"、"前端支付"、"预授权支付"等与 my.tradePay 相关的问题
• 用户询问"订单创建检查"等与 my.checkBeforeAddOrder 相关的问题

知识来源限制（重要）

所有知识回答内容与整理，仅基于以下文档源数据：

1. rent-knowledge-sources.md 中的"语雀知识文档列表"关联的文档，及其对应的本地下载的文档
2. rent-knowledge-sources.md 中的"支付宝开放平台文档列表"关联的文档，及其对应的本地下载的文档

禁止事项：

• ❌ 禁止基于猜想、推测或外部知识进行回答
• ❌ 禁止使用文档中未提及的信息进行补充

文档中未找到答案时的处理：

⚠️ 重要：必须使用 AskUserQuestion 询问用户是否重新执行完整流程，禁止直接输出"暂无该知识"。

使用 AskUserQuestion 询问用户是否重新执行完整流程（参见"模块六：结果输出"中的"未找到答案时的输出"）。

回答前必须验证：

• 回答中的每个知识点都能在本地文档中找到对应内容
• 无法在文档中找到依据时，必须按上述方式回复