该技能用于让自动化代理学会以非交互方式调用 PlanetScale 命令行工具 pscale，属于 CLI 调用约定层面的指导，不涉及具体的运维工作流。资料说明，数据库清点、安全审查、schema 建议等操作流程应使用同仓库中的其他技能，完整评估从 ../00-safe-orchestrator/SKILL.md 开始。
主要能力与用途：
- 启动引导：先运行 pscale agent-guide --format json 和 pscale auth check --format json。若认证检查返回 "status": "action_required"，按 JSON 中的 issues 和 next_steps 处理；登录可能需要人工在浏览器确认，可使用 pscale auth login --format json。
- 明确两份 AGENTS.md 文档的区别：CLI 代理指南随 pscale 发布（CLI 仓库中的 AGENTS.md，或 pscale agent-guide），说明如何调用 pscale（认证、--format json、标志位置、pscale sql）；项目代理指南是应用仓库自己的 AGENTS.md，记录组织、数据库、分支、引擎、生产分支、MCP 范围和审批规则。未经操作员批准，不得修改项目 AGENTS.md。
使用约定：
- 自动化时始终传 --format json。
- --org <org> 放在资源子命令上（database、branch、sql、api 等），不要放在根 pscale 上。
- 位置参数放在标志之前，例如 pscale sql mydb main --org bb …。
- 使用 pscale sql，不要用需要 TTY 的 pscale shell。
- 默认 SQL 角色为 reader；写入需传 --role admin（或 writer/readwriter）。--role 与 --replica 的语义与 pscale shell 保持一致。
- --force 只作用于具体子命令（例如 database delete … --force、pscale sql … --force），没有全局 --force 或 PSCALE_FORCE。
- 仅 --format json 不会跳过确认；在用户明确批准后，需在破坏性操作子命令上添加 --force。
典型工作流示例： pscale auth check --format json pscale org list --format json pscale database list --org <org> --format json pscale branch list <database> --org <org> --format json pscale sql <database> <branch> --org <org> --format json --query "SELECT 1"
MySQL 默认使用 @primary（与 pscale shell 相同）；仅多 keyspace 数据库需要传 --keyspace。
MCP 与 CLI 的分工：MCP 客户端使用托管的 PlanetScale MCP 服务器（当前 URL 见 pscale agent-guide --format json）；Shell 脚本和编码代理则按上述方式使用带 --format json 的 pscale。
如需超出基本 CLI 调用的数据库操作，可安装完整 PlanetScale 技能包： git clone https://github.com/planetscale/skills.git && cd skills && script/setup
或：npx skills add planetscale/skills -g -y
然后运行子技能或 ../00-safe-orchestrator/SKILL.md。
当前约定的权威来源：优先以实时输出为准，而非记忆中的标志语法，即运行 pscale agent-guide --format json；其嵌入的 guide 字段包含随 pscale 二进制发布的完整 CLI 代理指南。
限制：该技能只覆盖 CLI 调用约定，不提供运维工作流、安全审查或 schema 建议；具体命令参数与行为以 pscale 实时输出为准。