用途:帮助用户全面了解仓库中所有本地 Git 分支的状态,输出一张汇总表,包含远程同步状态、与主分支的差异、worktree 关联、最近活动日期和分支内容简述。适用于清理或删除分支前、长时间离开项目后恢复工作、推送或变基前了解现状、加入多分支活跃仓库时,以及查看各分支 worktree 使用情况。
主要能力:自动识别主分支(优先用 git symbolic-ref refs/remotes/origin/HEAD,失败则回退 main 或 master);用单个 shell 循环批量收集每个分支的数据,避免逐分支调用;计算远程 ahead/behind、与主分支的 ahead/behind、worktree 路径、最近提交相对时间、独有提交、是否为当前 HEAD;按规则格式化显示值,并生成可操作备注,如可删除分支(无独有提交)、陈旧分支(落后主分支 10+ 提交且 30 天无独有提交)、未推送分支(无 upstream)、已分叉分支(同时 ahead 和 behind)。
使用方式:按技能流程执行,先确定主分支,再用批量脚本收集数据,然后计算显示值、生成表格并补充 Notes。示例命令:git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@'。
限制与注意:未经用户批准不要运行 git fetch,仅报告本地状态;不要删除分支,只在备注中建议;描述列应为一句话概括而非提交列表;分支超过 20 个时建议按活动过滤;无远程时跳过 Remote 列;分离 HEAD 的 worktree 不列入表格;孤立分支跳过主分支差异列;上游引用可能已被 prune,使用前需验证存在性。