git-repo
Git仓库多账号管理与工作树集成工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:git-repo。 它的用途是:Git仓库多账号管理与工作树集成工具 完整的 Skill 内容见:https://321skill.com/skills/git-repo-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'克隆这个仓库并注册到SourceGit,使用我的工作账号令牌',它会执行 `ghq get` 并自动将仓库路径写入 SourceGit 的 preference.json,同时配置好对应组织的 HTTPS token。之后再
对AI说:'测试合并hotfix分支到main的冲突',它会创建一个隔离的 worktree,执行 `git merge --no-commit` 并报告冲突文件,完成后自动清理工作树。
介绍
git-repo 是一个面向 Git 仓库的深度集成工具,聚焦于解决多账号切换、工作树管理、冲突测试等高频痛点。它通过封装 ghq 克隆、SourceGit 自动注册、credential-helper 多账号令牌映射、worktree 批量操作等功能,将零散的 Git 工作流统一为可复用的命令。无论你是需要以不同身份克隆仓库、在隔离工作树中测试合并冲突,还是修复裸仓库、迁移仓库结构,git-repo 都能一键完成。
使用方法非常直观:你可以直接通过自然语言触发,例如“克隆这个仓库并注册到 SourceGit”,它会自动执行 ghq get 并写入 SourceGit 的偏好文件;当你说“测试合并冲突”时,它会创建一个隔离的工作树并执行 merge/cherry-pick 干运行;需要切换账号时,只需指定组织和令牌,它会自动配置 credential.helper 和 core.sshCommand。所有操作均基于标准 Git 命令,但通过智能编排减少了手动步骤。
适合频繁操作 Git 仓库的开发者、运维工程师和全栈工程师,尤其是那些管理多个 Git 托管平台(GitHub、GitLab、自建仓库)、需要同时维护多个分支/工作树、或在多账号环境下工作的用户。对于使用 SourceGit 作为 GUI 客户端的团队,git-repo 能自动同步仓库注册信息,避免重复配置。
使用前建议先安装 ghq 和 SourceGit(可选),并确保 Git 版本 ≥ 2.30。注意,git-repo 的 worktree 系列操作会修改本地文件系统,建议在操作前通过 patrol 命令检查仓库状态,避免覆盖未提交的更改。对于需要严格权限隔离的企业环境,请先验证 credential-helper 的 token 映射范围。
核心特点
与同类 Git 工作流工具相比,git-repo 深度绑定 SourceGit 的 preference.json 注册机制,并提供了 per-org 粒度的 HTTPS token 映射,让多账号克隆和自动注册成为原生体验,而非简单封装 ghq 或 git worktree 命令。
注意事项
不适合不熟悉 Git 或 SourceGit 基本概念的用户,且部分功能(如 conflict-dry-run)依赖 Git 2.30+ 的 worktree 特性。
常见问题
如何用 git-repo 克隆仓库并自动注册到 SourceGit?
直接对 AI 说“克隆这个仓库并注册到 SourceGit”,它会执行 ghq get 并自动写入 SourceGit 的 preference.json 文件。
多账号场景下如何切换组织令牌?
使用 credential-helper 功能,通过参数指定组织名称和对应 token,git-repo 会配置 per-org 的 credential.helper 映射。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/git-repo-x-2/raw/index.md 读取 git-repo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/git-repo-x-2/raw/index.md(查看排版版本)