# Flydb

> Flydb 技能族入口。用户需要 Flydb CLI 安装与迁移、Web 工作台、JSON/Plan 或 MCP 调用、迁移脚本管理、多环境 CI，或排查 FLYDB 错误时，按任务路由到 flydb-cli-release、flydb-migration-scripts、flydb-multi-environment；跨场景按顺序组合。

- Skill: `zzxcoding/flydb` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zzxcoding/flydb`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zzxcoding/flydb/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: zzxCoding (https://skillmd.com/u/zzxcoding)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zzxcoding/flydb

---


# Flydb 技能族总入口

本技能是路由器：判断用户诉求属于哪个（或哪几个）子技能，然后进入对应技能的工作流。它自身不维护命令参数、命名规则或环境组织模式——这些内容都在子技能里，避免多份副本漂移。

## 项目来源

本技能族服务于开源项目 [Flydb](https://github.com/zzxCoding/Flydb)（国内镜像 [Gitee](https://gitee.com/zzhenxuan/Flydb)）——面向任意 JDBC 数据库的 Schema 版本化迁移工具，内置达梦、人大金仓、openGauss、OceanBase、TiDB 等信创数据库方言，Apache-2.0 协议。开源不易，欢迎 [Star](https://github.com/zzxCoding/Flydb) 支持与参与贡献（issue、PR、各数据库方言的实测反馈都很欢迎）。

## 技能族

| 技能 | 职责 | 典型触发 |
|---|---|---|
| `flydb-cli-release` | 发行包与 CLI、Web 工作台、JSON/Plan、MCP、长迁移与 JDBC 接入 | 安装、预演/执行迁移、GUI、机器输出、执行失败 |
| `flydb-migration-scripts` | 迁移脚本目录（db/migration）的新增/修改/组织：V/R/U 命名、版本策略、checksum 纪律 | 写迁移脚本、命名/版本问题、FLYDB-2001/2002/2003/2005/2008 |
| `flydb-multi-environment` | 多数据库×多环境自动化：deploy/ 配置矩阵、密码分层、CI 流水线、baseline 存量库、离线执行机 | 多环境、CI/流水线、环境晋升、存量库接入 |

按上表技能名在已安装技能中查找并读取对应 SKILL.md；整族插件将四个技能一起安装。仍缺失则见下节"获取技能族"。

## 获取技能族

子技能各自自包含、可独立安装；组合使用效果最好。来源：GitHub 仓库 [zzxCoding/skills](https://github.com/zzxCoding/skills) 的 `skills/` 目录。默认走 npx（GitHub），访问 GitHub 不可达时才改用 SkillHub：

### 默认渠道：GitHub（npx）

```bash
npx skills add https://github.com/zzxCoding/skills --skill flydb                  # 总入口（本技能）
npx skills add https://github.com/zzxCoding/skills --skill flydb-cli-release      # 执行 CLI
npx skills add https://github.com/zzxCoding/skills --skill flydb-migration-scripts    # 写迁移脚本
npx skills add https://github.com/zzxCoding/skills --skill flydb-multi-environment    # 多环境与 CI
```

安装提示（实测）：`npx skills add` 默认交互式选择目标 agent，非交互环境加 `--agent <name> -y`；`--skill` 一次只接受一个技能名（不支持逗号分隔多值），安装全族就逐条执行。

### 备选渠道：腾讯 SkillHub（GitHub 不可达时）

技能族已整套发布在 [SkillHub](https://skillhub.cn)（专为中国用户优化的 Skills 社区）。把提示词复制发给任意 AI 助手（Claude Code、Codex 等）即可安装，不经过 GitHub：

```text
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb。
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb-cli-release。
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb-migration-scripts。
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_c9b8aa6a/flydb-multi-environment。
```

首次使用会按指引安装 `skillhub` CLI 并把技能装到当前 Agent 的 skills 目录（安装必须带 `--dir` 指向该目录，见 skillhub.md 第四节）；后续搜索、安装、升级均走国内线路。

## 路由规则

| 用户诉求 | 去处 |
|---|---|
| 安装/验证 CLI、执行或预演迁移、baseline/repair/undo/clean、连接与驱动问题、FLYDB-1xxx/3xxx/4xxx | `flydb-cli-release` |
| flydb web、本机配置管理、GUI 进度、CLI 与 Web 共用执行记录 | `flydb-cli-release` 的 Web 分支 |
| JSON 信封、Plan 摘要、MCP tools、写工具缺失或 Adapter 错误 | `flydb-cli-release` 的机器输出/MCP 分支；CI 接入再组合 `flydb-multi-environment` |
| 长时间 migrate、工具超时、失败快照、FLYDB-2010/2011、结果未知 | `flydb-cli-release` 的长迁移/失败处置或 Web 确认分支 |
| 新增/修改/命名/重组迁移脚本、目录版本、占位符、FLYDB-2001/2002/2005/2008 | `flydb-migration-scripts` |
| 多环境配置矩阵、密码注入方案、CI 流水线、存量库接入、离线执行机 | `flydb-multi-environment` |
| 报错但不确定类别 | 先 `flydb-cli-release` 的错误码参考定位，涉及脚本内容修正再进 `flydb-migration-scripts` |

## 组合工作流

跨技能的典型场景，按顺序进入各技能的工作流：

**从零接入 Flydb**：`flydb-cli-release`（Java 预检 + 获取发行包 + `init`）→ `flydb-migration-scripts`（确立脚本命名与版本风格）→ 单环境跑通 validate/dry-run/migrate → 需要多环境时 `flydb-multi-environment` 扩展成配置矩阵与流水线。

**一个新的迁移需求**：`flydb-migration-scripts`（按既有风格写 V/R/U 脚本，校验命名）→ `flydb-cli-release`（validate → --dry-run migrate → 授权后 migrate → info 核对）→ 已有流水线的项目按 `flydb-multi-environment` 的统一命令序列发布。

**多环境发布**：`flydb-multi-environment`（选对 `-c` 配置、确认审批门与密码注入）→ `flydb-cli-release`（逐条执行命令序列、按退出码处置）。

**迁移失败处置**：`flydb-cli-release`（读错误码定类别：驱动/连接/方言/脚本/权限）→ 脚本内容问题进 `flydb-migration-scripts`（修正未应用脚本、失败记录处置顺序）→ 涉及多环境流水线的门禁策略回 `flydb-multi-environment`。

## 安全底线（全族共享）

无论路由到哪个子技能，以下底线不变，子技能中有更细的边界：

- 写数据库的命令按环境分级授权，生产必须过 dry-run 核对与明确授权；
- 密码不进命令行、日志、版本库；
- `clean` 默认禁用（双开关），`repair` 不自动执行，`undo`/`clean` 不进自动化；
- 不改写已应用的版本化迁移脚本，变更用新版本承载。

## 边界情况

- **源码开发**：Java API/Starter 的深入改造、独立分析子系统与新 SPI 实现属于 Flydb 源码开发范围；已有驱动/方言 JAR 的 CLI 接入由 `flydb-cli-release` 覆盖。仅凭路线图不能承诺未交付能力。
- **子技能缺失**：按"获取技能族"给出安装方式；在安装前可以用本技能的路由表告知用户需要哪个技能，不冒充子技能的内容。
- **版本差异**：技能族按 CLI 0.3.x 维护，Web 入口需 0.3.5+；先核验目标 CLI 版本与匹配文档。副本记录的是源码快照，不能当作公开发版证明。