메뉴
使用 Neon Serverless Postgres 的指南和最佳实践。涵盖入门、使用 Neon 进行本地开发、选择连接方式、Neon 功能、身份验证 (@neondatabase/auth)、PostgREST 风格的数据 API (@neondatabase/neon-js)、Neon CLI 以及 Neon 的平台 API/SDK。用于任何与 Neon 相关的问题。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
使用 Nitro v3 框架和 H3 编写服务端 API 的技能。适用于后端接口开发、Mock 数据迁移到 Neon 数据库、以及编写符合 Drizzle ORM 标准的查询逻辑。当需要开发新的 CRUD 接口或修复现有后端逻辑时使用此技能。
规范类型项目（apps/type）的代码组织方式、导出语法和文件结构。用于解决类型导出冲突、创建统一导出入口、处理重复导出等问题。适用于类型项目开发、类型错误修复、代码规范实施场景。在处理类型项目的代码写法时，请使用本技能。
当你修改数据库结构或种子生成脚本时，请务必阅读并遵循此指南，以防止性能问题、数据一致性崩溃和部署失败。新 Schema 应在 apps/type 中创建。
数据库 Schema 变更时的全项目同步检查清单。当修改 apps/type 中 schema.ts 的表字段、新增数据库表、或删除表时，使用此技能确保类型项目、数据库迁移、后端接口、前端页面、种子数据和技能文档全部同步更新，避免遗漏。
当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。
新建公共组件规范专家 - 指导在 src/components/common 目录下创建符合项目规范的公共组件，包括文件结构、TypeScript 类型、Vue 组件、文档和测试页面。 触发条件（满足任意一项即触发）： - 任务包含"新建组件"、"公共组件"、"common 组件"、"创建组件"等关键词 - 需要在 src/components/common 目录下创建新组件 - 需要创建可复用的业务组件（如表单分区标题、操作按钮组、信息展示卡片） - 需要编写组件的 TypeScript 类型定义 - 需要编写组件使用文档（index.md） - 需要创建组件测试页面（src/pages/test-use/） - 用户提及"组件规范"、"组件文档"、"组件测试"等关键词 必须协同的技能： - beautiful-component-design（组件美化时）- 图标、响应式设计、表单分区标题 - component-migration（从旧组件迁移时）- ColorUI → wot-design-uni - use-wd-form（组件内包含表单时）- 表单结构、wd-picker、校验规则 禁止事项： - 禁止在 components 目录外创建公共组件 - 禁止不编写组件文档（index.md） - 禁止不提供使用示例和测试页面 - 禁止组件命名不规范（必须使用短横线命名法） - 禁止不定义 TypeScript 类型（types.ts） - 禁止在组件文件顶部不添加说明注释 - 禁止不使用 withDefaults 设置 props 默认值 覆盖场景：所有需要跨页面复用的业务组件，包括表单分区标题（FormSectionTitle）、操作按钮组（ActivityActions）、信息展示卡片（ActivityInfo）、加载状态组件（ZPagingLoading）等。
| name | neon-postgres-zh |
| description | 使用 Neon Serverless Postgres 的指南和最佳实践。涵盖入门、使用 Neon 进行本地开发、选择连接方式、Neon 功能、身份验证 (@neondatabase/auth)、PostgREST 风格的数据 API (@neondatabase/neon-js)、Neon CLI 以及 Neon 的平台 API/SDK。用于任何与 Neon 相关的问题。 |
Neon 是一个无服务器 Postgres 平台，它将计算和存储分离，以提供自动扩缩容、分支、即时恢复和缩减到零的功能。它与 Postgres 完全兼容，适用于任何支持 Postgres 的语言、框架或 ORM。
在提出与 Neon 相关的声明之前，请务必参考 Neon 文档。文档是所有 Neon 相关信息的真实来源。
下面你会找到一份按关注领域组织的资源列表。这旨在帮助你找到正确的文档页面以获取和补充更多上下文。
你可以使用 curl 命令以 markdown 格式获取文档页面：
文档：
# 获取所有 Neon 文档列表
curl https://neon.com/llms.txt
# 以 markdown 格式获取任何文档页面
curl -H "Accept: text/markdown" https://neon.com/docs/<path>
不要猜测文档页面。使用 llms.txt 索引查找相关 URL 或关注下面资源中的链接。
根据用户需求参考相应的资源文件：
| 领域 | 资源 | 适用场景 |
|---|---|---|
| 什么是 Neon | references/what-is-neon.md | 了解 Neon 概念、架构、核心资源 |
| 参考文档 | references/referencing-docs.md | 查找官方文档，验证信息 |
| 功能特性 | references/features.md | 分支、自动扩缩容、缩减到零、即时恢复 |
| 快速开始 | references/getting-started.md | 设置项目、连接字符串、依赖项、模式 |
| 连接方式 | references/connection-methods.md | 根据平台和运行环境选择驱动程序 |
| 开发者工具 | references/devtools.md | VSCode 扩展、MCP 服务器、Neon CLI (neon init) |
用于无服务器/边缘函数的 HTTP/WebSocket 查询。
| 领域 | 资源 | 适用场景 |
|---|---|---|
| Serverless Driver | references/neon-serverless.md | @neondatabase/serverless - HTTP/WebSocket 查询 |
| Drizzle ORM | references/neon-drizzle.md | Drizzle ORM 与 Neon 集成 |
Neon 的身份验证和 PostgREST 风格数据 API。
| 领域 | 资源 | 适用场景 |
|---|---|---|
| Neon Auth | references/neon-auth.md | @neondatabase/auth - 仅身份验证 |
| Neon JS SDK | references/neon-js.md | @neondatabase/neon-js - Auth + Data API (PostgREST 风格查询) |
通过 REST API、SDK 或 CLI 以编程方式管理 Neon 资源。
| 领域 | 资源 | 适用场景 |
|---|---|---|
| 平台 API 概览 | references/neon-platform-api.md | 通过 REST API 管理 Neon 资源 |
| Neon CLI | references/neon-cli.md | 终端工作流、脚本、CI/CD 管道 |
| TypeScript SDK | references/neon-typescript-sdk.md | @neondatabase/api-client |
| Python SDK | references/neon-python-sdk.md | neon-api 包 |