Git

• 仓库任务：任何涉及 Git 仓库的操作——创建分支、暂存更改、提交、推送或发起拉取请求。
• 团队协作：当历史记录安全性至关重要，且需要自动执行功能分支流程、热修复工作流或符合 PR 规范的提交规范时。
• 调试历史记录：当需要使用 git bisect 追踪回归问题、通过 git reflog 恢复丢失的提交，或安全撤销更改时。
• 冲突解决：当合并或变基产生冲突，且代理需要一种结构化、经过验证的方法来解决这些冲突时。

• 非 Git 版本控制：如果项目使用 Mercurial、SVN 或其他版本控制系统，则此技能的命令将不适用。
• 只读分析任务：如果代理只需要读取源代码而完全不需要与 Git 交互，则该技能会增加不必要的开销。

该技能强制使用 --force-with-lease 而非 --force，以防止覆盖团队成员的工作，并禁止对 main/master 等共享分支进行强制推送。在执行任何破坏性操作（如 reset --hard 或 rebase）之前，必须满足内置的安全检查清单。

包含针对功能分支和紧急修复场景的逐步流程，涵盖何时压缩提交、如何使用 git fetch --all --prune 进行同步，以及如何为版本打标签。适用于基于主干开发和 gitflow 风格的团队。

编辑冲突文件后，该技能使用 grep 验证是否仍存在冲突标记，确认代码能够成功构建，并在合并操作过于复杂时提供通过 git merge --abort 退出的应急方案。当合并变得混乱时，建议使用变基（rebase）作为替代方案。

涵盖使用 git reflog 恢复丢失的提交（最长约 90 天）、通过 SHA 恢复已删除的分支，以及使用 git reset --soft 撤销提交而不丢失工作内容。还包括完整的 git bisect 工作流程，用于精确定位引入回归问题的提交。

该技能要求提交信息遵循 type(scope): description 格式，首行不超过 72 个字符，并使用标准类型（feat、fix、docs、refactor 等）。这有助于保持提交历史的可读性，并与自动化变更日志工具保持兼容。

记录并防范常见的 Git 陷阱：游离的 HEAD 状态、macOS/Windows 与 Linux CI 之间的大小写敏感问题、子模块克隆错误、stash pop 冲突，以及提交大文件或敏感信息。使用 git add -p 进行精细化的部分暂存。

一个智能代理负责搭建新功能框架，从 main 创建分支，使用规范化提交信息进行增量提交，在推送前将其变基到最新的 main 之上，压缩修复提交，并开启一个可提交 PR 的分支——全程无需手动 Git 干预。

当发现生产环境缺陷时，代理从 main 检出一个 hotfix/ 分支，应用修复后，将其合并到 main 和 develop 两个分支，为发布版本打标签，并清理该分支——严格遵循已记录的热修复流程。

代理运行 git bisect，通过二分搜索的方式遍历提交历史，根据自动化测试结果将提交标记为好或坏，直到找出引入缺陷的确切提交。

在长期运行的功能变基过程中，智能体逐文件解决冲突，验证不存在残留的 <<</>>> 标记，确认构建通过，然后继续变基——若冲突过于复杂，则干净地中止变基操作。