// Use when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check. Triggers on: 分支同步, branch sync, 版本升级, dependency upgrade, 同步更新, sync branches, 依赖更新, 通用功能.
Use when: generating Vue 3 page code from either a page-spec JSON or a natural language description. Outputs index.vue + data.ts + index.scss following Robot Admin conventions. Triggers on: page generation, code generation, 生成页面, 代码生成, vue页面, codegen, 页面骨架, scaffold, 建个页面, 写个页面, 帮我做个页面, 口述需求, natural language page request.
Use when: generating mock data for development without a backend. Optional skill - activated when user confirms or explicitly requests it. Triggers on: 生成mock, mock数据, 模拟数据, mock生成, 前端mock, 联调前mock.
Use when: generating TypeScript API layer (type definitions + request functions) from page-spec JSON or Swagger/OpenAPI docs. Triggers on: api contract, api generation, 接口约定, 生成api, swagger to ts, openapi, 接口文件, api层.
Use when: reviewing code for compliance with Robot Admin project conventions, or when generating a compliance report. Triggers on: convention check, 规范检查, audit, 代码审查, code review, 命名规范, naming convention, 代码规范.
Use when: analyzing Axure exported HTML prototype files or detailed design documents to extract page inventory, classify interaction patterns, and produce a structured page-spec JSON for Vue 3 + Naive UI development. Triggers on: prototype analysis, axure scan, page inventory, 原型解析, 页面清单, axure转vue, 详设文档, design doc.
Use when: registering new pages into the dynamic router system. Adds route entries to dynamicRouter.json and optionally updates keepAliveConfig.ts. Triggers on: route registration, 注册路由, 添加菜单, menu registration, 路由配置, dynamicRouter, 新增页面路由.
| name | branch-sync |
| description | Use when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check. Triggers on: 分支同步, branch sync, 版本升级, dependency upgrade, 同步更新, sync branches, 依赖更新, 通用功能. |
当**单体主分支（dev/main）**发生通用性变更时，主动提醒并协助用户将变更同步到其他架构分支。
以下场景触发此 Skill：
package.json 中 @robot-admin/*、vue、vite、naive-ui 等核心依赖版本变更C_*）、公共 Store（s_*）、公共 Composable（use*）、工具函数（d_*）vite.config.ts、tsconfig.json、unocss.config.ts 等构建相关文件修改@robot-admin/layout、@robot-admin/theme 相关样式或配置调整src/router/、src/stores/ 中的通用逻辑修改| 分支 | 架构模式 | 与单体的差异点 |
|---|---|---|
micro-app | 微前端（京东 micro-app） | 门户页面、子应用容器、C_Header 扩展 props、@shared/constants、micro-app 注册 |
module-federation | 模块联邦 | federation 插件配置、远程模块暴露、共享依赖声明 |
monorepo | Monorepo 工程化 | workspace 结构、包引用方式（workspace:*）、构建脚本 |
检查当前分支最近的变更，分类为：
| 分类 | 说明 | 需要同步？ |
|---|---|---|
| 通用业务 | 新页面、新组件、新 API、bug 修复 | ✅ 大概率需要 |
| 依赖版本 | package.json 依赖升级 | ✅ 需要，但要检查兼容性 |
| 构建配置 | vite/tsconfig/unocss 变更 | ⚠️ 需确认，各架构可能有差异 |
| 架构特有 | 仅当前分支使用的功能 | ❌ 不需要同步 |
输出格式：
## 🔄 分支同步检查报告
### 本次变更摘要
- **变更类型**: 依赖升级 / 功能新增 / bug 修复 / 构建配置
- **涉及文件**: （列出关键文件）
- **变更描述**: （简要说明）
### 同步建议
| 目标分支 | 是否需要同步 | 风险等级 | 可能的冲突点 |
| ----------------- | ------------ | -------- | ----------------------- |
| micro-app | ✅ 需要 | 🟢 低 | 无预期冲突 |
| module-federation | ✅ 需要 | 🟡 中 | vite.config.ts 可能冲突 |
| monorepo | ❌ 跳过 | - | 结构差异大，手动处理 |
### 推荐操作
1. `git checkout micro-app && git rebase dev`
2. `git checkout module-federation && git rebase dev`
必须等待用户确认后才执行，提供选项：
# 对每个需要同步的分支：
git stash # 保存当前工作
git checkout <target-branch> # 切换目标分支
git rebase dev # 变基到最新 dev
# 如果有冲突 → 停下来，报告冲突文件，等用户处理
# 如果无冲突 → 报告成功
git checkout dev # 切回 dev
git stash pop # 恢复工作
如果 rebase 产生冲突：
git rebase --continue同步前自动检查以下项：
@robot-admin/* 包，检查是否有 breaking changesbun run build 验证