Agent Skills
返回列表
💻

CloudBase PostgreSQL 云开发

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-postgresql-development-cloudbase。

技能介绍

要解决什么问题

在 CloudBase 里,PostgreSQL 模式与 NoSQL、MySQL 是并行能力,但前端与 MCP 侧调用的入口完全不同。常见失败模式包括:在 PG 任务里写 app.database()、db.collection(...).where(),上传仍用 app.uploadFile(),路由守卫依赖已过时的 getLoginState() 或 auth.getUser()。本技能针对「任务已明确是 CloudBase PG / app.rdb() / RLS / queryPgDatabase」的情形,把实现收敛到 PG 专用 API 与运维流程。

技能如何指导工作

  1. 先验环境:用 envQuery 查看 RuntimeBackends.postgresql 与 RuntimeMode;未开通 PG 时停止写 app.rdb(),并区分遗留 NoSQL 桶与 PG storage 桶名。
  2. Schema 优先:DDL 走 managePgDatabase 的 planMigration / applyMigration,本地 SQL 放在 cloudbase/migrations/,版本号与远程历史一致;建表前用 information_schema 核对列名,避免 CREATE TABLE IF NOT EXISTS 静默跳过导致字段不一致。
  3. 权限模型:理解 anon / authenticated / service_role 与 Publishable Key、API Key 的对应关系;表级 GRANT、序列权限、ENABLE ROW LEVEL SECURITY 与 CREATE POLICY 与前端 CRUD 同批设计。
  4. Web 链路:登录用 auth.signInWithPassword + auth.getSession();存储用 app.storage.from('bucket').upload 与 createSignedUrl;需要登录与通用 Web 验证时,按契约转读同级 auth-tool-cloudbase、auth-web-cloudbase、web-development 等 SKILL。

边界与注意点

  • 不要用 queryMysqlDatabase、manageMysqlDatabase 或 relational-database MySQL MCP 处理 PG 表。
  • 不要把 NoSQL 的 .where() / .orderBy() / .count() 照搬到 PG:应使用 .match() / .eq()、.order()、.select("*", { count: "exact" }) 等 PG 模式写法。
  • PG 与 NoSQL 可共存于同一环境:仅对任务明确要求落 PG 的新业务数据应用本技能;未要求时不要改写既有 NoSQL 集合与权限规则。

使用场景

  • 新建 PG 模式环境后,要用版本化迁移建业务表并一次性配置 GRANT 与 RLS 策略
  • 列表筛选页误用了 NoSQL 的 `.where()`,需改为 `app.rdb()` 下的 `.match()` / `.ilike()` 查询
  • CMS 要求文章与用户角色进 PostgreSQL,并先确认 `queryAppAuth` 已开启用户名密码登录
  • `applyMigration` 返回超时或 pending,需要用 `describeMigrationTask` 查状态而非重复推送同版本

适合人员

  • 维护 CloudBase 全栈站点的工程师,要在已开 PG 的环境里交付带登录的业务 CRUD
  • 从 NoSQL 示例改需求的前端,需在同一环境中把新模块落到 `app.rdb()` 且不能暴露 service_role
  • 用 MCP 管库的后端同学,希望 DDL 只走 `applyMigration` 而不是默认 `execute` 静默建表
  • 负责内容后台的产品工程化同学,要为编辑角色配置 RLS 且路由只认 `auth.getSession()`