用途 该技能用于在完成数据库清单收集和相关审查步骤后,生成一份面向客户的 PlanetScale 最佳实践评估报告。报告目标是对客户数据库及其可选关联代码仓库给出准确、可执行、有证据支撑且安全的评估,并将建议与实际已应用的变更严格分开。
主要能力与报告结构 报告以纯 Markdown 为基线,包含标题化章节、正文和管道表格,可在任意智能体、终端或聊天界面中完整生成。必填章节包括: 范围(组织、数据库、已审查分支、引擎、已审查仓库、使用的接口、时间窗口、已应用变更); 执行摘要(3 至 7 条要点,首条以测量数据陈述平台当前运行基线,随后依次覆盖最高风险的安全缺口、最高价值的可观测性改进、自动化机会、引擎相关工作流缺口与仓库埋点缺口); 当前状态(数据库与分支拓扑、安全流程、可观测性、自动化、仓库埋点); 建议表(列含 ID、建议、目标、收益、风险、是否需要批准、是否先测试、证据); 需批准的拟议变更集(每项含 ID、精确目标、精确变更、所用接口、推荐理由、预期效果、可能的可用性影响、测试计划、回滚计划、是否影响生产); 有意未应用的变更说明; 证据附录(来源、命令/API/MCP/仓库路径、时间戳、值、备注)。 建议 ID 按类别前缀区分:OBS- 用于 Insights/查询标签,VIT- 用于 Vitess 安全与部署流程,PG- 用于 Postgres 角色、pg_strict、Traffic Control、PITR 与网络,WEB- 用于 Webhook 与自动化,APP- 用于仓库埋点,AGENT- 用于 MCP/智能体工作流。
写作与证据规范 报告语气为技术性、陈述式,不使用营销用语或情绪化表达。未启用的功能需以能力缺口及其量化影响来陈述,不得表述为正面发现;每条建议必须引用其针对的具体发现(指纹、指标、事件计数、时间窗口)。启用的功能需报告其可测量的当前作用及配置完整性。平台行为需以经验证的语义报告,无法验证时并列说明各接口的返回值并建议联系 PlanetScale 支持。
运行机制与发现分离 评估工具本身的失败(HTTP 状态码、MCP 错误、CLI 失败、令牌权限问题、超时、端点探测)属于运行日志,不属于数据库发现;无法收集证据之处标注为“本次运行未评估”,不附带错误细节。不得因调用失败就断定某功能未配置,需以成功调用返回空结果为依据。
限制与输出要求 该技能仅生成报告,不修改任何设置、模式、流量控制、角色凭据、Webhook 或代码,也不创建分支、备份、恢复、部署请求或迁移。报告结尾必须包含固定语句:“No changes have been applied. Approve specific change IDs before any mutation.” 若宿主智能体提供更丰富的渲染界面,可在 Markdown 报告之外附加使用,但不得替代 Markdown 报告。