一种专门的数据库技能，用于执行 SQL 查询并从真实的 MySQL 或 PostgreSQL 数据中自动生成接口测试用例。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install querydb-skill
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 querydb-skill。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 queryDB-skill？
queryDB-skill 是一款功能强大的技术工具，专为需要连接生产数据库环境与自动化测试的开发者和 QA 工程师设计。作为 Openclaw Skills 的核心组件，它提供了无缝连接 MySQL 和 PostgreSQL 数据库的接口，用于检索样本、验证数据完整性并将真实值注入到测试固件中。
通过利用此技能，团队可以摆脱硬编码的测试数据，转而使用基于真实场景的记录。它简化了复杂的数据映射逻辑，例如发票类型和税号的具体要求，确保接口参数始终准确并反映数据库架构的当前状态。
queryDB-skill 应用场景
- 针对 MySQL 和 PostgreSQL 数据库执行常规 SQL 查询（SELECT, COUNT）以进行数据验证。
- 使用 db_fixture 模式将真实数据库记录注入到测试用例中，用实时值替换占位符。
- 通过将数据库字段映射到 API 请求参数来生成自动化接口测试用例。
- 基于特定的税号和发票编号规则，为发票相关系统创建全面的测试套件。
- 从复杂的数据库场景中批量生成测试用例，用于回归测试。
queryDB-skill 工作原理
- 通过 DatabaseClient 使用提供的凭据建立与目标 MySQL 或 PostgreSQL 数据库的安全连接。
- 定义 SQL 查询以针对特定的数据子集，例如用于发票管理的 bw_jms_main1 表。
- 利用映射逻辑将数据库列名（如 INV_KIND 或 E_INV_NUM）转换为所需的接口输入参数。
- 通过 TestCaseGenerator 等专用生成器处理记录，以生成 JSON 格式的测试配置。
- 将最终的测试用例输出为与 Openclaw Skills 支持的自动化测试框架兼容的标准化格式。
queryDB-skill 配置指南
要开始使用此技能，请通过 pip 安装必要的数据库驱动程序：
# For MySQL support
pip install pymysql
# For PostgreSQL support
pip install psycopg2-binary
确保在脚本中正确配置了数据库凭据（主机、端口、用户名、密码）。
queryDB-skill 数据架构与分类体系
该技能主要与 bw_jms_main1 表交互，并以 JSON 格式导出数据。以下是与发票相关的 Openclaw Skills 数据的主要映射逻辑：
| 数据类型 | 数据库字段 | 接口参数 |
|---|---|---|
| 税务发票 | INV_KIND, INV_NUM | invoiceCode, invoiceNumber |
| 电子发票 | E_INV_NUM | invoiceNumber (20-digit) |
| 买方信息 | BUYER_TAXNO | taxNo |
| 卖方信息 | SELLER_TAXNO | salesTaxNo |
queryDB-skill 高级特性
- 智能 SQL 占位符：运行时自动替换 {{buyer_tax_no}} 等变量，实现动态查询。
- 多行安全检查：内置计数验证，跳过超过安全阈值（默认 500 行）的场景，以防止性能下降。
- 基于场景的批处理：使用预定义的场景列表和映射规则，一次性生成数百个测试用例。
- 自动时间范围过滤：通过自动附加基于日期限制（如最近 90 天）来简化查询，防止处理过时数据。
- 全面导出：直接将生成的测试套件保存为 JSON 格式，供其他 Openclaw Skills 使用。
SKILL.md
加载中
Openclaw 相关技能
精选*
