save_sql_template
Save a generated SQL query as a reusable template in the template library with metadata like scenario, category, placeholders, and verified status, enabling retrieval and reuse in future tasks.
Instructions
将一次生成的 SQL 步骤沉淀为模板,存入模板库(Supabase)。
参数:
title: 模板标题(如「询价单回退至报价中」)
category: 业务分类,建议取值:通用基础查询 / 询价单RFX / 征询单RF / 数据修复
scenario: 业务场景描述(检索主要依据,请写清楚用途)
sql_text: 完整 SQL 文本(保留
{...}或<...>占位符原样)execution_flow: 执行过程伪代码(数据修复类模板强烈建议填写)。标准语法: [INPUT] <入参1>, <入参2> [STEP n: 步骤名] QUERY: 前置查询 SQL(用 {变量} 引用上一步提取的真实值) ASSERT: 断言(如「必须返回 1 行,提取 {tenant_id};0 行则终止报错」) CONDITION: 条件短路(如「IF {status} == 'X' THEN RETURN 无需修复」) ACTION: 修复语句(UPDATE/DELETE/INSERT,带乐观锁 object_version_number+1) 指导大模型分步调用 execute_sql,禁止跳过前置校验直接生成修复 SQL。
example_case: 脱敏示例(Few-Shot)。含:输入参数 → 各 STEP 中间结果 (如「Step 1 结果: tenant_id=155357」)→ 最终生成的可执行 SQL,消除大模型猜测。
doc_type: 单据类型(通用/询价单/招标单/征询单/数据修复)
keywords: 关键词/标签,逗号分隔(如「回退,报价中,延时消息」),用于检索
core_tables: 涉及核心表,逗号分隔(如「ssrc_rfx_header,spfm_pending_message」)
placeholders: 占位符清单,逗号分隔(如「tenant_id,rfx_header_id」)
verified: 是否「✅ 已验证」(验证过的模板可被技能免 MCP 校验复用)
verified_at: 验证日期(verified=True 时建议填写,如 2026-07-23)
template_no: 模板编号(如 2.6.6),便于与历史模板对应
created_by: 作者(为团队共享预留)
source: 来源标记(auto=技能自动沉淀 / migrated=手工迁移 / manual=手工新增)
skip_dup_check: 跳过相似去重检查直接写入
返回:保存结果(含模板 id)或相似模板提示。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| source | No | auto | |
| category | Yes | ||
| doc_type | No | 通用 | |
| keywords | No | ||
| scenario | Yes | ||
| sql_text | Yes | ||
| verified | No | ||
| created_by | No | ||
| core_tables | No | ||
| template_no | No | ||
| verified_at | No | ||
| example_case | No | ||
| placeholders | No | ||
| execution_flow | No | ||
| skip_dup_check | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |