1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | database-skills |
| 作者/维护者 | PlanetScale（官方组织仓库，GitHub API 已核实） |
| 来源链接 | https://github.com/planetscale/database-skills |
| 许可证 | MIT（GitHub API 已核实） |
| GitHub Stars | 549（GitHub API 实时数据） |
| Forks | 45（GitHub API 实时数据） |
| 最新版本 | 无正式 Release 标签；创建于 2026-02-18，最近提交 2026-06-08，持续滚动更新 |
| 安装方式 | npx skills add planetscale/database-skills；Cursor 内 /add-plugin database-skills |
2. 功能介绍与亮点
PlanetScale 官方发布的数据库知识包，把关系型数据库设计与运维经验封装成 4 个独立 SKILL.md：mysql（schema、索引、分区、事务锁、性能排查）、postgres（PlanetScale Postgres 最佳实践，MVCC/VACUUM、WAL 调优、连接池）、vitess（分片、VSchema、MySQL 兼容水平扩展）、neki（PlanetScale 分片 Postgres 产品架构）。
亮点：① 纯文档技能，无需脚本或账号；② mysql/postgres/vitess 三项对任何自建数据库通用，不锁定 PlanetScale 付费产品；③ 每个子技能统一遵循“设计→索引→分区→查询优化→事务锁→运维→护栏”结构，护栏章节明确安全变更边界。
3. 适用场景
所属分类：工程效率与代码质量
面向用 MySQL/PostgreSQL/Vitess 做应用开发的初中级 Coding Agent 用户：新建或重构表结构与索引、诊断慢查询与锁等待、规划分库分表、排查复制与连接问题；也适合希望获得结构化最佳实践而非零散建议的数据库新手。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方主页 db-skills.com 的 “Works With” 列表明确列出
- Codex：✅ 原生支持——同一官方来源列出
- OpenClaw：❓ 未验证——遵循开放 SKILL.md 约定，理论可手动接入，但无官方/第三方明确说明
- Hermes Agent：❓ 未验证——同上，无可核实证据
5. 推荐理由
PlanetScale 官方出品，把 MySQL/PostgreSQL/Vitess 的设计、索引、事务、运维经验系统化为结构清晰的参考技能，纯文档无代码执行，装上即用，且不锁定自家付费产品。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 549 stars（200–1k 区间中上）+ 官方一线数据库厂商出品 |
| 可用性 | 9 | 一条命令安装，文档结构清晰，5 个月内创建且持续更新（6 位贡献者），无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.3 | 三项均值，高于 7.0 门槛 |
安全检查清单： ① shell 执行：否——纯 Markdown，已抓取 mysql/SKILL.md 原文核实 ② 联网外发：否——文档未提及运行时网络调用 ③ API key/凭据：否 ④ 可疑指令：否——原文逐段核对，未见提示词注入 ⑤ 作者信誉：知名开源数据库云厂商官方组织 ⑥ License：MIT，清晰 ⑦ 维护时间：近 2 个月内有提交，未 archived ⚠️ 扣分项：第三方审计平台 Tessl（基于 Snyk）标注 mysql 子技能为“Advisory，建议复核”，vitess/postgres 为“Passed”；因该技能不含可执行代码，此提示更可能是内容规范性建议而非漏洞
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 代码执行/联网 | 是否锁定自家产品 |
|---|---|---|---|
| database-skills（本次推荐） | 多引擎设计与调优参考 | 否，纯文档 | 否，通用知识 |
| Railway Skills | Railway 平台部署运维 | 是，需 CLI+登录+联网 | 是，绑定 Railway |
| Netlify context-and-tools | Netlify 12 项能力参考 | 否，但内容专属 Netlify | 是，绑定 Netlify |
| MongoDB Schema Design | MongoDB 文档库 schema 设计 | 否，纯文档 | 是，仅限 MongoDB |
核心差异化：上述同类方案中唯一同时满足“零代码执行”与“不锁定单一厂商”——即便不用 PlanetScale，自建 MySQL/PostgreSQL/Vitess 环境也能复用其中 3/4 内容。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价：Reddit / Hacker News 等平台未见针对该技能包本身的独立用户评论（仅有 PlanetScale 公司产品的历史讨论，与本技能无直接关联）。第三方平台 Tessl 提供自动化质量评分（mysql 92%、postgres 70%、vitess 59%、neki 31% 最佳实践符合度），但属自动化评估而非用户评价。
9. 其他补充
仓库采用开放贡献模式：Fork → 在 skills/ 下新建目录 → 编写 SKILL.md 与可选 references/ → 提交 PR，社区可扩展至其他数据库引擎。
10. 安装使用方式
- 通用安装（适配 Claude Code/Codex 等多个 Agent）：
npx skills add planetscale/database-skills - Cursor 专用：Chat 中执行
/add-plugin database-skills - 安装后无需重启，Agent 按需读取对应子技能（mysql/postgres/vitess/neki）；通用数据库知识部分无需 API Key 或账号
11. 注意事项
- postgres、neki 两个子技能偏向 PlanetScale 自家产品特性，非 PlanetScale 用户建议优先参考 mysql/vitess
- mysql 子技能被第三方自动化审计标注 “Advisory”，采用前建议自行复核关键建议是否适配自己的数据库版本
- OpenClaw、Hermes Agent 兼容性未获确认，如需使用建议先手动测试 SKILL.md 能否被正确加载