PlanetScale 只读盘点（planetscale-readonly-inventory）是一个用于构建 PlanetScale 数据库证据化盘点且不进行任何变更的技能。其核心目的是在不修改平台状态的前提下，通过只读接口和文档依据收集组织、数据库、分支、Webhook、备份、角色、Insights、建议和流量配置等信息。
用途：该技能适用于需要对 PlanetScale 环境进行安全审计、健康检查或迁移前评估的场景，尤其适合希望获得可追溯证据而不触发任何写操作的团队。
主要能力：默认允许的只读操作包括：列出组织、数据库、分支、keyspace、区域和规模；读取分支元数据；读取 Webhook 配置；读取 Schema 建议；通过 MCP 或 API 读取查询洞察、异常和查询模式；读取流量预算和规则；读取 Postgres 角色及非机密角色元数据；读取备份计划和恢复元数据；读取分支 Schema；使用 Connections CLI 视图检查实时连接/会话元数据；检查仓库文件中的框架、ORM、迁移、SQL 标记和连接配置；检查 Terraform 或其他基础设施即代码定义中的 PlanetScale 角色、备份、备份策略、Postgres 参数和支持的扩展。
使用方式：该技能强调所有命令和端点必须依据官方文档，而非猜测。官方文档索引为 https://planetscale.com/docs/llms.txt，任何文档页面追加 .md 可获取 Markdown 版本，API 参考为 https://planetscale.com/docs/openapi.yaml（OpenAPI 3.0）。在调用端点前需在 API 参考中验证路径；未验证路径的 404 不应记录为平台状态或得出“未配置”的结论。已验证的接口说明包括：pscale database show <database> --org <org>（org 是标志而非位置参数）；pscale api <path> 接受组织相对路径，如 organizations/{org}/databases/{db}/branches/{branch}，没有 get 子命令和 /v1/ 前缀，查询参数使用 -Q key=value 标志；pscale webhook list <database> --org <org>（数据库是位置参数）；pscale backup list <database> <branch> 需要分支；pscale branch connections top <database> <branch> 可用于 Postgres 和 Vitess 的实时只读会话盘点，除非操作员明确批准，否则不要取消查询或终止连接。查询洞察是公共 API，实时查询遥测位于 .../branches/{branch}/insights，支持 from/to/period、q、sort、dir、tablet_type、type、fields 和分页；相关端点包括 insights/errors、insights/anomalies、insights/tags、insights/tags/summaries、insights/{fingerprint}、insights/{fingerprint}/summary 和 insights/{fingerprint}/traffic/budgets。流量预算路径为 .../branches/{branch}/traffic/budgets，CLI 没有 pscale traffic-control budget list，需使用 API。Postgres 角色通过 .../branches/{branch}/roles 列出，按 ID 而非名称获取单个角色（pscale role get <db> <branch> <role-id>）。IP 限制为数据库级 organizations/{org}/databases/{db}/cidrs，分支级 IP 限制路径无效。Schema 建议为数据库级 .../databases/{db}/schema-recommendations，请求 page=2 目前返回 404，应使用数据库对象的 open_schema_recommendations_count 作为权威总数，并将返回页视为样本，在报告中说明条目列表仅覆盖部分总数。PITR 状态和分支级备份策略没有已验证的读取路径；应使用 pscale backup list 和数据库级备份策略记录备份态势，并将 PITR 标记为“本次运行未评估”。列表端点会分页，报告计数前需跟随分页参数直到耗尽（上述 schema-recommendations 情况除外）。访问失败（403、缺少令牌作用域、超时）应记录在内部运行日志中供操作员查看，不属于发现，也不进入客户报告。
适用场景：适用于 PlanetScale 环境的只读审计、合规检查、性能与安全评估、迁移前盘点等。限制：任何写操作或变更操作都需要明确批准；部分信息（如 PITR 状态）可能无法通过已验证路径获取；某些分页端点存在已知问题，需按说明处理。输出包括盘点表、缺失证据表、风险标记和建议运行的后续技能，并以“未应用任何更改。”结束。