返回 Skill 列表
extension
分类: 开发与工程无需 API Key

支付宝租赁行业知识技能

支付宝租赁行业知识技能应用于支付宝租赁行业知识的检索问答场景,支持支付宝租赁平台的产品知识查询,包括租赁交易、租安盾、资商通等

person作者: dongl1111hubModelScope

支付宝租赁行业知识技能

快速导航

| 模块 | 职责 | 检查项 | 详细文档 | |------|------|--------|----------| | 模块一 | 用户意图分析 | 领域识别 + 类型判断 + 意图确认 | 本文 §模块一 | | 模块二 | 本地文档检查 | 输出检查表格 + 待下载列表 | workflow-guide.md | | 模块三 | 文档下载 | 询问用户 + 执行下载 + 验证日志 | workflow-guide.md | | 模块四 | 本地知识检索 | 多策略检索 + 内容验证 | workflow-guide.md | | 模块五 | 智能知识整理 | 格式化 + 提取关键信息 | 本文 §模块五 | | 模块六 | 结果输出 | 验证依据 + 参考表格 + 支持提示 | 本文 §模块六 |

关键参考文档


概述

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

核心特点

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

⚠️ 系统要求

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

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


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

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

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

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

# 定义技能目录(查找 SKILL.md 所在目录)
SKILL_DIR=$(dirname "$(find . -name "SKILL.md" -path "*alipay-rental-knowledge-base*" 2>/dev/null | head -1)")

# 如果找不到技能目录,使用默认路径
if [ -z "$SKILL_DIR" ]; then
  SKILL_DIR="./skills/alipay-rental-knowledge-base"
fi

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

路径说明

| 路径变量 | 含义 | 示例值 | |----------|------|--------| | ${WORK_SPACE_DIR} | 工作空间目录(pwd) | /Users/xxx/project | | ${WORK_SPACE_DIR}/租赁行业知识/ | 知识库目录 | 存放所有下载的文档 | | ${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json | 文档检查结果文件 | 文档状态追踪 | | ${SKILL_DIR} | 技能根目录 | ./skills/alipay-rental-knowledge-base | | ${SKILL_DIR}/references/ | 知识来源索引目录 | 知识来源文档 | | ${SKILL_DIR}/scripts/ | 脚本目录 | Python 脚本(检查、下载等) |

后续所有相对路径基于这两个变量

  • 技能文件路径:${SKILL_DIR}/...
  • 知识库文件路径:${WORK_SPACE_DIR}/租赁行业知识/...

⚠️ 核心处理流程(强制执行)

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

流程执行追踪表

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

| 步骤 | 模块名称 | 必须完成的检查项 | 必须产出 | |:---:|----------|------------------|----------| | 1 | 用户意图分析 | ☐ 识别知识领域 ☐ 确定查询类型 ☐(可选)意图确认 | 领域 + 类型 | | 2 | 本地文档检查 | ☐ 已执行 install_dependencies.sh已向用户展示依赖检查和安装结果 ☐ 已执行 create_doc_list.py ☐ 已向用户展示脚本输出 ☐ 已执行 check_docs.py ☐ 已向用户展示检查结果表格和待下载列表 ☐ 已生成 doc_check_result.json 文件 | 依赖检查安装结果 + 脚本输出日志 + doc_check_result.json | | 3 | 文档下载 | ☐ 已读取 doc_check_result.json ☐ 待下载数量>0时必须执行下载(禁止跳过) ☐ 已执行 download_docs.py ☐ 已向用户展示下载进度和结果部分失败时已询问用户是否继续 ☐ 更新 download_status = true 或用户确认继续 | 下载进度日志 + 下载结果汇总 + 更新后的 doc_check_result.json | | 4 | 本地知识检索 | ☐ 验证 doc_check_result.json 中所有 download_status = true ☐ 多策略并行检索 ☐ 读取命中文档 ☐ 验证内容相关性 | 检索到的文档列表 | | 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 是否已存在于文档列表中
  2. 根据检查结果执行下载

    • 如果 URL 已存在:按正常流程更新下载该文档
    • 如果 URL 不存在
      • 使用 download_docs.py 脚本下载该 URL
      • 语雀 URL 使用 yuque-dl 下载
      • 支付宝 URL 使用 fetch_alipay.py 下载
      • 下载完成后继续按用户意图执行后续流程
  3. 内容分析优先级

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

URL 识别规则

| URL 特征 | 下载方式 | |----------|----------| | 包含 yuque.com(非 yuque.antfin.com) | yuque-dl doc <URL> | | 其他所有 URL(支付宝开放平台等) | python3 ${SKILL_DIR}/scripts/fetch_alipay.py --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

常用领域快速识别

| 关键词 | 知识领域 | |--------|----------| | 入驻、商户接入、开户、签约 | 入驻SOP | | 租安盾+(是什么/功能/介绍) | 租安盾-产品咨询(直接引导) | | 租安盾+(API/接口/参数/风险咨询) | 租安盾-技术接口 | | 资商通、资金、融资、金融 | 资商通 | | 订单创建、下单、支付、代扣 | 租赁交易(订单接口) | | 接入指南、交易接入、标准交易 | 租赁交易 | | 规则、规范、准入、服务费 | 行业规则 | | API、接口、参数、字段 | 技术接口 |

Step 2: 确定查询类型

| 查询类型 | 特征 | 输出格式 | |----------|------|----------| | 产品知识 | "是什么"、"有什么功能"、"能做什么"、产品介绍 | 归纳整理,要点列表 | | 接入指南 | "怎么接入"、"如何接入"、"接入流程" | 步骤列表 + 注意事项 | | 技术接口 | "API"、"接口文档"、"参数"、"字段"、"请求"、"响应" | 接口参数表格 | | 规则说明 | "规则"、"规范"、"要求"、"限制" | 规则清单 | | 问题解决 | "为什么"、"报错"、"失败"、"异常" | 原因分析 + 解决方案 |

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

Step 3: 意图确认(可选)

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


模块二:本地文档检查(必须执行)

职责:检查本地文档完整性和时效性,生成 doc_check_result.json 文件。

详细步骤、依赖检查脚本说明请参考 workflow-guide.md

检查点

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

必须产出${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.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中的 「Step 2 和 Step 3 根据模式选择执行方式」中的 刷新全部文档模式 部分

关键字段

| 字段 | 说明 | |------|------| | status | 文档状态:fresh(新鲜)/ expired(过期)/ missing(缺失) | | download_status | 核心字段true=已就绪,false=需处理 |

模块完成判定

| 状态 | 条件 | 是否可进入模块三 | |------|------|:---:| | ✅ 完成 | 已生成 doc_check_result.json 文件 | 是 | | ❌ 未完成 | 未生成 JSON 文件 | 否 |


模块三:文档下载(必须执行)

职责:读取 doc_check_result.json,执行下载/更新,更新 JSON 文件中的 download_status

详细步骤、用户交互流程请参考 workflow-guide.md

前置条件:模块二已生成 ${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json

⚠️ 禁止事项(违反则流程无效)

  • 禁止根据用户问题判断"相关文档已存在"而跳过下载
  • 禁止根据用户问题关键词选择性下载部分文档
  • 禁止跳过任何 download_status = false 的文档

检查点

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

必须产出:更新后的 ${WORK_SPACE_DIR}/租赁行业知识/doc_check_result.json

核心步骤

# Step 1: 定义目录变量
WORK_SPACE_DIR="$(pwd)"
SKILL_DIR=$(dirname "$(find . -name "SKILL.md" -path "*alipay-rental-knowledge-base*" 2>/dev/null | head -1)")

# 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 的文档。

模块完成判定

| 状态 | 条件 | 是否可进入模块四 | |------|------|:---:| | ✅ 完成 | 所有 download_status = true | 是 | | ⚠️ 部分完成 | 部分下载失败,用户确认继续 | 是(需说明部分文档缺失) | | ❌ 未完成 | 部分 download_status = false未询问用户 | 否 | | ❌ 未完成 | 未执行下载脚本(有文档需要下载但跳过了) | 否 |


模块四:本地知识检索(必须执行)

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

详细执行步骤、检索策略、脚本命令请参考 workflow-guide.md

前置条件:模块三已完成,doc_check_result.json 已更新

检查点

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

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

核心步骤概览

  1. 验证文档状态:检查 doc_check_result.json,输出文档状态汇总
  2. 定义检索目录:设置 KNOWLEDGE_DIRYUQUE_DIRALIPAY_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开始重新执行 | | 查看其他渠道 | 输出提示信息 |

查看其他渠道的输出:

建议您:
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


Error handling

| 错误场景 | 处理方式 | |----------|----------| | 本地文档不存在 | 提示用户运行 download_docs.py 脚本下载文档 | | 文档超过3天未更新 | 自动执行更新下载,无需询问用户 | | 无法访问远端链接 | 说明暂无远端访问能力,依赖本地文档 | | 找不到匹配文档 | 回答"无该知识",引导用户前往 xfpzl.yuque.com 搜索或联系技术支持/b站助理小智 | | 文档内容不完整 | 提示可能版本过旧,建议更新 | | 文档中未找到相关描述 | 回答"无该知识",引导用户前往 xfpzl.yuque.com 搜索或联系技术支持/b站助理小智 |


Output rules(输出规则)

流程完整性规则(最高优先级)

  1. 流程完整性要求:所有输出必须确认已完整执行 6 个模块的流程
    • 禁止跳过任何模块
    • 禁止跳过模块内的任何检查项
    • 输出前必须在内部确认:6 个模块全部完成

内容输出规则

  1. 始终使用中文输出
  2. 产品知识采用归纳整理格式(要点列表)
  3. 技术知识采用接口参数表格格式
  4. 所有输出末尾必须以表格形式列出远端参考链接
  5. 表格格式:序号列 + 文档标题(含链接)列 + 引用位置列
  6. 标题来源:rent-knowledge-sources.md 表格的"标题"列
  7. 引用位置格式(必须精准,禁止误导):
    • 有章节/标题的文档第X.X.X 章节标题(约第X-X行)
    • 无章节/标题的文档约第X-X行
    • 无法精确定位时:直接显示 参考全文参考相关章节
    • ⚠️ 严禁提供非关联位置或错误位置,这会产生严重误导
  8. 多个文档按权重排序:核心文档优先、引用量优先、重要性优先
  9. 接口类问题优先级:技术接口类问题(API、参数、字段等)优先查询和引用支付宝开放平台文档,语雀文档作为补充
  10. 所有输出末尾必须包含技术支持提示:"如需进一步帮助,请联系技术支持b站助理小智"
  11. 如本地文档缺失或过期,优先提示用户更新
  12. 明确说明"所有文档从本地读取,无远端访问能力"
  13. 前端 JSAPI 接口(my.tradePay、my.checkBeforeAddOrder)采用特殊处理:简要说明用途后引导用户访问原文查看完整文档

前端接口特殊处理

前端 JSAPI 接口列表

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

| 接口名称 | 说明 | 原文链接 | |----------|------|----------| | my.tradePay | 发起支付接口,支持 JSAPI 支付和预授权支付 | 查看原文 | | my.checkBeforeAddOrder | 订单创建前检查接口 | 查看原文 |

处理规则

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

  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.tradePaymy.checkBeforeAddOrder 接口
  • 回答内容需要引用这两个接口的文档
  • 用户询问"小程序支付"、"前端支付"、"预授权支付"等与 my.tradePay 相关的问题
  • 用户询问"订单创建检查"等与 my.checkBeforeAddOrder 相关的问题

知识来源限制(重要)

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

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

禁止事项:

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

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

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

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

回答前必须验证:

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