git-check
Installation
SKILL.md
Git Check
分两个回合工作:先只检查并汇报;再按用户明确确认的执行清单改变 Git 状态。初次调用只授权检查,不授权提交、合入、推送、删除或清理。
阶段一:检查
1. 确定仓库与主干
- 找到仓库根目录;若当前路径不在 Git 仓库中,停止并汇报。
- 按以下优先级确定主干:用户指定;仓库说明或
docs/user/git-preferences.md;远端默认分支;唯一存在的main或master。存在歧义时先询问,不猜测。 - 记录当前 branch、HEAD、upstream、仓库根目录和当前 worktree。明确回答当前是否在主干;detached HEAD 单独标记。
- 有远端时运行不带 prune 的 fetch 以刷新观察数据。fetch 失败时继续本地检查,但标记远端信息可能过期。不要在检查阶段 pull、rebase 或更新本地 branch。
完成条件:主干来源明确,当前位置和数据新鲜度均已记录。
2. 检查所有修改
对每个 worktree 使用 porcelain 状态,并结合以下证据检查: