前言¶
給新項目或原型配 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
