核心用法
PlanetScale CLI Skills 是面向 PlanetScale 数据库管理终端操作的综合性技能包，核心围绕 pscale 命令行工具展开。该技能覆盖 9 大子技能模块：认证管理（auth）、分支操作（branch）、部署请求（deploy-request）、数据库管理（database）、备份恢复（backup）、密码管理（password）、组织切换（org）、服务令牌（service-token）等。
典型工作流程包括：
1. 分支开发模式：从 main 创建特性分支 → 隔离修改 schema → diff 比对 → 创建部署请求
2. 模式迁移工作流：创建开发分支 → shell 直连修改 schema → 生成部署请求 → 审批后上线
3. CI/CD 集成：创建服务令牌 → 配置环境变量 → 自动化部署（支持 --auto-approve）
技能内置 3 个自动化脚本（create-branch-for-mr.sh、deploy-schema-change.sh、sync-branch-with-main.sh），可直接执行无需加载上下文，节省约 90% Token。
显著优点
- 官方生态完整：直接对接 PlanetScale 原生 CLI，非第三方封装，API 兼容性最佳
- DevOps 友好：分支即环境的设计理念与 Git 工作流深度契合，支持 MR/PR 联动
- 安全可控：支持服务令牌（Service Token）与人机分离的 CI/CD 场景，避免密码硬编码
- 决策树清晰：内置多组决策流程图（分支 vs 部署请求、服务令牌 vs 密码），降低使用门槛
潜在缺点与局限性
- 平台锁定：仅支持 PlanetScale，无法迁移至其他 MySQL/PostgreSQL 托管服务
- 依赖 CLI 二进制：必须本地安装
pscale，Windows 支持弱于 Unix 系统 - 脚本兼容性：部分脚本依赖 PCRE-enabled grep（
grep -oP），BSD/macOS 需调整 - Token 管理手动：服务令牌需用户自行配置环境变量，无自动轮换机制提示
适合人群
- 使用 PlanetScale 作为生产数据库的全栈开发团队
- 追求Git 式数据库工作流的工程师（分支开发 → PR 评审 → 合并部署）
- 需要CI/CD 自动化数据库变更的 DevOps/SRE 角色
- 已在使用 Drizzle ORM、GitHub/GitLab 集成的技术栈团队
常规风险
- 认证令牌泄露风险：
PLANETSCALE_SERVICE_TOKEN若泄露可导致数据库访问权限被滥用，建议配合最小权限原则与定期轮换 - 分支直接提升风险：
pscale branch promote绕过部署请求审批，生产环境应避免使用 - 自动审批隐患：CI/CD 中使用
--auto-approve需配合严格的代码准入审查，防止恶意 schema 变更直接上线