zzxCoding Flydb 技能族总入口
本技能是路由器：判断用户诉求属于哪个（或哪几个）子技能，然后进入对应技能的工作流。它自身不维护命令参数、命名规则或环境组织模式——这些内容都在子技能里，避免多份副本漂移。
项目来源
本技能族服务于开源项目 Flydb（国内镜像 Gitee）——面向任意 JDBC 数据库的 Schema 版本化迁移工具，内置达梦、人大金仓、openGauss、OceanBase、TiDB 等信创数据库方言，Apache-2.0 协议。开源不易，欢迎 Star 支持与参与贡献（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 的 skills/ 目录。默认走 npx（GitHub），访问 GitHub 不可达时才改用 SkillHub：
默认渠道：GitHub（npx）
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（专为中国用户优化的 Skills 社区）。把提示词复制发给任意 AI 助手（Claude Code、Codex 等）即可安装，不经过 GitHub：
请根据 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 版本与匹配文档。副本记录的是源码快照，不能当作公开发版证明。