flydb-cli-releaselisted
Install: claude install-skill zzxCoding/skills
# Flydb CLI 发布包使用
使用 Flydb 独立 CLI 发行包完成一次可追溯的数据库迁移操作。本技能自包含:命令、配置、错误码参考全部打包在 `references/` 内,复制到任何目录都可独立工作,不依赖 GitHub 文档链接或 Flydb 源码仓库。
本技能属于 Flydb 技能族(总入口为 `flydb` 技能):写迁移脚本用 `flydb-migration-scripts`,多环境/CI 自动化用 `flydb-multi-environment`。
## 参考文档(按任务读取)
| 文件 | 何时读取 |
|---|---|
| [`references/release-package.md`](references/release-package.md) | 获取/安装发行包、Java 运行环境、配置文件查找顺序 |
| [`references/commands.md`](references/commands.md) | 选择子命令、核对全局选项与参数语义 |
| [`references/configuration.md`](references/configuration.md) | 配置键、环境变量、优先级、版本选择/路径过滤规则 |
| [`references/errors.md`](references/errors.md) | 按错误码(FLYDB-xxxx)与退出码分类处理失败 |
| [`references/drivers.md`](references/drivers.md) | JDBC 驱动解析顺序、厂商驱动接入、FLYDB-1003 排查 |
| [`references/jdbc-integration.md`](references/jdbc-integration.md) | 新数据库接入、驱动与方言区别、SPI JAR 与厂商验证边界 |
| [`references/web.md`](references/web.md) | 启动本机 GUI、管理原配置、查看进度和同机 CLI 记录 |
| [`references/web-api.md`](references/web-api.md) | 直接调用本机 API、配置冲突、确认引用、Run/SSE 状态 |
| [`references/json-output.md`](references/json-output.md) | CI/Agent 读取机器信封、protocolVersion、错误与状态 token |
| [`references/plan-artifact.md`](references/plan-artifact.md) | 核对 plan.id、计划内容摘要及其适用边界 |
| [`references/mcp-tools.md`](references/mcp-tools.md) | MCP 定位与握手、工具白名单、写入开关、超时与诊断 |
## 核心契约
1. **自包含与版本核验**:运行参考随技能打包;先运行目标 CLI 的 `version`,优先采用其发行包内匹配版本的文档,再使用本技能副本。参数差异用 `<命令> --help` 核对,机器 schema 用对应版本文档核对;缺少证据时报告差异,不猜测选项。外部链接用于追溯和扩展阅读,不是常规执行的前置条件。
2. **来源不等于发布**:同步版本、提交和文件哈希见 [`references/upstream-sync.json