1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | sql-queries-phuryn-pm-skills |
| 作者/维护者 | Paweł Huryn（GitHub: phuryn，The Product Compass Newsletter 创始人） |
| 来源链接 | https://github.com/phuryn/pm-skills/tree/main/pm-data-analytics/skills/sql-queries |
| 许可证 | MIT（GitHub API 确认，仓库根 LICENSE 覆盖全部子技能） |
| GitHub Stars | 24,745（GitHub API 数据；为 pm-skills 合集仓库整体数字，仓库含 9 个插件、68+ 个技能，不代表本技能自身热度） |
| Forks | 2,579（同上，合集整体数字） |
| 最新版本 | 所属插件 pm-data-analytics v2.1.0（plugin.json） |
| 安装方式 | Claude Code / Codex 插件市场一条命令；其他 Agent 手动复制技能目录 |
2. 功能介绍与亮点
把“用大白话描述数据需求”变成可执行 SQL 的纯参考型技能：
- 跨方言：BigQuery、PostgreSQL、MySQL、Snowflake、SQL Server 通吃，不绑定某一款数据库
- 零连接门槛：无需连接真实数据库或部署 MCP Server，凭 schema 文件或文字描述即可生成
- 讲逻辑：解释查询逻辑、给优化建议，按需生成测试脚本
- 四步引导：理解 schema → 澄清需求 → 生成查询 → 解释验证
作者 Paweł Huryn 是订阅规模较大的 PM 内容创作者；仓库配自动化测试与贡献指南，近期持续维护。
3. 适用场景
所属固定分类：数据分析与可视化。面向不熟悉 SQL 语法但需要数据答案的用户：产品经理核实数据结论、分析师翻译“上月活跃用户数”这类问题、工程师切换方言时少查语法手册，给出 schema 即可产出查询。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | 官方插件市场一条命令安装 |
| Codex CLI | 原生支持 ✅ | 官方文档确认读取同一插件市场清单；配套斜杠命令在 Codex 下不可用，技能本体不受影响 |
| OpenClaw | 未验证 ❓ | README 未点名，理论上可按通用格式手动复制 |
| Hermes Agent | 未验证 ❓ | 无官方安装说明 |
5. 推荐理由
把“写 SQL”的门槛从“懂方言语法”降到“说清楚想问什么”，不必连接真实数据库或额外部署服务，装上即用，是零配置、覆盖场景广的数据分析入口技能。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 合集星标不计入个体（本技能自身提交仅 2 次，均为作者本人）；但作者是有较大读者规模的 PM 内容创作者，issue 区可见独立第三方提交生态适配诉求、项目被第三方目录收录，本技能自身尚无专属讨论 |
| 可用性 | 9 | 插件市场一条命令安装；SKILL.md 含分步说明、示例与输出格式；近 1 个月内有更新；无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
| 安全检查项 | 结果 |
|---|---|
| ①Shell/权限范围 | 无——纯 Markdown 参考型技能，不含脚本或可执行代码 |
| ②联网外发 | 无——不发起网络请求，只读用户提供的 schema |
| ③API Key/凭据 | 不涉及——不连接真实数据库，不索取凭据 |
| ④可疑指令 | 未发现——全文无提示注入或隐藏指令 |
| ⑤作者信誉 | 良好——具名个人开发者，仓库配 CI 测试与贡献指南 |
| ⑥License | 明确——仓库根 MIT 覆盖全部子技能 |
| ⑦最近维护 | 2026-07-03 有提交，活跃维护中 |
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| chdb-sql（ClickHouse 官方） | agent 在 Python 进程内直接执行 ClickHouse SQL，支持跨 S3/MySQL/Postgres 等联表 | 需懂 ClickHouse 自身语法，解决“没有独立数据库服务时怎么跑查询” |
| mongodb-natural-language-querying（MongoDB 官方） | 通过 MCP 读取真实集合 Schema/索引后生成查询，强制只读并做索引覆盖检查 | 面向已连接的真实实例，护栏更强，但要先部署 MCP Server |
| bigquery-basics（Google 官方） | 覆盖建表、分区聚簇、IAM 权限等全生命周期操作 | 偏基础设施与权限管理，不止查询生成 |
本技能不绑定数据库产品，靠 schema 描述即可跨方言产出查询，门槛最低，代价是缺少连接态的索引校验护栏。
8. 用户评价
本技能目前尚无独立第三方评价。所属 PM Skills 项目层面有两条可验证记录：第三方目录 StackMap 收录了该项目（issue #55，用户 hoghweed 告知维护者）；开发者 jeongY-Cho 提交 issue #49 请求原生 OpenCode 插件支持，显示项目在 Claude Code 生态外也有真实使用需求。
9. 安装使用方式
Claude Code：
claude plugin marketplace add phuryn/pm-skills
claude plugin install pm-data-analytics@pm-skillsCodex CLI：
codex plugin marketplace add phuryn/pm-skills
codex plugin add pm-data-analytics@pm-skills其他遵循通用 SKILL.md 格式的 Agent：手动复制技能目录，例如：
cp -r pm-data-analytics/skills/sql-queries ~/.gemini/skills/安装后无需重启，直接描述需求（如“写一个查询上月活跃用户数的 BigQuery SQL”）即可触发；Claude Code 下也可用 /pm-data-analytics:write-query 命令强制加载。
10. 注意事项
- 生成质量依赖 schema 是否准确；技能不连接真实库校验，描述有误可能导致字段名猜测偏差
- 建议只装 pm-data-analytics 插件，无需装全部 9 个插件
- Codex CLI 下配套斜杠命令不可用，需改用自然语言触发
- OpenClaw、Hermes Agent 暂无官方安装说明，需自行验证兼容性