Neon Agent Skills（Neon 后端开发技能包）

# Neon Agent Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能、插件文件或 Neon CLI。这些都来自 Neon 的仓库：https://github.com/neondatabase/agent-skills

许可证：Apache-2.0。全文见 https://github.com/neondatabase/agent-skills/blob/main/LICENSE

Neon Agent Skills 由 Neon 制作。README 把 Neon 描述为一组围绕 Lakebase Postgres 的云后端组件，来自 Databricks。它并非 Anthropic 制作或背书，Mindket 也和 Neon 没有关联。

这些说明的来源：README（https://github.com/neondatabase/agent-skills/blob/main/README.md），https://github.com/neondatabase/agent-skills/tree/main/skills 下每个技能的 SKILL.md，插件文件 plugin.json、mcp.json、kimi.plugin.json 和 .claude-plugin/marketplace.json，以及 CONTRIBUTING.md。Claude Code 插件和技能的相关事实，出自 Claude Code 自己的文档（https://code.claude.com/docs/en/discover-plugins 和 https://code.claude.com/docs/en/skills），用到的地方都注明了。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

七个技能，教智能体在 Neon 上开发。Neon 是围绕 Lakebase Postgres 的一组后端组件。技能的总览说，这些组件都一起分支：分支是你数据的写时复制克隆，其他组件也跟着它走。

| 技能 | 涵盖内容 |
|---|---|
| neon | 总览：选择 Neon 组件、Neon CLI 和 MCP 服务器、分支优先的工作流、neon.ts、日志 |
| neon-postgres | 连接、连接池和直连的连接串、迁移、分支、自动扩缩容、缩容到零、恢复、只读副本、出站流量、搜索 |
| neon-auth | 用 Managed Better Auth 给新应用做登录，以及什么时候保留或自托管别的提供方 |
| neon-object-storage | 兼容 S3、随数据库一起分支的文件存储 |
| neon-functions | 部署在分支上、长时间运行的 Node.js 无服务器函数，支持 WebSocket 和 SSE 服务器以及触发器 |
| neon-ai-gateway | 一个 API、一个 Neon 凭据，调用多家提供商的 LLM 和嵌入模型 |
| neon-realtime | 给响应式应用和智能体用的实时 SQL 查询。技能说它还是测试版 |

来源：每个技能的 frontmatter 和正文。README 还列了第八个技能 neon-postgres-agent-platforms，面向为用户运行 Neon 的平台。它在另一个仓库 neondatabase/neon-for-agent-platforms 里，不在本工具包指向的仓库中。

## 工具包里的文件

- setup/claude-code.md：README 给 Claude Code 的插件安装方式，以及 skills CLI 那一行
- setup/cursor.md：README 里的 Cursor 插件命令
- setup/antigravity.md：README 里的 Antigravity 插件命令
- setup/kimi-code.md：README 里的 Kimi Code 插件命令
- setup/pi.md：README 里的两行 Pi 命令
- setup/other-agents.md：skills CLI 那一行、可移植的插件文件，以及 Neon CLI 自带的 skills 命令
- setup/first-run.md：账号、Neon CLI、登录、区域、额度，以及这些技能会改动什么

## 先准备好这些

- 一个能加载技能或插件的智能体。README 点名了 Claude Code、Cursor、Antigravity、Kimi Code 和 Pi。
- 大多数工作需要一个 Neon 账号。总览技能提到有免费套餐，还有一条不需要账号、用临时数据库的路线，这种数据库会过期（见 setup/first-run.md）。
- Node 和 npm，用于 Neon CLI，这些技能优先用它，而不是 MCP 服务器。
- 用 Object Storage、Functions、AI Gateway 和 Realtime 时，项目要在技能列出的四个 AWS 区域之一（见 setup/first-run.md）。
- 用 AI Gateway 时，需要预付额度。技能说，在任何套餐上，没有绑卡并购买额度之前，所有模型都不可用。

## 装到了哪里

- 插件方式：七个技能和 Neon MCP 服务器，由你的智能体管理。
- skills CLI 方式：只有技能。README 没说它会写到哪个文件夹，也没说会不会添加 MCP 服务器。
- 在 Claude 处理的项目里：neon link 之后会有一个被 git 忽略的 .neon 文件，一个 neon.ts 文件，以及一个存着分支数据库地址和其他值的 .env 或 .env.local 文件。别把这个文件提交进 git。

## 你的数据

这些技能会让 Claude 读 neon.com 上的 Neon 文档。通过 Neon CLI 或 MCP 服务器，Claude 可以操作你的 Neon 账号：创建项目和分支、运行 SQL、应用 neon.ts 和部署函数。neon 技能说，用 OAuth 时你在授权页面上选择权限范围，neon mcp 还有一个 --read-only 参数。plugin.json 的描述说，授权时你可以选择只读或完全访问。见 setup/first-run.md。

任务完成后，neon 技能会让 Claude 在反馈命令不用问你也能运行时，向 Neon 发一份关于 Neon 可修复问题的反馈报告。技能说绝不能包含密钥等机密或个人数据。不想这样的话，告诉 Claude。

你贴给或交给 Claude 的内容，和其他 Claude 工作一样会发给 Claude。

## 更新和删除

neon 技能说，每次会话都要用 neon skills status 检查技能，用 neon skills update -y 更新，而通过插件安装的技能会自动更新。README 的迁移说明说，如果你装过 neon-postgres-branches 或 neon-postgres-egress-optimizer，要更新 neon-postgres，并删掉那两个旧的技能文件夹。Claude Code 的插件文档讲了怎样在 /plugin 里更新和卸载插件。

README.md  5 KB
setup/antigravity.md  814 B
setup/claude-code.md  3 KB
setup/cursor.md  698 B
setup/first-run.md  5 KB
setup/kimi-code.md  624 B
setup/other-agents.md  2 KB
setup/pi.md  621 B