前言¶
在 miaohong-cloud-base 这类多模块 Spring Boot 仓库里改网关、鉴权、业务服务，或动 Nacos 配置、MyBatis-Plus Mapper、共享 API 契约时，助手往往缺少仓库语境，容易给出与模块边界、技术栈不一致的建议。下面介绍 SkillHub 上的 11252（坐标 @user_928f7032/152152），它把「何时、针对哪类后端工作启用该 Skill」写进官方说明，便于在 Cursor 等 Agent 里按场景挂载。
这是什么¶
11252 是社区来源（community）、分类为 dev-programming 的 Agent Skill，当前版本 1.0.0，由发布者 user_928f7032 维护。官方简介写明：在 miaohong-cloud-base Java 后端仓库中，用于多模块 Spring Boot 开发、网关/鉴权/服务调试、基于 Nacos 的配置、MyBatis-Plus Mapper 变更、共享 API 契约更新，以及该代码库内的后端排障。标签 requires_api_key=false，表示按 SkillHub 元数据无需额外 API Key。
SkillHub 页面：https://www.skillhub.cn/skills/user_928f7032/152152
API 入口：https://api.skillhub.cn/user_928f7032/152152
核心功能¶
依据官方简介，该 Skill 覆盖的能力可归纳为以下几类（均指向同一仓库语境）：
- 多模块 Spring Boot 开发：在既定模块结构下协助开发与改动。
- 网关、鉴权、服务调试：围绕 gateway / auth / service 相关问题的排查与修改。
- Nacos 配置：与 Nacos 承载的配置项相关的开发与调整。
- MyBatis-Plus Mapper：Mapper 层变更与相关实现。
- 共享 API 契约：跨模块或对外 API 契约的更新。
- 后端排障：限定在
miaohong-cloud-base代码库内的故障定位与修复思路。
具体步骤、目录约定与命令以 Skill 包内 SKILL.md 为准；公开页面未展开更细的脚本或配置字段，本文不臆造。
安装与启用¶
SkillHub 官方推荐两种方式，本质都是按统一安装文档拉取 @user_928f7032/152152。
方式一：让 AI 按文档安装¶
将下面提示词发给当前 Agent（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_928f7032/152152`。
方式二：本机 SkillHub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装（示例为官方给出的推荐命令）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。官方文档给出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（将 <skills 目录> 换成你当前环境的路径）：
skillhub install @user_928f7032/152152 --dir <skills 目录>
也可先搜索再安装：
skillhub search 11252
skillhub install @user_928f7032/152152 --dir <skills 目录>
安装后按你所用客户端的要求刷新或重启 Agent，使 Skill 被加载。
典型用法¶
公开资料未提供独立「教程式」对话样例，典型用法与官方定位一致：在已克隆 miaohong-cloud-base 的工作区中，向 Agent 描述具体任务，并确保已启用本 Skill。例如：
- 「在 gateway 模块里排查某路由 401，结合 Nacos 里的鉴权相关配置一起看。」
- 「按现有契约在 shared API 模块补字段，并同步 service 侧 DTO。」
- 「改 MyBatis-Plus Mapper 与对应 XML，保持与现有分页、租户字段约定一致。」
Agent 应优先遵循 Skill 内对仓库结构、技术栈与操作顺序的说明；若任务超出简介范围，应自行核对代码而非依赖 Skill 外推。
适用场景与注意¶
适合谁：日常在 miaohong-cloud-base 仓库内做 Java 后端开发的工程师，且使用支持 SkillHub / SKILL.md 的编码 Agent（如 Cursor、Claude Code、Codex 等）。
限制：
- Skill 名称 11252 为 SkillHub 上的展示名，与仓库品牌无直接对应关系；是否匹配你的 fork 或分支，需以本地代码为准。
- 简介明确绑定 miaohong-cloud-base；其他 Java 单体或多模块项目未必适用。
- SkillHub 元数据显示 requires_api_key=false；若 Skill 包内另有第三方服务说明，以包内文档为准。
- 截至页面信息，版本为 1.0.0，来源为社区贡献，使用前可在 SkillHub 查看评分与下载量（抓取数据：评分 100000，下载 679）。
注意：社区 Skill 会随发布者更新；重大架构变更后，建议重新安装或更新同一坐标下的版本，并对照 SKILL.md 变更。
结尾¶
11252 把 miaohong-cloud-base 后端常见工作面——Spring Boot 多模块、网关与鉴权、Nacos、MyBatis-Plus、API 契约与排障——收敛成一条可挂载的 Agent 能力说明，适合作为该仓库日常开发的上下文 Skill。安装与坐标以 SkillHub 为准：
- https://www.skillhub.cn/skills/user_928f7032/152152
- https://api.skillhub.cn/user_928f7032/152152
