Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/ruan-cat/monorepo --skill get-git-branchAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Get Git Branch
诊断并修复 Git 仓库的远程分支不可见问题，将受限的 fetch 配置恢复为完整模式。
背景知识
使用 git clone --depth=1 或 git clone --single-branch 克隆仓库时，Git 会自动将 .git/config 中的 fetch refspec 限制为只拉取默认分支。例如：
[remote "origin"]
url = https://example.com/repo.git
fetch = +refs/heads/master:refs/remotes/origin/master这导致 git fetch --all 和 git branch -a 都只能看到默认分支，其他远程分支完全不可见。但远程仓库上那些分支仍然存在，只是本地配置不去拉取它们。
理解这个根因很重要——问题不在网络或权限，而在于本地的一行配置。
工作流程
第一步：诊断问题
同时执行以下三个命令，收集足够的信息来判断问题根因：
# 1. 查看本地能看到的所有分支
git branch -a
# 2. 查看 fetch refspec 配置（关键诊断点）
git config --get remote.origin.fetch
# 3. 直接查询远程服务器上实际存在的分支
git ls-remote --heads origin判断逻辑：
git config --get remote.origin.fetch 输出 | 含义 | 处理方式 |
|---|---|---|
+refs/heads/master:refs/remotes/origin/master | fetch 被限制为单分支 | 继续第二步修复 |
+refs/heads/main:refs/remotes/origin/main | 同上（只是默认分支名不同） | 继续第二步修复 |
+refs/heads/*:refs/remotes/origin/* | fetch 配置正常 | 问题在别处，见「其他情况」 |
同时对比 git branch -a 和 git ls-remote --heads origin 的结果：
- 如果
ls-remote显示的分支比branch -a多，确认是本地 fetch 配置问题 - 如果
ls-remote也只有一个分支，那远程确实只有一个分支，无需修复
第二步：修改 fetch refspec
将 fetch 规则从单分支改为通配符模式：
git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"这条命令将 .git/config 中的 fetch 行从：
+refs/heads/master:refs/remotes/origin/master改为：
+refs/heads/*:refs/remotes/origin/*星号 * 表示匹配所有分支名，这是正常 git clone（不带 --single-branch）的默认配置。
第三步：拉取所有远程分支
git fetch --all此时 Git 会按照新的通配符规则，从远程拉取所有分支的引用。
第四步：验证结果
git branch -a确认所有远程分支都已出现在 remotes/origin/ 下。向用户展示完整的分支列表。
第五步（可选）：补全提交历史
如果仓库是浅克隆的（--depth=1），上述步骤只补全了分支引用，提交历史仍然是截断的。如果用户需要完整历史：
git fetch --unshallow这会下载完整的提交历史，耗时取决于仓库大小。只在用户明确需要时执行，因为大仓库的完整历史可能非常大。
判断是否为浅克隆：
git rev-parse --is-shallow-repository
# true = 浅克隆，false = 完整历史其他情况
如果 fetch refspec 已经是通配符但仍然看不到分支，按以下顺序排查：
- 网络问题：
git ls-remote --heads origin是否能成功连接远程 - 权限问题：是否有权限访问远程仓库的所有分支
- 缓存过期：尝试
git remote update origin --prune清理过期的远程引用 - 多 remote：检查
git remote -v，分支可能在其他 remote 上
注意事项
- 修改 fetch refspec 是安全操作，不会影响已有的本地分支或工作树
git fetch --all只下载引用和相关对象，不会自动创建本地分支或修改工作树- 如果用户需要在某个远程分支上工作，可以用
git checkout <branch-name>自动创建追踪分支
