git-repo
Git仓库与SourceGit集成管理工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:git-repo。 它的用途是:Git仓库与SourceGit集成管理工具 完整的 Skill 内容见:https://321skill.com/skills/git-repo/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用git-repo克隆这个GitHub仓库并自动注册到SourceGit中',它会执行ghq get并解析仓库URL,克隆后自动写入SourceGit的preference.json,实现一键注册。或者
对AI说:'测试将feature分支合并到main是否有冲突',它会创建一个隔离的worktree,执行git merge --no-commit并输出冲突文件列表,测试完成后自动清理worktree。
介绍
git-repo 是一个面向 Git 仓库全生命周期管理的一站式 Skill,尤其擅长处理 SourceGit 集成、工作树(worktree)操作、多账号凭证管理和冲突测试等场景。它解决的是开发者在日常 Git 使用中遇到的碎片化痛点:克隆仓库后需要手动注册到 SourceGit、多账号下 HTTPS 凭证混乱、工作树损坏或丢失、合并/拣选测试时污染主工作区、重复仓库难清理等。通过将 ghq、SourceGit 等工具的能力封装为统一的 AI 指令,大幅降低 Git 高级功能的操作门槛。
使用方式非常直观:你只需用自然语言描述需求,例如“克隆这个仓库并注册到 SourceGit”或“测试合并冲突是否影响主分支”,git-repo 会自动执行对应的 ghq get、worktree 创建、credential-helper 配置等底层命令,并返回结果。它支持批量巡查(patrol)、工作树重命名/移动、裸仓库恢复、同源合并等高级操作,所有行为都围绕 SourceGit 的偏好设置(preference.json)和 SSH 多账号映射(ssh-key)做了深度适配。
适合后端开发、全栈开发和运维工程师,尤其是那些需要管理多个 Git 仓库、频繁切换账号、依赖 SourceGit 作为前端工具的用户。也适合团队中负责维护代码仓库基础设施的成员,例如需要批量迁移仓库、修复工作树异常或统一 SSH 凭证的场景。
使用建议:首次使用前请确认已安装 ghq 和 SourceGit,并配置好 SSH 密钥。对于冲突测试(conflict-dry-run),建议在隔离的 worktree 中运行,避免影响当前工作区。如果要迁移已有仓库(to-ghq 或 to-bare),请先备份重要数据,因为操作会改变仓库结构。注意,该 Skill 专注于 Git 仓库管理,不涉及 CI/CD 流水线、代码审查或版本发布等上游流程。
核心特点
相比通用 Git 操作 Skill,git-repo 深度集成了 SourceGit 的偏好配置和注册机制,并提供了 worktree 隔离的冲突测试、多账号凭证自动管理、裸仓库修复等在生产环境中高频使用但原生 Git 需要手动组合的复杂场景。
注意事项
不适合无需 SourceGit 或只使用单一仓库、单一账号的简单场景,且需要本地已安装 ghq 和 SourceGit 才能完整运行。
常见问题
如何安装 git-repo?
通常通过 git clone 仓库到本地,然后按照 README 配置 MCP 或 AI 工具引用。具体命令请参考仓库文档。
能否同时管理多个 GitHub 账号?
可以,通过 credential-helper 和 ssh-key 功能,支持按组织(org)配置不同的 HTTPS token 或 SSH key,实现多账号自动切换。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/git-repo/raw/index.md 读取 git-repo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/git-repo/raw/index.md(查看排版版本)