query-writing

Query-writing 技能使代理能够直接与关系型数据库交互，为生成、测试与优化 SQL 代码提供结构化的工作流程。此技能专为数据分析师、软件工程师与自动化报表系统所设计，旨在弥合自然语言需求与结构化数据库操作之间的鸿沟。通过利用 sql_db_schema 进行元数据探索，以及使用 sql_db_query 执行操作，代理可以自主导览数据库模式、处理多表关系并产出精确的结果集。

• 执行全面的查询生成，范围涵盖从简单的 SELECT 语句到复杂的 JOIN 结构、聚合函数 (SUM, AVG, COUNT) 与嵌套子查询。

• 采用安全优先的方法论，优先执行只读操作，并明确禁止 INSERT, UPDATE, DELETE 或 DROP 等破坏性 DML 指令。

• 实施“先计划、后执行”的结构化工作流程，鼓励使用 write_todos 将复杂的分析问题分解为可管理逻辑步骤，再进行执行。

• 整合模式检查流程，用以识别正确的数据表、外键关系与所需字段，确保执行前的查询准确性。

• 具备强大的错误恢复协议，协助代理通过系统化的验证与优化，解决常见的 SQL 问题，如查询结果为空、语法错误与查询超时。

• 当用户要求进行数据检索、特定记录筛选、跨表报表分析或数据库洞察时，请使用此技能。

• 务必应用合理的限制条件（例如默认限制 5 行的 LIMIT 子句），以管理大型结果集并确保性能。

• 在处理复杂 JOIN 时，应一致地使用数据表别名，以提升查询的可读性与维护性。

• 进行疑难解答时，应将错误视为迭代循环的一部分：核对模式中的字段名称、检查大小写敏感度，并确保 GROUP BY 子句包含所有非聚合字段。

• 请在 SQL 兼容环境下使用此技能；其设计初衷为结构化数据检索，而非一般文件系统或网络搜索任务。