git-repo
一个集成了 SourceGit 的 Git 仓库管理工具集,用于克隆、修复、迁移、合并和高效管理工作树。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:git-repo。 它的用途是:一个集成了 SourceGit 的 Git 仓库管理工具集,用于克隆、修复、迁移、合并和高效管理工作树。 完整的 Skill 内容见:https://321skill.com/skills/git-repo-x-5/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我想测试把 feature-branch 合并到 main 会不会有冲突,但不想弄乱当前的工作区。',它会建议你使用 `git-repo conflict-dry-run` 命令,在隔离的环境中进行安全的合并测试。或者,当你说:'我有两个 GitHub 账号,克隆公司仓库时总是用了个人账号的 token。',它会指导你使用 `git-repo credential-helper` 来为不同的组织固定 HTTPS 令牌,实现精准的多账号克隆。
介绍
这个 Skill 旨在解决开发者在使用 Git 和 ghq 管理多个代码仓库时遇到的一系列繁琐问题,例如多账号切换混乱、仓库重复、工作树损坏、迁移困难以及合并冲突测试不便等。它通过一系列子命令,将克隆、凭证管理、仓库修复、格式转换、工作树操作等常见任务自动化,并与 SourceGit 深度集成,简化了本地仓库的管理流程。
使用时,你可以通过 git-repo 命令调用其各种子功能。例如,使用 git-repo clone 可以替代 ghq get 并自动在 SourceGit 中注册新仓库;git-repo conflict-dry-run 可以在独立的工作树中安全地测试合并或 cherry-pick 操作是否会引发冲突;git-repo to-ghq 可以将旧的 bare+worktree 仓库结构迁移到标准的 ghq 目录布局。
它特别适合需要管理大量 Git 仓库、使用多个 Git 托管服务账号(如 GitHub、GitLab)、或经常需要创建和切换工作树的开发者。无论是个人开发者还是团队中的基础设施维护者,都能从中受益,提升本地开发环境的整洁度和操作效率。
建议在初次使用前,先通过 git-repo --help 了解所有可用命令。由于部分命令(如 to-bare, fix-worktree)会修改仓库结构,建议先在不重要的仓库上进行测试。同时,确保已安装 ghq 和 SourceGit 以获得完整的功能体验。
核心特点
与单一功能的 Git 工具不同,它集成了从克隆、凭证管理、仓库修复、格式转换到工作树生命周期管理的全链路操作,并且深度绑定 ghq 和 SourceGit,提供了开箱即用的多账号克隆与仓库自动注册能力。
注意事项
不适合仅进行简单 Git 操作(如 add, commit, push)或不需要管理多个仓库/工作树的用户。
常见问题
如何用这个工具克隆仓库并自动注册到 SourceGit?
使用 `git-repo clone <repo-url>`,它会调用 ghq 获取仓库,并自动在 SourceGit 的 preference.json 中注册。
如何安全地测试一次合并是否会冲突?
使用 `git-repo conflict-dry-run` 命令,它会在一个临时工作树中执行合并或 cherry-pick 操作,不影响当前工作区。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/git-repo-x-5/raw/index.md 读取 git-repo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/git-repo-x-5/raw/index.md(查看排版版本)