前言¶
在 Java 项目里接 MyBatis-Flex，常见卡点不在「能不能跑」，而在细节是否写对：实体注解和表映射、QueryWrapper 条件组合、BaseMapper 的增删改查约定，以及多数据源、多租户、逻辑删除、乐观锁和代码生成器的配置方式。文档分散、示例版本不一，对话式编程时 Agent 也容易按 MyBatis-Plus 或其他 ORM 的习惯给错 API。
下面介绍 SkillHub 上的 MyBatis-Flex Agent快速开发技能（坐标 @user_b91ca78d/mybatis-flex-skills）。它把 MyBatis-Flex 相关实践收敛成 Agent 可读的 Skill，在编码对话里按框架约定作答，减少查文档和试错成本。
这是什么¶
MyBatis-Flex Agent快速开发技能 是面向 MyBatis-Flex 开发的专家型 Skill：定位为框架使用指导，覆盖实体定义、查询构建、Mapper 操作和常见企业特性配置。
- 维护与来源：SkillHub 社区发布，发布者
user_b91ca78d，来源标记为community。 - 分类：
dev-programming。 - 当前版本：
1.11.8（以 SkillHub 页面为准）。 - 依赖：标签
requires_api_key=false，安装使用不需要额外 API Key。
官方入口：
- 展示页：https://www.skillhub.cn/skills/user_b91ca78d/mybatis-flex-skills
- API 地址：https://api.skillhub.cn/user_b91ca78d/mybatis-flex-skills
核心功能¶
以下能力均来自 SkillHub 简介，Skill 会在 Agent 侧围绕这些主题给出指导：
- Entity 定义：表与实体映射、注解与字段约定。
- QueryWrapper 查询构建：条件拼装与查询 API 用法。
- BaseMapper 操作：基于 BaseMapper 的常规数据访问模式。
- 多数据源配置：多数据源场景下的配置与使用要点。
- 多租户：多租户相关能力与配置说明。
- 逻辑删除：逻辑删除字段与行为配置。
- 乐观锁：乐观锁字段与更新语义。
- 代码生成器：代码生成相关流程与配置。
Skill 本体遵循通用 SKILL.md 格式，由支持 Skills 的 Agent 在匹配到 MyBatis-Flex 任务时加载规则与参考内容。
安装与启用¶
安装流程以 SkillHub 官方说明为准：先具备 skillhub CLI，再把技能装到当前 Agent 实际读取的 skills 目录（装错目录会导致 Agent 识别不到，需重启后生效）。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按官方安装脚本执行（完整安装或仅 CLI，见 SkillHub 安装文档）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill¶
SkillHub 页面给出的安装提示为：依据 https://skillhub.cn/install/skillhub.md ，安装坐标 @user_b91ca78d/mybatis-flex-skills。
命令行方式示例（--dir 须换成你当前环境的 skills 路径）：
skillhub search mybatis-flex
skillhub install user_b91ca78d/mybatis-flex-skills --dir <你的 Agent skills 目录>
常用 Agent 的 skills 目录（摘自官方安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
也可将下面这句发给已支持 Skill 安装的 AI，由其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_b91ca78d/mybatis-flex-skills`。
安装完成后重启或重新加载 Agent，使 skills 目录变更生效。
典型用法¶
经过上面的步骤，Skill 进入 Agent 的 skills 目录后，在 Java / Spring 项目中即可用自然语言委托 MyBatis-Flex 相关任务，例如：
- 为新表起草带 MyBatis-Flex 注解的 Entity 与表名映射；
- 用 QueryWrapper 描述多条件分页查询；
- 说明 BaseMapper 上某类操作的写法；
- 梳理多数据源、多租户、逻辑删除或乐观锁的配置项与注意点；
- 对照项目结构说明代码生成器的使用步骤。
对话时应明确框架为 MyBatis-Flex，并尽量提供现有实体、Mapper 接口或 application.yml 片段，便于 Skill 约束下的回答与项目一致。具体代码形态以 Skill 内 SKILL.md 及 MyBatis-Flex 官方文档为准，本文不展开未在 SkillHub 公开页摘录的示例。
适用场景与注意¶
适合谁
- 已在或计划使用 MyBatis-Flex 的后端开发者；
- 在 Cursor、Claude Code、Codex 等支持 Skills 的环境里做结对编程的团队；
- 希望减少 Agent 把 MyBatis-Flex API 与其他 ORM 混用的场景。
使用注意
- 本 Skill 为社区贡献（
community），升级与纠错节奏取决于发布者；使用前可在 SkillHub 查看版本1.11.8是否与团队框架版本匹配。 - SkillHub 统计（页面数据）：评分
100000，下载615；指标反映商店侧热度，不代表框架官方背书。 - 企业特性（多租户、多数据源等）强依赖运行环境与基线配置，Agent 输出仍需人工审查并与现网规范对齐。
- 无需 API Key，但若项目另有数据库或内部规范，应在对话中一并说明。
结尾¶
MyBatis-Flex Agent快速开发技能 把 Entity、QueryWrapper、BaseMapper 以及多数据源、多租户、逻辑删除、乐观锁、代码生成器等主题打包成 Agent 可加载的 Skill，适合在支持 SkillHub 安装链路的 IDE 里做 MyBatis-Flex 日常开发辅助。
Skill 页面与坐标：
- https://www.skillhub.cn/skills/user_b91ca78d/mybatis-flex-skills
@user_b91ca78d/mybatis-flex-skills
