Agent skill

Branch Sync

by ChenyCHENYU in ChenyCHENYU/Robot_Admin

A skill your agent uses when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check.

MITAuto-check passedDevelopment

Install Branch Sync

skills CLI
$ npx skills add ChenyCHENYU/Robot_Admin --skill branch-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ChenyCHENYU/Robot_Admin branch-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ChenyCHENYU/Robot_Admin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/branch-sync .claude/skills/branch-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
branch-sync
GitHub stars
1k
Token cost
~883 tokens
SKILL.md length
164 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check.

  • Works in 5 steps: 变更分析 → 生成同步报告 → 用户确认 → …
  • : upgrading dependencies
  • SKILL.md covers 触发条件, 架构分支清单, 执行流程 and 兼容性检查清单, plus 1 more section
  • Calls git and bun

What it does

Branch Sync is an agent skill from ChenyCHENYU/Robot_Admin. Use when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check. Triggers on: 分支同步, branch sync, 版本升级, dependency upgrade, 同步更新, sync branches, 依赖更新, 通用功能.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Vite, TypeScript and Vue.js. The repository describes itself as: 一款专为开发者省时间、提效率的现代化中后台模板,跳过低质造轮子,上手即开工!Vue 3 + TS + Naive UI,更有 Bun+Vite 双引擎,性能直接拉满💥 毫秒级热更新不卡顿,开发丝滑,您试试!还有49 个成熟组件,演示页+文档双重完善,无残缺、无坑点,复制即用无需额外调试;配套 8 个 @robot-admin…. The licence is MIT.

When your agent uses it

  • : upgrading dependencies
  • Adding common features
  • The user explicitly requests branch sync check
  • Dependency upgrade

Example prompts

  • “/branch-sync”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 变更分析
  2. 生成同步报告
  3. 用户确认
  4. 执行同步(用户确认后)
  5. 冲突处理

What it can do on your machine

Read from SKILL.md and the folder at commit d9770ea. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Branch Sync loads about 883 tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 164 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~883

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ChenyCHENYU/Robot_Admin at commit d9770ea, republished under its MIT licence (© ChenyCHENYU). 164 words, ~883 tokens.

Download SKILL.mdSave it as .claude/skills/branch-sync/SKILL.md (or your agent's skills folder).
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, 依赖更新, 通用功能.

Skill: 多架构分支同步检查(branch-sync)

当**单体主分支(dev/main)**发生通用性变更时,主动提醒并协助用户将变更同步到其他架构分支。


触发条件

以下场景触发此 Skill:

  1. 依赖升级 — package.json 中 @robot-admin/*、vue、vite、naive-ui 等核心依赖版本变更
  2. 通用功能新增 — 新增了公共组件(C_*)、公共 Store(s_*)、公共 Composable(use*)、工具函数(d_*)
  3. 构建配置变更 — vite.config.ts、tsconfig.json、unocss.config.ts 等构建相关文件修改
  4. 布局/主题变更 — @robot-admin/layout、@robot-admin/theme 相关样式或配置调整
  5. 路由/权限变更 — src/router/、src/stores/ 中的通用逻辑修改
  6. 用户显式触发 — 用户说"帮我同步分支"、"检查下其他分支要不要更新"、或让我读取此文档

架构分支清单

分支架构模式与单体的差异点
micro-app微前端(京东 micro-app)门户页面、子应用容器、C_Header 扩展 props、@shared/constants、micro-app 注册
module-federation模块联邦federation 插件配置、远程模块暴露、共享依赖声明
monorepoMonorepo 工程化workspace 结构、包引用方式(workspace:*)、构建脚本

执行流程

Step 1: 变更分析

检查当前分支最近的变更,分类为:

分类说明需要同步?
通用业务新页面、新组件、新 API、bug 修复✅ 大概率需要
依赖版本package.json 依赖升级✅ 需要,但要检查兼容性
构建配置vite/tsconfig/unocss 变更⚠️ 需确认,各架构可能有差异
架构特有仅当前分支使用的功能❌ 不需要同步
Step 2: 生成同步报告

输出格式:

markdown
## 🔄 分支同步检查报告

### 本次变更摘要

- **变更类型**: 依赖升级 / 功能新增 / 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`
Step 3: 用户确认

必须等待用户确认后才执行,提供选项:

  • 全部同步 — 依次切换到每个分支执行 rebase
  • 选择性同步 — 只同步用户指定的分支
  • 仅记录 — 不操作,仅记录待同步事项供后续处理
  • 跳过 — 本次不同步
Step 4: 执行同步(用户确认后)
bash
# 对每个需要同步的分支:
git stash                          # 保存当前工作
git checkout <target-branch>       # 切换目标分支
git rebase dev                     # 变基到最新 dev
# 如果有冲突 → 停下来,报告冲突文件,等用户处理
# 如果无冲突 → 报告成功
git checkout dev                   # 切回 dev
git stash pop                      # 恢复工作
Step 5: 冲突处理

如果 rebase 产生冲突:

  1. 列出冲突文件及冲突原因(架构差异 vs 真正冲突)
  2. 不自动解决 — 架构分支的冲突需要用户判断
  3. 提供冲突解决建议(保留哪边、如何合并)
  4. 等用户确认后再 git rebase --continue

兼容性检查清单

同步前自动检查以下项:

  • Vite 版本兼容 — 确认目标分支的 Vite 插件(federation/micro-app)是否兼容新版本
  • 依赖冲突 — 检查升级的包是否与架构特有依赖冲突
  • API 变更 — 如果升级了 @robot-admin/* 包,检查是否有 breaking changes
  • 构建测试 — 建议同步后在目标分支执行 bun run build 验证

注意事项

  1. 绝不自动 force push — 所有 push 操作必须由用户手动执行
  2. monorepo 分支特殊 — 目录结构差异大,通常建议 cherry-pick 而非 rebase
  3. 冲突不猜测 — 遇到架构相关文件冲突时,明确告知用户而非自动选择
  4. 先 stash 后操作 — 切换分支前必须保存当前工作区
  5. 保持当前分支 — 操作完成后必须切回用户原来所在的分支

© ChenyCHENYU, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/branch-sync of ChenyCHENYU/Robot_Admin.

Open the folder on GitHubat commit d9770ea

Compare with similar skills

Branch Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Branch Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Branch Sync this skillChenyCHENYU/Robot_Admin1k—~883Automated safety check: PassMIT
Git Commitpddzl/td27-admin112—~147Automated safety check: PassMIT
Vuetify Skilldlogue/vite-vuetify-ts-starter1811 repos~1.9kAutomated safety check: PassMIT
Blueprint Local Scaffoldreceptron/mulmoterminal236—~647Automated safety check: PassMIT
Wayfinder Developmentslimani-dev/muraqib1281 repos~622Automated safety check: PassMIT
Vbenlinaproai/linapro160—~1.6kAutomated safety check: NotesApache-2.0

Similar skills

  • Git Commit

    pddzl/td27-admin

    Generate clear and conventional commit messages from git diffs

    112 GitHub stars~147 tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Vuetify Skilld

    logue/vite-vuetify-ts-starter

    Vue Material Component Framework. An agent skill from logue/vite-vuetify-ts-starter.

    181 GitHub starsUsed in 1 repo~1.9k tokens
    Frontend & DesignAuto-check passed
  • Blueprint Local Scaffold

    receptron/mulmoterminal

    Create the app skeleton: Express API, SQLite through node:sqlite, a Vue screen, and the test harness, following the layout the later checks rely on.

    236 GitHub stars~647 tokensUpdated today
    DatabasesAuto-check passed
  • Wayfinder Development

    slimani-dev/muraqib

    A skill your agent uses for Laravel Wayfinder which auto-generates typed functions for Laravel controllers and routes.

    128 GitHub starsUsed in 1 repo~622 tokens
    Backend & APIsAuto-check passed
  • Vben

    linaproai/linapro

    Vben Admin 5.0 前端框架开发技能。用于开发基于 Vue3、Vite、TypeScript 的中后台管理系统。

    160 GitHub stars~1.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Vue Expert

    AratKruglik/claude-laravel

    A skill your agent uses when building Vue 3 applications with Composition API, Nuxt 3, or Quasar.

    155 GitHub stars~1.1k tokensUpdated 5 mo ago
    MobileAuto-check passed

More from ChenyCHENYU/Robot_Admin

  • API Contract

    ChenyCHENYU/Robot_Admin

    A skill your agent uses when: generating TypeScript API layer (type definitions + request functions) from page-spec JSON or Swagger/OpenAPI docs.

    1k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Convention Audit

    ChenyCHENYU/Robot_Admin

    A skill your agent uses when: reviewing code for compliance with Robot Admin project conventions, or when generating a compliance report.

    1k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Mock Codegen

    ChenyCHENYU/Robot_Admin

    A skill your agent uses when: generating mock data for development without a backend.

    1k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Page Codegen

    ChenyCHENYU/Robot_Admin

    A skill your agent uses when: generating Vue 3 page code from either a page-spec JSON or a natural language description.

    1k GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Prototype Scan

    ChenyCHENYU/Robot_Admin

    A skill your agent uses when: analyzing Axure exported HTML prototype files or detailed design documents to extract page inventory, classify interaction patterns, and produce a structured page-spec…

    1k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Route Sync

    ChenyCHENYU/Robot_Admin

    A skill your agent uses when: registering new pages into the dynamic router system.

    1k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Categories

Questions about Branch Sync

What does Branch Sync do?

A skill your agent uses when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check. Branch Sync is an agent skill from ChenyCHENYU/Robot_Admin. Use when: upgrading dependencies, adding common features, or when the user explicitly requests branch sync check.

When should I use Branch Sync?

Branch Sync fits situations like: : upgrading dependencies; adding common features; the user explicitly requests branch sync check; dependency upgrade.

How do I install Branch Sync in Claude Code?

Run `npx skills add ChenyCHENYU/Robot_Admin --skill branch-sync -a claude-code`. Or copy the skill folder (.github/skills/branch-sync in ChenyCHENYU/Robot_Admin) into .claude/skills/branch-sync in your project. Claude Code loads it when a task matches its description.

How do I install Branch Sync in Codex?

Run `npx skills add ChenyCHENYU/Robot_Admin --skill branch-sync -a codex`. Or copy the skill folder (.github/skills/branch-sync in ChenyCHENYU/Robot_Admin) into .agents/skills/branch-sync in your project. Codex loads it when a task matches its description.

Can I use Branch Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ChenyCHENYU/Robot_Admin --skill branch-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/branch-sync, .gemini/skills/branch-sync, .github/skills/branch-sync and .opencode/skills/branch-sync in your project.

What does Branch Sync need to run?

Going by SKILL.md and its folder, Branch Sync needs the command-line tools its instructions call (git and bun).

Does Branch Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Branch Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Branch Sync use?

Branch Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Branch Sync use?

About 883 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Branch Sync?

Skills that share tags, products or a category with Branch Sync: Git Commit (pddzl/td27-admin, 112 stars), Vuetify Skilld (logue/vite-vuetify-ts-starter, 181 stars), Blueprint Local Scaffold (receptron/mulmoterminal, 236 stars) and Wayfinder Development (slimani-dev/muraqib, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Branch Sync?

ChenyCHENYU (a GitHub user) maintains it in ChenyCHENYU/Robot_Admin, which has 1,020 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: ChenyCHENYU/Robot_Admin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.