1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | postgresql-code-review-github-awesome-copilot |
| 作者/维护者 | GitHub（github/awesome-copilot 官方合集仓库，社区贡献经官方仓库维护者审核合并） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/postgresql-code-review |
| 许可证 | MIT（仓库级，来自 GitHub API） |
| GitHub Stars | 38,774（GitHub API，属整个 awesome-copilot 合集，不代表本技能自身热度） |
| Forks | 4,909（GitHub API，同上，属合集整体） |
| 最新版本 | 无独立版本号，内容最近一次改动为 2026-02-19（批量格式转换提交） |
| 安装方式 | gh skills install github/awesome-copilot postgresql-code-review，或手动复制 skills/postgresql-code-review 目录到本地 skills 目录 |
2. 功能介绍与亮点
这是一个专注 PostgreSQL 特有能力的代码审查技能，区别于面向多数据库的通用 SQL 审查，只覆盖 PostgreSQL 独有的语法与特性：
- JSONB 审查：识别未走索引的
->>字符串比较写法，给出可走 GIN 索引的@>包含查询改法，并检查 JSONB 结构是否配有 CHECK 约束。 - 数组操作审查：检查
ANY()全表扫描写法，建议改用 GIN 索引 +@>包含运算符。 - PostgreSQL 专属类型：审查是否合理使用
CITEXT（大小写不敏感文本）、TIMESTAMPTZ、自定义ENUM/DOMAIN类型替代泛用VARCHAR/DECIMAL。 - Row Level Security（RLS）审查：检查行级安全策略的实现是否正确，以及权限授予是否遵循最小化原则（避免
GRANT ALL）。 - 触发器与函数优化：给出 PL/pgSQL 触发器函数的性能反模式与改法示例（如避免无条件触发、使用
WHEN子句限定触发条件）。
内容以“❌ 错误写法 / ✅ 正确写法“SQL 代码块成对呈现，每个审查维度都配具体可执行的改法，而非泛泛的原则罗列，全文约 7.4KB。
3. 适用场景
固定分类：工程效率与代码质量（代码审查工具，功能是对已有 SQL/PLpgSQL 代码给出问题清单与改法）。
适用于使用 PostgreSQL 作为主数据库的团队，在提交代码前对 SQL 迁移脚本、存储过程或 ORM 生成的查询做 PostgreSQL 专项审查——尤其是那些用了 JSONB、数组、RLS 等 PostgreSQL 特有能力、而通用 SQL 审查工具无法覆盖的场景。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 Agent Skills 格式（SKILL.md + YAML front matter），复制到
.claude/skills/目录即可使用。 - Codex：✅ 原生支持——Codex CLI 技能系统同样构建在开放的 Agent Skills 标准之上。
- OpenClaw：未验证。
- Hermes Agent：未验证。
5. 推荐理由
通用 SQL 审查工具为了兼容 MySQL/SQL Server/Oracle，往往只能给出几种数据库的最大公约数建议，而 PostgreSQL 真正强大的地方——JSONB、数组、RLS、自定义类型——恰恰是这类通用审查最容易漏掉的部分。这个技能把审查范围收窄到 PostgreSQL 专属特性，每条建议都配具体的索引类型与查询写法，对重度使用 PostgreSQL 高级特性的团队比通用审查工具更有针对性，且零配置、复制即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 官方组织仓库出品（github/awesome-copilot）；本技能自身未查到独立于合集之外的第三方讨论或媒体报道 |
| 可用性 | 7 | SKILL.md 结构完整、示例具体，无需任何配置或凭据即可使用；内容最近一次改动为 2026-02-19（约 6.7 个月前），略超近 6 个月的活跃维护窗口 |
| 安全性 | 9 | 纯提示词/审查指引，正文全部是审查标准与 SQL 示例代码块，无脚本、无代码执行、无外部网络调用；通读全文无可疑指令；MIT 许可证明确；GitHub 官方仓库信誉良好 |
| 综合 | 7.67 | 三项均值，≥ 7.0 达标 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
同一合集内的 sql-code-review |
通用 SQL 审查，覆盖 MySQL/PostgreSQL/SQL Server/Oracle 四种数据库的注入防护、权限、命名规范 | 广度优先，四种数据库通用但不深入任何一种的专属特性；与本技能是互补关系——先用它做跨库通用审查，再用本技能补 PostgreSQL 专项审查 |
GitHub Copilot 内置代码审查（gh copilot review / PR 审查建议） |
面向所有编程语言的通用代码审查功能，非 SQL 专项 | 覆盖面是全语言通用建议，不针对 PostgreSQL 的 JSONB/数组/RLS 等专属机制给出结构化改法 |
8. 用户评价
该技能目前在第三方平台（Reddit、Hacker News、技术博客）尚无具名用户评价；能查到的相关页面均为技能聚合站点（如 mcpservers.org、explainx.ai）对同一份 SKILL.md 内容的自动化镜像收录，不构成独立评价。
9. 安装使用方式
- 通过 CLI 安装：
gh skills install github/awesome-copilot postgresql-code-review（需 GitHub CLI 且已认证）。 - 手动安装：从仓库复制
skills/postgresql-code-review/目录（仅含单个SKILL.md）到本地 agent 的 skills 目录。 - 触发方式：在对话中选中要审查的 SQL/PLpgSQL 代码后请求“用 PostgreSQL 代码审查这段”，或直接要求对整个项目做 PostgreSQL 专项审查；无需额外配置，无需 API key，安装后立即可用。
- 安装后无需重启。
10. 注意事项
- 仅覆盖 PostgreSQL 专属特性，不适用于 MySQL/SQL Server/Oracle 等其他数据库；跨数据库项目建议搭配同一合集内的通用
sql-code-review一起使用。 - 内容本身近 7 个月未更新，若 PostgreSQL 后续版本引入新特性（如新的索引类型），技能给出的建议可能未覆盖最新版本能力。
- 纯审查建议类技能，不会自动修改代码，需人工采纳后自行改写。