将一次生成的 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）或相似模板提示。

在模板库中检索可复用的 SQL 模板（生成 SQL 前先调用，形成闭环）。

采用混合检索：语义向量召回（NVIDIA Embedding） + 关键词模糊匹配，按相似度/使用次数综合排序。 若未配置 NVIDIA_API_KEY，自动降级为纯关键词检索，不影响原有能力。

参数：

• keyword: 关键词或自然语言描述（如「把询价单退回到报价中」「ssrc_rfx_header」）

• doc_type: 按单据类型过滤（通用/询价单/招标单/征询单/数据修复）

• category: 按业务分类过滤（通用基础查询/询价单RFX/征询单RF/数据修复）

• verified_only: 仅返回「✅ 已验证」模板

• limit: 返回条数上限

• use_semantic: 是否启用语义召回（默认 true；无 NVIDIA key 时自动忽略）

返回：匹配模板的 Markdown 列表（含 SQL 与验证状态，语义命中会标注相似度）。

用语义向量召回模板，适合自然语言/口语化描述（如同义改写、业务意图）。

底层调用 schema.sql 的 match_sql_templates RPC（pgvector 余弦距离）。 需配置 NVIDIA_API_KEY；未配置或调用失败时返回降级提示。

参数：

• query: 自然语言查询（如「把询价单退回到报价中状态」「查某供应商名下所有在执行的招标单」）

• doc_type: 按单据类型过滤（通用/询价单/招标单/征询单/数据修复）

• category: 按业务分类过滤（通用基础查询/询价单RFX/征询单RF/数据修复）

• verified_only: 仅返回「✅ 已验证」模板

• threshold: 相似度阈值（0~1，越高越严格，默认 0.5）

• limit: 返回条数上限

返回：按语义相似度排序的模板 Markdown 列表（含相似度分值）。

按 id 获取单个模板的完整内容。

列出模板库中的模板（可按分类/单据类型/验证状态过滤），用于总览。

更新已有模板的字段（如补充验证标记、修正 SQL、补充执行过程伪代码）。

• execution_flow: 执行过程伪代码（[INPUT]/[STEP]/QUERY/ASSERT/CONDITION/ACTION）， 为存量高频数据修复模板渐进式补充，指导大模型分步执行。

• example_case: 脱敏示例（输入参数 → 中间结果 → 最终 SQL 的完整轨迹）。

删除指定模板（清理错误/过期模板）。

记录某模板被实际使用一次（使用次数 +1，刷新最近使用时间）。

在技能复用模板生成最终 SQL 后调用，用于评估模板价值、优化检索排序。