git-sync

多仓库同步与ZIP打包工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:git-sync。
它的用途是:多仓库同步与ZIP打包工具
完整的 Skill 内容见:https://321skill.com/skills/git-sync-x-8/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'运行 git-sync 将当前项目同步到码云和 GitHub,并生成 ZIP 安装包。' 它会自动执行代码规范化检查(如缩进、注释规范),然后依次推送到两个远程仓库,最后在项目根目录生成一个包含所有文件的安装包,方便分发。

介绍

git-sync 是一个专门用于将 skill 代码规范化推送至码云和 GitHub 的自动化工具,同时自动生成 ZIP 安装包。它解决了开发者手动处理多个远程仓库时容易遗漏、配置不一致以及状态显示误导的问题。该工具会检查代码格式、统一提交信息,并在推送完成后打包压缩,方便分发和部署。

使用方式非常简单:在项目根目录执行 git-sync 命令,它会自动识别当前仓库的远程配置,依次推送到码云和 GitHub,并在推送成功后生成一个包含所有文件的 ZIP 包。你也可以通过参数指定跳过同步或仅生成安装包。工具内置了修复逻辑,确保跳过同步时状态显示为「跳过」而非「成功」,避免误导。

该工具适合需要同时维护多个代码托管平台的开发者,尤其是那些需要将 skill 代码发布到国内(码云)和国际(GitHub)平台,并希望提供 ZIP 安装包给用户的场景。它也适用于需要自动化 CI/CD 流程中同步与打包环节的团队。

使用前请确保已配置好码云和 GitHub 的 SSH 密钥或 token,并确认本地仓库有正确的远程地址。建议在首次使用前先执行一次空运行(dry-run)检查配置。注意,该工具不会处理代码冲突,若推送失败需手动解决后再重试。

核心特点

其他同步工具通常只做推送,而 git-sync 同时修复了跳过状态误导问题,并自动生成标准化 ZIP 安装包,且专为 skill 代码的规范化推送设计。

注意事项

不适合处理二进制大文件或需要复杂分支合并策略的仓库,且不支持超过两个远程仓库的同步(码云和 GitHub)。

常见问题

如何配置多个远程仓库?

在本地仓库执行 git remote add origin-gitee 和 git remote add origin-github 分别添加码云和 GitHub 的远程地址,然后运行 git-sync 即可自动同步。

同步失败怎么办?

请检查 SSH 密钥或 token 是否有效,以及远程仓库是否有写入权限。工具会输出具体错误信息,也可添加 --verbose 参数查看详细日志。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/git-sync-x-8/raw/index.md 读取 git-sync 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。