PlanetScale safe orchestrator 是一个主控技能,用于端到端运行完整的 PlanetScale 安全最佳实践技能包:按顺序加载并执行每个子技能,累积证据,最终产出一份统一的建议报告。第一轮默认仅做评估。
安全约定(不可协商)
默认只读。可以检查配置、分支、查询遥测、建议、Webhook、角色、备份、流量预算和仓库代码;但未经明确批准具名变更集,不得变更 PlanetScale、数据库、仓库、网络配置、凭据、Schema、生产流量控制或自动化端点。Class C/D/E 变更需按 ../11-change-gates-and-approval-contract/SKILL.md 审批;拿不准时应停止,并把事项加入拟变更集而非执行。唯一例外:若操作者按 ../13-autonomous-execution-mode/SKILL.md 明确承认风险并指定范围,则在自治模式下执行。子技能为与本技能同级的文件夹(如 ../01-readonly-inventory/SKILL.md);若安装器把文件夹重命名为 frontmatter 名称,则按名称匹配定位。CLI 与 API 用法应以官方文档为准:文档索引 https://planetscale.com/docs/llms.txt (在文档 URL 后加 .md 获取 Markdown 版),API 参考 https://planetscale.com/docs/openapi.yaml 。命令或端点失败时先查文档,不要把工具或访问失败写进客户报告,而应记入内部运行日志。
使用前准备
完整阅读本文件;把进度清单复制到工作笔记;收集输入(组织 slug、数据库名、分支名、引擎 Vitess 或 Postgres、生产分支、应用仓库路径、应用语言/框架/ORM/连接池、操作者容忍度:仅报告、生成 PR、仅分支迁移或受监督的生产应用),缺失则继续发现,不必因不完整而阻塞。
执行计划(11 个阶段)
阶段 0:读取变更门与审批约定,理解操作类别 A–E,后续阶段默认在 Class A 下运行。阶段 1:只读盘点,产出带证据的清单表(来源、路径/命令、时间戳、置信度)、缺失证据表、风险标记、确认引擎与分支拓扑。阶段 2:按引擎二选一运行 Vitess 或 Postgres 安全审查,产出引擎特定安全缺口、工作流缺口和需审批的拟变更。阶段 3:查询洞察与标签,产出查询风险表、标签覆盖表、不良/高基数标签、推荐标签方案、候选 Traffic Control 切片及 Schema/代码变更候选。阶段 4:Traffic Control(仅 Postgres;Vitess 标记 N/A),产出预算建议(名称、模式、流量切片、规则类型、限额理由、测试/回滚计划);若标签薄弱则先做标签、推迟强制模式建议。阶段 5:Webhook 自动化,产出 Webhook 清单、缺失订阅、目标质量审查、自动化机会和不安全自动化风险。阶段 6:Schema 建议智能体循环,逐条分诊(类型、严重度、证据、安全实施路径、验证/回滚计划)。阶段 7:代码库 SQLCommenter 埋点(无仓库则跳过并在报告注明“未审查仓库”),产出检测到的技术栈、当前标签状态、推荐包/路径、标签方案和可能改动的文件。阶段 8:MCP 智能体运营模型,产出推荐 MCP 服务器、AGENTS.md 补充内容、允许/禁止的自治工作、建议的智能体循环。阶段 9:最佳实践矩阵覆盖核对,对每项记录是否适用、当前状态、缺口、建议 ID 和审批要求,只读补齐缺失证据。阶段 10:统一客户报告,合并去重并按影响排序。阶段 11:停止门,确认未执行 Class C/D/E 动作、每个拟变更都有 ID/目标/接口/影响/风险/回滚/测试计划,并以规定语句结尾。
建议 ID 前缀:OBS(洞察与标签)、VIT(Vitess)、PG(Postgres)、WEB(Webhook)、APP(仓库埋点)、AGENT(MCP 与智能体)。排序优先级:生产安全与可用性风险最高,其次是阻碍诊断或 Traffic Control 的可观测性缺口、降低平均检测/响应时间的自动化、有明确证据的性能与 Schema 改进。
报告最低结构
范围(组织、数据库、分支、引擎、仓库、接口、时间窗口;已应用变更:无)、执行摘要(3–7 条)、当前状态(附证据)、建议(带 ID 的排序表)、需审批的拟变更集、有意未变更清单、证据附录。结尾固定语句:“No changes have been applied. Approve specific change IDs before any mutation.”
部分运行与后续
MCP/CLI/API/仓库不可用时,用可用接口继续、记录缺失证据、降低相关建议置信度,不得臆造状态,未知即标记未知。报告后两条路径:按变更 ID 逐项审批执行,或操作者在明确承认风险并指定范围后进入自治模式,按依赖顺序执行并持续汇报状态、逐步验证并遵守停止规则。不得把“应用最佳实践”“修复一切”“继续”等模糊表述视为审批或风险承认。
快速调用
用户说“运行完整评估”或“运行所有 PlanetScale 最佳实践技能”时:加载本技能,按顺序运行阶段 0–11,返回统一报告,然后停止。