前言¶
给新项目或原型配 Postgres，常见路径是注册云账号、建项目、等实例就绪，再把 DATABASE_URL 写进环境变量。做演示、跑集成测试、或让本地脚手架在缺少数据库时自动补齐时，这套流程往往偏重。
下面介绍 Neon 在 agent-skills 仓库里提供的 claimable-postgres Skill：它把「通过 Neon Claimable Postgres 即时开通临时库」写成 Agent 可遵循的说明，目标是一次 API 调用或一条 CLI 命令就拿到真实 Postgres 连接串，无需先建账号、登录控制台或绑卡。
这是什么¶
claimable-postgres 是面向编码助手的 Agent Skill（通用 SKILL.md 格式），由 Neon 维护，收录在 neondatabase/agent-skills 的 skills/claimable-postgres 目录；在 officialskills.sh 上也有条目。
它解决的是：在 Agent 工作流里，如何按规范调用 Neon 的 Claimable Postgres 服务，为当前任务临时 provision 一个 Postgres 实例，并把连接信息交给后续开发或测试步骤使用。
与「先手动在 Neon 控制台建库」相比，Claimable Postgres 把「给 Agent 配数据库」做成可脚本化、可 Skill 化的基础设施能力：默认是临时库，需要长期保留时再认领（claim）到 Neon 账号。
核心功能¶
以下能力均来自官方 Skill 说明，未在资料中出现的细节不展开。
-
即时开通临时 Postgres
通过 Neon Claimable Postgres 服务 provision 数据库，无需账号、登录或信用卡。 -
真实连接串
一次 API 调用或一条 CLI 命令即可得到可用的 Postgres connection string，无需先配 Dashboard、也无需等待传统建库流程。 -
生命周期
未认领的数据库在 72 小时后过期；若需长期使用，可将实例 claim 到 Neon 账号。 -
与 Agent 任务对齐的用法指引
Skill 会指导助手在合适场景下代你完成开通、写入DATABASE_URL、用 SQL 文件灌数等（具体命令以安装后 Skill 内文档为准）。
安装与启用¶
官方推荐的安装方式如下。把仓库与 skill 名写全，避免装错包。
npx skills add https://github.com/neondatabase/agent-skills --skill claimable-postgres
也可以把 Skill 目录链接交给编码助手，请其按该 Skill 安装：
https://github.com/neondatabase/agent-skills/tree/main/skills/claimable-postgres
资料中未区分 Cursor、Codex CLI、Claude Code 的安装差异；若你使用的工具支持 npx skills add 或等价「从 URL 添加 Skill」能力，按上式即可。安装完成后，在对话中说明你需要 Postgres（例如新项目缺 DATABASE_URL），助手应能按 Skill 调用 Claimable Postgres 相关流程。
典型用法（官方场景）¶
官方「When to use it」列出的场景，可作为你与 Agent 协作时的提示语，而不是编造的具体命令：
-
新项目还没有
DATABASE_URL
在不创建 Neon 账号的前提下，先拿到可连接的 Postgres，再继续搭应用或迁移。 -
演示或原型用的即用即弃库
短期 demo 不需要长期实例，用完可依赖 72 小时过期策略，或按需 claim。 -
集成测试
对真实 Postgres 跑测试，而不在 CI 或本机维护一套持久化安装。 -
Vite 等项目启动时自动补库
当项目启动且环境里没有DATABASE_URL时，由 Skill 引导自动 provision。 -
用 SQL 文件初始化数据
在全新 Postgres 上，通过单次 CLI 流程执行 SQL 种子文件（具体子命令以 Skill 正文为准）。
经过上面的步骤，典型工作流是：安装 Skill → 在任务里声明需要数据库 → Agent 按 Skill 开通并回传连接串 → 你的应用或测试使用 DATABASE_URL；若要保留实例，再在 Neon 侧完成 claim。
适用场景与注意¶
适合谁
- 用 AI 编码助手做全栈原型、需要 Postgres 但不想先注册云账号的开发者。
- 需要在测试或本地脚手架里偶尔要真实 Postgres、又不想维护 Docker Compose 或共享测试库的团队。
- 希望把「开库」写进 Agent playbook，而不是每次口头描述 Neon 文档的维护者。
限制与注意
- 默认是临时库，72 小时未 claim 会过期；生产或长期数据应 plan 认领或改用常规 Neon 项目。
- 资料强调无需账号即可开通；认领与长期治理仍与 Neon 账号体系相关，具体步骤以 Neon Claimable Postgres 官方文档为准。
- Skill 描述的是 一次 API 或 CLI 即可获得连接串；若你环境无法访问 Neon 服务或
npx skills网络受限，需要先解决网络与工具链，再依赖本 Skill。 - 本文未收录完整
SKILL.md正文；API 路径、CLI 子命令、claim 流程请以安装后的 Skill 文件及 Neon 官方说明为唯一依据。
结尾¶
claimable-postgres 把 Neon Claimable Postgres 产品能力封装成 Agent Skill：无账号即可拿到真实 Postgres 连接串，适合原型、测试和自动化补库；临时实例有过期与认领机制，避免与长期生产混用。
- Skill 目录（官方）：https://github.com/neondatabase/agent-skills/tree/main/skills/claimable-postgres
- 安装与简介（officialskills.sh）：https://officialskills.sh/neondatabase/skills/claimable-postgres
