SuperAPI AI 工具集

git-techniques

编程与开发

查看项目

更新于 10-29 18:03

技能介绍

Git Techniques 是一个面向高级 Git 调查、恢复与调试的技能,用于处理 reflog 恢复、历史搜索、行级历史、blame 追踪、bisect、fixup/autosquash、worktree、stash 检查以及大型仓库检出选项。日常的提交、推送、分支和 PR 遵循配套的 git 安全技能与仓库的 AGENTS.md;仓库自身的 worktree、分支和合并规则优先于该技能的任何内容。

安全约定

默认使用只读命令,例如 status、log、show、diff、blame、reflog、log -S、log -G、log -L 和 worktree list。

除非用户明确请求某一具体操作,否则不执行会修改状态的操作,包括 reset、rebase、commit --amend、任何形式的强制 push、worktree add/remove、sparse-checkout 或 clone-filter 变更、范围较广的 stash 操作、全局/系统配置变更、maintenance 以及 blame-ignore-revs 变更。

不要在自动化环境中运行交互式命令,例如 add -p、checkout -p、stash -p 或 rebase -i;除非用户明确要求并提供了交互式环境。优先使用指定路径和明确的非交互式命令。

保留与任务无关的工作区改动。明确说明正在暂存、检查或恢复的文件。绝不提交或推送本次会话未产生或无法解释的改动。

在执行用户明确授权的丢弃操作之前,在适用情况下使用配套的 git recovery-save 路径。

默认不重写已推送或共享的历史。若用户明确授权远程重写且仓库策略允许,优先使用 --force-with-lease 而非 --force。

技术要点

恢复:使用 git reflog 查找先前的 HEAD@{n},用 git show HEAD@{n} 检查,然后才执行经明确批准的 reset。reflog 条目通常保留约 90 天,但不作保证。

历史搜索:使用 git log -S "<string>" --oneline 查找字符串的增删,使用 git log -G "<regex>" 进行模式匹配,必要时加 --pickaxe-regex。git log --grep 仅用于提交信息搜索。

行级历史:使用 git log -L <start>,<end>:<file> 或 git log -L :<function>:<file> 查看特定行或函数的差异。

Blame 追踪:使用 git blame -w -C -M <file> 忽略空白、移动和复制带来的干扰。修改 blame-ignore 配置或提交 ignore-revs 文件需要明确批准。

Stash 检查:优先使用具名 stash,用 git stash list 和 git stash show -p stash@{n} 检查;不确定时应用而非丢弃。仅在明确要求时包含未跟踪文件或较广的路径。

Fixup/autosquash:仅对明确请求的本地历史重写使用 git commit --fixup=<commit> 加 autosquash rebase。未经明确批准,不要重排或压缩共享历史。

Bisect:要求工作区干净、测试命令经明确批准且退出码可信,并且始终以 git bisect reset 结束。报告问题提交及验证证据。

Worktrees:遵循仓库的 worktree 流程。不要为规避 stash 而创建第二个克隆或多余 worktree;只移除任务自己创建的 worktree,并在确认无遗留工作后进行。

部分暂存:在自动化中按明确路径拆分提交,而不是交互式逐块编辑。

大型仓库:仅在用户明确请求的新检出中使用浅克隆、blob-filter 或 sparse-checkout 克隆。绝不在已有源码受控目录内初始化或重构克隆。

性能与显示设置:提出别名和配置变更建议供用户批准;未经明确请求不写入全局配置。

报告

说明已运行的命令、发现的证据、适用的确切恢复或问题目标、未改动的内容以及下一步安全操作。对于任何拟议的修改,给出确切命令、影响范围和回滚路径,然后等待批准。