技能介绍

要解决什么问题

当团队需要对 TiDB Cloud 做自动化运维时，常见的痛点是凭据散落在各处，脚本里到处是 token 和连接串，一旦轮换就要改一堆代码；同时 TiDB Cloud 的 API 覆盖面广，但直接调用需要自己封装请求、处理分页和错误，重复劳动多。oo-tidb 技能把这件事收敛到 OOMOL 的 oo CLI 上：凭据由 OOMOL 服务端注入，本地脚本和 Agent 只面对统一的 oo 命令，不再接触原始 token，也不需要为每个 API 手写 HTTP 调用。

技能如何工作

核心能力是把 TiDB Cloud 的常见运维动作封装成 17 个可被 oo CLI 调用的动作，覆盖 API key、集群、分支、导入导出任务、节点规格、区域、审计日志等。这些动作分两类：get 类按 ID 取单个对象，list 类按范围枚举列表。运行前有明确的步骤：先 oo connector schema 拿到权威输入输出契约，再根据契约构造 JSON payload，通过 --data 传入；响应统一为 {"data": ..., "meta": {"executionId": "..."}}，meta.executionId 可用于追踪本次执行。

适用边界与注意点

该技能面向已经接入 OOMOL 并完成 TiDB Cloud 连接的工程环境，不负责首次登录或连接流程；只有在命令因认证或连接失败时才需要回到一次性设置。读类动作（get / list / search）可以直接执行，而写类动作会改变 TiDB Cloud 状态，必须向用户确认 payload 与影响；删除类动作是破坏性操作，需要明确目标并获得显式批准。所有动作都基于当前组织的可见范围，返回内容受连接凭据的权限边界约束。