text-to-sql

Text-to-SQL 技能是一项专门的代理能力，旨在架起人类可读的自然语言与关系型数据库操作之间的桥梁。它通过将使用者的意图转换为有效、高效且安全的 SQL 语法，为开发人员、数据分析师和系统管理员提供支持。该技能与 database-architect 架构深度整合，能够理解数据表之间的关系、外键和索引策略，确保生成的查询不仅语法正确，且针对目标环境进行了性能优化。

• 高级查询生成：将复杂的自然语言提示转换为精确的 SQL 查询，包括对连接（joins）、聚合（aggregations）、子查询及条件过滤的支持。

• 基于架构的精确度：直接参考 database-architect 的定义进行数据表与字段验证，最大限度地减少幻觉并降低运行时错误。

• 安全优先设计：强制使用参数化查询以防止 SQL 注入攻击，并具备语法验证与测试执行功能。

• 性能优化：自动考量连接效率、索引使用及数据传输限制，以生成高性能的代码。

• 评估整合：与 promptfoo 测试框架兼容，允许对语法准确性、功能正确性及架构合规性进行严格评估。

• 提供完整的数据库架构（包括数据表定义、字段类型与约束）以确保输出具备高保真度。

• 对于涉及多表连接或分析报告的复杂查询，建议使用思维链（chain-of-thought）提示，确保逻辑流向正确。

• 务必对 SELECT 操作设定明确的限制（LIMIT），以在进行临时探索时保护数据库稳定性。

• 将输出视为参数化查询；避免手动进行字符串拼接，以维持安全性协议的合规性。

• 最适用于生产或开发环境中的报告生成、数据探索、审计记录及临时问题排除等任务。