w-git-repair 是一个专注于修复本地 Git 常见问题的技能,来源于 blockmatic/basilic-skills。它的核心用途是帮助用户处理冲突、分离头指针(detached HEAD)、上游分支分叉(upstream divergence)以及类似的本地 Git 问题。
主要能力与工作方式:
-
先检查后操作。技能要求先查看 git status、git branch -vv 以及相关的日志(log),然后用一句话说明当前遇到的问题。
-
提出最小化的安全命令。在确认问题后,技能会建议尽可能小、尽可能安全的命令,并解释这些命令会改变什么。
-
对危险操作要求确认。对于可能丢弃本地更改的命令,例如 git reset --hard、git clean、git restore,技能要求用户明确确认后才执行。对于改写历史的命令,例如 git rebase、对已发布提交执行 git commit --amend,技能要求用户明确请求后才执行。
-
执行后复查。在获得授权并执行命令后,技能会重新检查状态和剩余的冲突,确保问题得到妥善处理。
-
安全边界。技能明确不强制推送(force-push),也不绕过钩子(hooks)。同时遵循 git publish 的规范,除非用户要求,否则不改写已发布的历史。
适用场景:
- 本地 Git 仓库出现合并冲突需要解决时。
- 处于分离头指针状态,需要恢复或切换分支时。
- 本地分支与上游分支出现分叉,需要理清关系时。
- 其他类似的本地 Git 问题排查与修复。
限制与注意事项:
- 该技能主要面向本地 Git 问题的诊断与修复,不涉及远程仓库的强制推送或绕过钩子等操作。
- 对于会丢弃本地更改或改写历史的命令,必须经过用户明确确认或请求,不会自动执行。
- 关于该技能的安装方式、具体命令示例、支持的平台或版本要求,当前资料暂未提供。