[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77MMWVXPW7ACF5RVRDM5JY3":3,"skill-same:01M77MMWVXPW7ACF5RVRDM5JY3":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":13,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M77MMWVXPW7ACF5RVRDM5JY3","sql_query",null,"当用户提出数据查询需求（如'查数'、'查一下订单量'、'有多少用户'、'帮我跑个SQL'等），使用数据源工具发现表结构，生成并执行只读 SQL 查询。","pan-hh\u002Fmateclaw-hybrid","pan-hh","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F244917262?v=4","01M77MGAQE06HNBEHKYN7180V6","01M77MGARJ7JXWZYKA9RMM968R",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fsql_query\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sql_query\nversion: \"1.1.0\"\ndescription: \"当用户提出数据查询需求（如'查数'、'查一下订单量'、'有多少用户'、'帮我跑个SQL'等），使用数据源工具发现表结构，生成并执行只读 SQL 查询。\"\ndependencies:\n  tools:\n    - datasourceTool\n    - sqlQueryTool\n---\n\n# SQL 查询技能\n\n当用户提出与数据查询相关的问题时，按照以下工作流程操作。\n\n## 工作流程\n\n### 第一步：发现数据源\n调用 `query_datasource(action='list_datasources')` 查看所有可用的外部数据源。\n- 如果只有一个数据源，直接使用它\n- 如果有多个数据源，根据用户问题推断最相关的数据源；不确定时询问用户\n\n### 第二步：发现表结构\n调用 `query_datasource(action='list_tables', datasourceId=\u003Cid>)` 查看数据源中的表列表。\n- 根据表名和注释判断与用户问题相关的表\n- 不要一次查看所有表的结构，只查看相关的 2-3 张表\n\n### 第三步：查看列详情\n调用 `query_datasource(action='describe_table', datasourceId=\u003Cid>, tableName='\u003C表名>')` 查看列名、类型和注释。\n- 记住列名和类型，生成 SQL 时必须使用正确的列名\n\n### 第四步：生成 SQL\n根据表结构和用户问题，生成 SELECT SQL。遵循以下规则：\n\n**SQL 生成规则：**\n1. **仅生成 SELECT 语句**，绝不生成 INSERT\u002FUPDATE\u002FDELETE\u002FDROP 等写操作\n2. 多表查询时，所有字段必须用表别名限定（如 `t1.name`）\n3. 聚合查询使用 COUNT\u002FSUM\u002FAVG\u002FMAX\u002FMIN 等函数\n4. 时间过滤使用数据库对应的日期函数\n5. 字符串匹配使用 LIKE 并注意大小写\n6. 结果默认按合理的顺序排序（如时间倒序）\n7. 系统会自动注入 LIMIT 500，无需手动添加（除非用户指定了数量）\n\n**不同数据库的注意事项：**\n- MySQL：日期用 `DATE_FORMAT()`、`NOW()`，字符串连接用 `CONCAT()`\n- PostgreSQL：日期用 `TO_CHAR()`、`NOW()`，字符串连接用 `||`\n- ClickHouse：日期用 `toDate()`、`today()`，注意不支持部分标准 SQL 语法\n\n### 第五步：执行查询\n调用 `execute_sql(datasourceId=\u003Cid>, sql='\u003CSQL>')` 执行查询。\n\n### 第六步：解读结果\n- 用自然语言总结查询结果的要点\n- 如果结果为空，分析可能的原因（表名\u002F列名\u002F条件有误等）\n- 如果需要，可以调整 SQL 重新查询\n- 如果查询结果包含数值列，系统会自动生成 ECharts 图表，无需你手动生成图表代码\n- **重要：不要使用 write_file 工具生成 HTML 图表文件，系统已内置图表渲染能力**\n\n## 错误处理\n\n如果 SQL 执行失败：\n1. 仔细阅读错误信息\n2. 常见原因：列名拼写错误、类型不匹配、语法错误\n3. 根据错误修正 SQL 并重试一次\n4. 如果仍然失败，向用户说明错误原因\n\n## 安全须知\n\n- 本工具仅支持只读查询（SELECT），写操作会被系统拒绝\n- 查询结果默认限制为 500 行\n- 查询超时为 30 秒\n- 如果用户要求执行写操作，应礼貌拒绝并说明这是安全限制\n","# SQL 查询技能\n\n当用户提出与数据查询相关的问题时，按照以下工作流程操作。\n\n## 工作流程\n\n### 第一步：发现数据源\n调用 `query_datasource(action='list_datasources')` 查看所有可用的外部数据源。\n- 如果只有一个数据源，直接使用它\n- 如果有多个数据源，根据用户问题推断最相关的数据源；不确定时询问用户\n\n### 第二步：发现表结构\n调用 `query_datasource(action='list_tables', datasourceId=\u003Cid>)` 查看数据源中的表列表。\n- 根据表名和注释判断与用户问题相关的表\n- 不要一次查看所有表的结构，只查看相关的 2-3 张表\n\n### 第三步：查看列详情\n调用 `query_datasource(action='describe_table', datasourceId=\u003Cid>, tableName='\u003C表名>')` 查看列名、类型和注释。\n- 记住列名和类型，生成 SQL 时必须使用正确的列名\n\n### 第四步：生成 SQL\n根据表结构和用户问题，生成 SELECT SQL。遵循以下规则：\n\n**SQL 生成规则：**\n1. **仅生成 SELECT 语句**，绝不生成 INSERT\u002FUPDATE\u002FDELETE\u002FDROP 等写操作\n2. 多表查询时，所有字段必须用表别名限定（如 `t1.name`）\n3. 聚合查询使用 COUNT\u002FSUM\u002FAVG\u002FMAX\u002FMIN 等函数\n4. 时间过滤使用数据库对应的日期函数\n5. 字符串匹配使用 LIKE 并注意大小写\n6. 结果默认按合理的顺序排序（如时间倒序）\n7. 系统会自动注入 LIMIT 500，无需手动添加（除非用户指定了数量）\n\n**不同数据库的注意事项：**\n- MySQL：日期用 `DATE_FORMAT()`、`NOW()`，字符串连接用 `CONCAT()`\n- PostgreSQL：日期用 `TO_CHAR()`、`NOW()`，字符串连接用 `||`\n- ClickHouse：日期用 `toDate()`、`today()`，注意不支持部分标准 SQL 语法\n\n### 第五步：执行查询\n调用 `execute_sql(datasourceId=\u003Cid>, sql='\u003CSQL>')` 执行查询。\n\n### 第六步：解读结果\n- 用自然语言总结查询结果的要点\n- 如果结果为空，分析可能的原因（表名\u002F列名\u002F条件有误等）\n- 如果需要，可以调整 SQL 重新查询\n- 如果查询结果包含数值列，系统会自动生成 ECharts 图表，无需你手动生成图表代码\n- **重要：不要使用 write_file 工具生成 HTML 图表文件，系统已内置图表渲染能力**\n\n## 错误处理\n\n如果 SQL 执行失败：\n1. 仔细阅读错误信息\n2. 常见原因：列名拼写错误、类型不匹配、语法错误\n3. 根据错误修正 SQL 并重试一次\n4. 如果仍然失败，向用户说明错误原因\n\n## 安全须知\n\n- 本工具仅支持只读查询（SELECT），写操作会被系统拒绝\n- 查询结果默认限制为 500 行\n- 查询超时为 30 秒\n- 如果用户要求执行写操作，应礼貌拒绝并说明这是安全限制\n",{"name":5,"version":23,"description":7,"dependencies":24},"1.1.0",{"tools":25},[26,27],"datasourceTool","sqlQueryTool","dev","26b960a788645da1daf5b6c1c8c7ffe1a78ab755","mateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fsql_query","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid","https:\u002F\u002Fgithub.com\u002Fpan-hh","2026-06-25 12:43:25",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add pan-hh\u002Fmateclaw-hybrid --skill sql_query",{"tool":40,"command":41},"bunx","bunx skills add pan-hh\u002Fmateclaw-hybrid --skill sql_query",{"tool":43,"command":44},"pnpm","pnpm dlx skills add pan-hh\u002Fmateclaw-hybrid --skill sql_query","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fsql_query\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M77MNZW6PYRTH5KM9121RYAK","sample","Test fixture for SkillBundleMaterializer.","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Ftest\u002Fresources\u002Ftest-bundles\u002Fsample\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M77MNNA8HYFP854EHAEGZ838","x_intel","Read X (Twitter) posts, search, timelines and user profiles via the official xurl CLI.","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fx_intel\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M77MNJRFN8KNSY1PXRFBV97S","writing-plans","Write implementation plans: bite-sized tasks, paths, code.","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M77MNF0PF06YCNA9TWK85PE9","webhook-subscriptions","Webhook subscriptions: event-driven agent runs.","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fwebhook-subscriptions\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M77MNATFKP03KPE7HM7W29MC","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M77MN78ZK5EKN7HT2ZKYDPKM","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002Fpan-hh\u002Fmateclaw-hybrid\u002Fblob\u002Fdev\u002Fmateclaw-server\u002Fsrc\u002Fmain\u002Fresources\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]