git-repo

一站式Git仓库与工作树管理工具

安装使用

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

帮我安装这个 AI Skill:git-repo。
它的用途是:一站式Git仓库与工作树管理工具
完整的 Skill 内容见:https://321skill.com/skills/git-repo-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'帮我用git-repo切换多账号,我需要为GitHub和GitLab分别配置不同的HTTPS Token。' 它会自动调用credential-helper模块,引导你输入每个组织的Token并写入全局Git配置,之后克隆对应仓库时自动使用正确凭据。你也可以说:'对当前项目做一次合并冲突预演,测试合并develop分支到main。' 它会创建一个隔离工作树,执行merge操作并报告冲突情况,完成后自动清理工作树,确保主仓库干净。

介绍

git-repo 解决了多仓库、多账号场景下 Git 操作繁琐且易出错的问题。它提供了从克隆(ghq get + 自动注册到 SourceGit)、冲突预演(隔离工作树测试合并/拣选)、多账号 HTTPS 凭据管理(按组织绑定 Token)、到工作树全生命周期管理(创建、复用、重命名、移动、修复裸仓库恢复)等系列功能,帮助开发者高效、安全地维护 Git 仓库生态。

使用方式极为简洁:通过预设的触发器(如“ghq get”、“worktree create”、“credential helper”、“merge conflict test”)直接调用对应功能。例如,说“切换多账号”即可触发 credential-helper 模块,按提示配置每个组织的独立 Token;说“合并开发分支代码到主分支仓库”会调用 merge-duplicate 模块,自动处理同源仓库的合并。所有操作均基于命令行或 AI 对话指令,无需手动查找配置。

适合所有需要频繁管理 Git 仓库的开发者,尤其是后端开发、运维工程师和全栈开发者。如果你同时使用多个 Git 托管平台(如 GitHub、GitLab 等),需要为不同项目隔离账号凭据,或者经常处理工作树、裸仓库迁移等高级操作,这个 Skill 能显著提升效率。

建议先通过 patrol 命令进行一次批量仓库检查,了解当前工作树状态;使用 credential-helper 前准备好各组织对应的 HTTPS Token。注意:本 Skill 依赖 ghq 和 SourceGit,若未安装相关工具,请先安装。不适合仅需简单 git add/commit/push 的用户。

核心特点

与同类 Git 管理 Skill 相比,git-repo 深度集成了 SourceGit 和 ghq,并提供了独特的工作树冲突预演(dry-run)、裸仓库恢复(fix-worktree)、同源仓库合并(merge-duplicate)等高级功能,同时支持多账号 HTTPS 凭据按组织绑定,避免跨账号提交错误。

注意事项

不适合不使用 ghq 或 SourceGit 的用户,且对工作树操作不熟练的新手可能需先学习基础概念。

常见问题

如何配置多账号HTTPS凭证?

使用 credential-helper 模块,按提示为每个组织输入 HTTPS Token,它会在 Git 配置中自动生成 per-org 的 credential helper 条目。

怎样将普通仓库转换为bare仓库?

在仓库目录下执行 to-bare 命令,它会自动将普通仓库转为 bare 结构并创建相应工作树,同时保留锁文件。

给 AI 助手的安装指引

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

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