前言¶

日常开发里，PostgreSQL 相关的问题往往集中在几类：查询写得慢却说不清瓶颈在哪、表结构要不要拆、索引该建哪些字段。把这些上下文反复塞进对话，既费 token，也容易漏掉项目里已有的约定。Skill 的做法是把「怎么写查询、怎么设计表与索引」沉淀成 Agent 可加载的说明，在对话里用触发词唤起，而不是每次从零解释数据库背景。

下面介绍 SkillHub 上的 PostgreSQL 数据库（坐标 @user_f12a44b7/self-dev-pg），说明它是什么、能做什么、如何安装，以及适合在什么场景下使用。

这是什么¶

PostgreSQL 数据库 是面向开发场景的 Agent Skill，基于通用 SKILL.md 格式，由社区发布者 user_f12a44b7 维护；SkillHub 页面标注作者为鸿爪派智能科技有限公司。当前版本为 1.0.1，分类为 dev-programming，来源为 community，标签 requires_api_key=false，安装与使用不需要额外 API Key。

官方简介将其定位为：PostgreSQL 数据库技能，用于编写高效查询语句、设计合理的表结构与索引。它解决的是「在编码助手对话中，让模型按一致的方法论处理 PostgreSQL/SQL 相关问题」，而不是替代本地的 psql 或数据库实例本身。

• SkillHub 展示页：https://www.skillhub.cn/skills/user_f12a44b7/self-dev-pg
• 资料中的 API 条目：https://api.skillhub.cn/user_f12a44b7/self-dev-pg

核心功能¶

以下能力均来自官方简介与页面描述，未在资料中出现的具体命令或检查清单不作延伸。

1. 查询与 SQL：在对话中围绕 PostgreSQL 编写、审阅或优化 SQL，侧重「高效查询」这一表述所涵盖的写法与结构问题（具体细则以安装后的 Skill 正文为准）。
2. 表结构与 schema 设计：协助规划表、字段与关系，使结构更贴合常见建模与可维护性需求。
3. 索引：结合表结构与访问模式，讨论索引是否合理、应落在哪些列上（仍以 Skill 内指导为准）。

触发词（官方列出）：psql、pgcli、PostgreSQL、SQL、索引、查询、schema 设计。在已启用该 Skill 的 Agent 里，用上述词或明确提到 PostgreSQL 开发任务，便于加载对应技能上下文。

安装与启用¶

SkillHub 推荐通过 skillhub CLI 安装，并强调必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

1、安装或检查 SkillHub CLI¶

command -v skillhub && skillhub --version

若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装本 Skill¶

官方页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_f12a44b7/self-dev-pg。

命令形式与 SkillHub 文档第三节一致，将坐标装入选定目录，例如 Cursor 常用路径为 ~/.cursor/skills/：

skillhub install user_f12a44b7/self-dev-pg --dir ~/.cursor/skills/

其他客户端的 skills 目录以 SkillHub 安装文档为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。安装后按你所用 Agent 的要求重启或刷新技能列表，使 SKILL.md 被加载。

资料中未单独列出 Cursor / Codex CLI / Claude Code 的差异配置项；三者差异主要体现在 skills 目录路径，安装命令中的 --dir 需与当前环境一致。

典型用法¶

官方未在抓取页面中提供独立的可复制 SQL 样例或端到端教程；可复现的流程以 安装 + 触发词对话 为主。

1. 按上一节将 @user_f12a44b7/self-dev-pg 装入当前 Agent 的 skills 目录。
2. 在对话中说明环境（例如使用 psql 或 pgcli、PostgreSQL 版本若已知可写上）和具体任务。
3. 使用官方触发词之一切入，例如：「帮我在 PostgreSQL 里优化这条查询」或「做一下 schema 设计，并说明索引建议」。

经过上面的步骤，Agent 应依据 Skill 内嵌的指导参与 SQL、索引与表结构相关讨论；若回答风格与预期不符，可先确认 Skill 是否装在正确目录且已被加载。

适用场景与注意¶

适合谁：经常在 Agent 里写或改 PostgreSQL SQL、讨论索引与表设计的后端或全栈开发者；本地已有数据库或迁移脚本，需要对话侧有一致的设计与查询视角。

注意：

• Skill 提供的是对话内的方法论与建议，不能代替在真实实例上执行 EXPLAIN、压测或迁移验证；上线前仍应在目标环境验证。
• 社区来源（community）技能，内容以发布者维护的 SKILL.md 为准；升级可用 skillhub 的更新能力（参见 SkillHub 安装文档），并关注 SkillHub 上的版本号（当前 1.0.1）。
• 公开页面上可见的统计（如评分、下载次数）会随时间变化；撰写时 SkillHub 资料侧为评分 100000、下载 1052、安装 0，与页面展示可能不完全一致，以安装时商店页面为准。

结尾¶

PostgreSQL 数据库 Skill 把「高效查询、表结构与索引、schema 设计」收敛成可加载的 Agent 技能，适合用 psql、pgcli、PostgreSQL、SQL 等触发词在日常开发对话中唤起。安装入口与坐标：

• 展示与说明：https://www.skillhub.cn/skills/user_f12a44b7/self-dev-pg
• 安装坐标：@user_f12a44b7/self-dev-pg（配合 https://skillhub.cn/install/skillhub.md 与 skillhub install … --dir <skills 目录>）