blade-sync

Synchronize Git commits between BladeX repositories with path and package remapping.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/tiantien/team-ai-coding-plugin --skill blade-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blade-sync
Source: https://github.com/tiantien/team-ai-coding-plugin/tree/main/skills/blade-sync
Command: npx skills add https://github.com/tiantien/team-ai-coding-plugin --skill blade-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill moves Git commits between BladeX repositories without losing intent, even when the source and target projects use different module layouts or package paths. It helps teams migrate upstream changes, mirror fixes, and keep boot, cloud, and links codebases aligned.

Core Features & Use Cases

  • Commit-by-commit synchronization: Replays source history one commit at a time so each change stays reviewable and traceable.
  • Heterogeneous adaptation: Adjusts file paths, package names, and imports when syncing between Boot, Cloud, and Links structures.
  • Safety and review gates: Enforces commit-only operations, blocks dangerous Git actions, and pauses for user confirmation after each change set.
  • Use cases: Mirror a fix from one BladeX project to another, adapt official upstream updates into a customized fork, or compare and sync multiple commits in sequence.

Quick Start

Ask the blade-sync skill to synchronize the selected commit range from the source repository to the target repository, and tell it whether to use mirror mode or adapt mode.

Frequently Asked Questions about blade-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Git commits between BladeX Boot and Cloud repositories with different package paths?

To sync Git commits between BladeX Boot and Cloud, use adapt mode to remap file paths, package names, and imports, applying changes commit-by-commit to keep each modification traceable and reviewable.

What is the safest way to migrate upstream BladeX commits into a customized fork?

The safest way to migrate upstream BladeX commits is commit-only synchronization, which blocks dangerous Git actions and enforces manual review checkpoints after each change set to preserve original commit intent.

Can I mirror a fix from one BladeX project to another without altering the commit history?

Yes, you can mirror a fix from one BladeX project to another using mirror mode, which replays source history one commit at a time across Boot, Cloud, and Links codebases while keeping every change reviewable.

Does the BladeX commit synchronization process support manual review checkpoints after each commit?

Yes, the BladeX commit synchronization process enforces manual review checkpoints by pausing for user confirmation after applying each commit, ensuring commit-only safety constraints block dangerous Git actions during cross-project migration.

Why do my Git commits fail when migrating across BladeX projects with different module layouts?

Git commits fail when migrating across BladeX projects because heterogeneous module layouts mismatch, requiring adapt mode to automatically adjust file paths and imports during ordered per-commit application.