用途
该技能为 PlanetScale 及相关数据库、仓库、凭证、网络与自动化操作设定显式的审批门禁,目的是防止 AI 代理因自主行动或误操作而影响可用性、安全性、数据安全或开发者工作流。它属于操作规范类技能,不提供具体的数据库操作功能,而是约束代理在执行操作前后必须满足的条件。
主要能力
技能将操作按风险划分为五个等级:
- A 类(默认只读):无需审批,包括列出数据库、分支、keyspace、webhook、备份、角色、流量预算、schema 建议、部署请求与 Insights 数据,检查仓库代码,读取 schema 元数据和非敏感数据库元数据,生成报告与变更集。
- B 类(创建状态的提案):默认允许;仅在操作员要求严格禁止变更模式时才需审批。包括通过 API POST 创建查询模式报告、触发 webhook 测试事件、创建临时本地分支或文件、在外部工具中开 PR 或 issue、创建数据库开发分支、在非生产开发分支上应用 DDL 或迁移、开启面向受审查工作流保护分支的部署请求。技能特别说明:最后三项属于既有审查系统内的提案,在人工合并或部署前不会到达生产,门禁应放在合并/部署动作(C/D 类)上,代理因开 PR 而停下请求许可是分类错误。
- C 类(改变行为):始终需要显式审批,包括启用/禁用安全迁移、更改部署请求审批设置、创建/更新/删除 Traffic Control 预算或规则、将流量预算移至强制模式、创建/更新/删除 webhook、启用原始查询收集、启用/禁用需要重启的扩展或设置、创建/更新/删除角色、重置密码、更改 pg_strict 设置、更改连接池行为、更改 IP 限制/PrivateLink/PSC/公共访问、更改备份计划或保留策略、创建恢复分支、创建超出自动备份的备份、更改分支大小或副本拓扑、编辑仓库文件或依赖。
- D 类(影响生产数据/可用性):需要显式审批、命名目标确认、回滚计划,并建议第二人复核,包括生产 DDL、生产 DML、将 schema 建议应用于生产、将 Vitess 部署请求排队或应用到生产、提升或恢复分支、删除分支/数据库/角色/webhook/备份/流量规则、在生产强制 Traffic Control、更改生产网络访问、轮换生产凭证、高负载期间紧急备份。
- E 类(永不自主执行):无直接人工操作或单独批准的故障处理流程时绝不执行,包括删除生产数据库、禁用所有生产安全机制、删除生产表或列、移除 IP 限制或仅私有访问姿态、在日志/issue/PR/Slack/报告中存储或暴露密钥、自动合并由数据库遥测生成的代码、自动应用 LLM 生成的 DDL。
使用方式
技能定义了一套执行流程:
- 有效审批要求:必须包含变更 ID、目标组织/数据库/分支、是否影响生产、执行确切动作的权限。无效审批包括“执行最佳实践”“修复一切”“应用建议”以及未指明变更 ID 的“继续”。
- 自主执行例外:唯一替代逐项审批的方式是风险确认自主模式,需操作员显式确认风险、命名范围并说明是否包含生产;该确认仅替代命名范围内的 B/C 类(含生产时为 D 类)的逐项审批。E 类在任何措辞下都不会解锁;C/D 类仍需生成执行前检查清单(以执行计划形式展示,而非停下等待);仍需执行后报告;范围外工作仍需要新审批或新确认。
- 执行前检查清单:任何 C 或 D 类动作前须产出确切命令/API 端点/仪表盘操作/SQL/仓库 diff、目标确认、预期效果、可用性影响、数据风险、安全风险、回滚计划、验证计划、监控计划,然后停下等待审批。
- 执行后报告:获批变更执行后须报告变更内容、时间、审批人、所用接口、成功证据、警告、回滚状态、后续监控。
- 拒绝行为:面对宽泛或模糊的生产变更指令时,须拒绝宽泛动作并产出更安全的具名变更计划,使用固定句式:“I will not apply broad production changes from an ambiguous instruction. I can produce a named change set with risk and rollback details.”
适用场景
适用于使用 AI 代理操作 PlanetScale 数据库及其周边基础设施(仓库、凭证、网络、自动化)的团队,尤其是需要防止代理未经授权修改生产环境、变更安全配置或执行高风险操作的场景。
限制
该技能是行为约束规范,不提供具体命令示例或 API 细节;其自主执行例外依赖另一个技能文件(../13-autonomous-execution-mode/SKILL.md),该文件内容本次资料未提供。技能本身不涉及收费、平台或效果方面的信息。