git-repo
一个强大的Git仓库管理工具集,集成SourceGit,优化多账号、工作树等复杂场景。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:git-repo。 它的用途是:一个强大的Git仓库管理工具集,集成SourceGit,优化多账号、工作树等复杂场景。 完整的 Skill 内容见:https://321skill.com/skills/git-repo-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我想把当前这个普通Git仓库转换成bare仓库加worktree的形式,并且要处理好文件锁。',它会调用`git-repo to-bare`命令,在保持所有工作树链接和锁状态的前提下,安全地完成转换。或者,当你说:'帮我检查一下我所有用ghq管理的仓库,看看有没有损坏的工作树或者异常状态。',它会执行`git-repo patrol`命令进行批量巡检并给出报告。
介绍
这个Skill旨在解决开发者在使用Git进行多仓库、多账号、多工作树管理时遇到的一系列痛点。例如,在多组织间切换时,克隆仓库容易使用错误的HTTPS令牌或SSH密钥;当需要测试合并或拣选操作是否会引发冲突时,缺乏一个安全的沙箱环境;以及当仓库结构损坏或需要批量迁移、整理时,手动操作繁琐且易出错。
它通过一系列子命令来应对这些场景。例如,clone命令结合了ghq get并自动向SourceGit注册;conflict-dry-run可以在独立的工作树中安全地测试合并与拣选操作;credential-helper和ssh-key帮助精准管理不同组织的认证信息;而to-ghq、to-bare、worktree-register等命令则用于仓库结构的转换、修复与元数据管理。
它非常适合需要管理大量Git仓库、频繁在多账号(如个人、公司、不同客户)间切换、或重度使用Git工作树进行并行开发的开发者。对于使用ghq管理仓库目录,或使用SourceGit作为Git客户端的用户来说,集成体验尤为顺畅。
使用前建议先了解基本命令的用途,特别是涉及仓库结构转换(如to-bare)或修复(如fix-worktree)的操作,建议在非关键仓库上先行测试。注意,它主要围绕Git仓库的元数据、结构和认证进行增强,并非替代原生的Git命令,而是提供更高效、更安全的工具链。
核心特点
深度集成了`ghq`仓库管理和`SourceGit`客户端,实现了克隆即注册的自动化工作流;提供了`conflict-dry-run`等独特的沙箱测试命令,能在不污染当前工作区的前提下安全预演合并冲突,这是很多同类Git增强工具所不具备的。
注意事项
不适合仅进行简单Git操作(如仅commit/push)或不需要管理多仓库、多工作树、多账号的轻度Git用户。
常见问题
如何用这个工具安全地测试一次合并会不会冲突?
使用 `git-repo conflict-dry-run` 命令,它会在独立的工作树中执行合并或拣选操作,让你看到潜在冲突而不影响主工作区。
我有多个GitHub账号,克隆时总用错token怎么办?
使用 `git-repo credential-helper` 功能,它可以为不同的Git组织(如github.com/orgA, github.com/orgB)固定不同的HTTPS令牌,实现按组织自动切换。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/git-repo-x/raw/index.md 读取 git-repo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/git-repo-x/raw/index.md(查看排版版本)