面向 Codex、Claude Code 及其他兼容 Agent Skills 的个人技能集合。
仅翻译 SKILL.md YAML frontmatter 中的 description 字段,保留技能名称、其他元数据与正文。
未提供目标路径时,会先发现当前项目和常见用户级技能目录,给出推荐选项,并保留手工路径入口:
python3 skills/skill-description-translator/scripts/translate_skill_descriptions.py \
discover --project-root .目录:
skills/skill-description-translator/
├── SKILL.md
├── agents/
│ └── openai.yaml
├── scripts/
│ └── translate_skill_descriptions.py
└── tests/
└── test_translate_skill_descriptions.py
本地安装:
npx skills add . --skill skill-description-translator直接验证:
python3 -m unittest discover \
-s skills/skill-description-translator/tests \
-p 'test_*.py'使用 Flydb CLI 发布包完成数据库迁移的自包含技能:Java 环境预检、获取与验证发行包(已有安装 → 本地 ZIP → GitHub/Gitee Release 下载)、init、info、validate、--dry-run migrate、migrate、baseline、repair、undo、clean 与 JDBC 驱动接入。
技能自带命令、配置、错误码等全部参考文档(references/),复制到任何 Agent 技能目录都可独立工作,不依赖 GitHub 文档链接;参考对应 CLI 0.2.0,与 --help 实际输出不一致时以后者为准。
目录:
skills/flydb-cli-release/
├── SKILL.md
├── references/
│ ├── commands.md # CLI 命令参考(移植自 Flydb docs)
│ ├── configuration.md # 配置项参考(移植自 Flydb docs)
│ ├── errors.md # 错误码/退出码参考(移植自 Flydb docs)
│ ├── release-package.md # 发布包获取、安装与 Java 运行环境
│ └── drivers.md # JDBC 驱动解析与 FLYDB-1003 排查
└── evals/
└── evals.json
本地安装:
npx skills add . --skill flydb-cli-release管理使用 Flydb 的项目中的迁移脚本目录(db/migration 及自定义 locations):新增 V__/R__/U__ 脚本、命名与版本策略(递增整数/日期版本/目录版本)、子目录组织、占位符使用,以及 checksum 与失败记录的修改纪律(已应用的版本化脚本绝不改写,变更用新版本承载)。
自带命名规则与错误处置参考;执行 CLI 命令(migrate/repair 等)由 flydb-cli-release 技能覆盖,两者可独立使用。
目录:
skills/flydb-migration-scripts/
├── SKILL.md
├── references/
│ ├── naming-and-versions.md # 命名、版本规则与三类脚本语义
│ └── errors-and-discipline.md # 修改红线与脚本目录相关错误码处置
└── evals/
└── evals.json
本地安装:
npx skills add . --skill flydb-migration-scripts组织 Flydb 多数据库、多环境(测试/预发/生产)的迁移自动化:deploy/ 配置矩阵(一个数据库×环境一份 flydb.conf,密码全部外部注入)、按数据库家族组织脚本仓库、CI 流水线统一命令序列与退出码门禁、存量库 baseline 接入、驱动分发与离线执行机。
参考移植自 Flydb 仓库 docs/getting-started/multi-environment.md(对应 CLI 0.2.0);命令与配置细节由 flydb-cli-release 技能提供。
目录:
skills/flydb-multi-environment/
├── SKILL.md
├── references/
│ └── multi-environment.md # 多数据库多环境自动化组织模式
└── evals/
└── evals.json
本地安装:
npx skills add . --skill flydb-multi-environmentFlydb 技能族的调度路由器:按用户诉求路由到对应子技能或技能组合,并提供跨技能的端到端组合工作流(从零接入、新迁移需求、多环境发布、失败处置)。路由器保持薄,不复制子技能内容。
技能族服务于开源项目 Flydb(zzxCoding/Flydb,Apache-2.0;国内镜像 Gitee)——面向任意 JDBC 数据库的 Schema 版本化迁移工具,内置达梦、人大金仓、openGauss、OceanBase、TiDB 等信创数据库方言。开源不易,欢迎 Star 支持与参与贡献。
| 技能 | 职责 |
|---|---|
flydb-cli-release |
Java 预检、发行包获取与验证、执行 CLI 命令、驱动接入 |
flydb-migration-scripts |
迁移脚本的新增/修改/组织、命名与版本策略、checksum 纪律 |
flydb-multi-environment |
多环境配置矩阵、密码分层、CI 流水线、baseline、离线执行机 |
目录:
skills/flydb/
├── SKILL.md
└── evals/
└── evals.json
本地安装(技能族一起装,组合使用效果最好;各子技能也可独立安装):
npx skills add . --skill flydb
npx skills add . --skill flydb-cli-release
npx skills add . --skill flydb-migration-scripts
npx skills add . --skill flydb-multi-environment# Vercel skills CLI(skills.sh 生态),逐个技能安装
npx skills add https://github.com/zzxCoding/skills --skill flydb
# Claude Code 插件市场(整族安装)
# /plugin marketplace add zzxCoding/skills
# /plugin install flydb-skills@zzxcoding-skills
# 国内备选:腾讯 SkillHub(GitHub 不可达时,提示词安装,见下)
# 请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c9b8aa6a/flydb。- skills.sh(Vercel):安装遥测自动进榜,无需提交;平台例行安全审计。
- ClawHub:经 GitHub Actions 发布(.github/workflows/clawhub-publish.yml)。需在仓库 Secrets 配置
CLAWHUB_TOKEN;首次经 workflow 发布的技能归入other分类,需在 ClawHub 设置页补充 categories/topics。 - 腾讯 SkillHub(国内备选渠道):GitHub 不可达时的备选安装渠道。flydb 技能族已整套发布(
@user_c9b8aa6a/flydb及三个子技能),把提示词复制给 AI 助手即可安装,不经 GitHub;仓库同时保持 topics 与安装命令标注,便于其他聚合平台自动收录。 - Flydb 国内镜像(Gitee):gitee.com/zzhenxuan/Flydb,方便国内用户访问 Flydb 源码与文档;CLI 发行包同步发布在 GitHub 与 Gitee Release。
- 遵循 Agent Skills 规范的
SKILL.md与 YAML frontmatter 约定。 - 采用 Vercel Agent Skills和 Anthropic Skills使用的
skills/<name>/集合式目录。 - 把确定性的扫描与写入放在
scripts/,让SKILL.md聚焦工作流和行为边界。 - 把需要随技能离线可用的参考内容打包进
references/,技能自包含、复制即用;移植的参考文档标注来源版本,便于上游更新时同步。