GitFlow：自动化Git冲突诊断与修复的智能工作流助手

介绍一个专为AI Agent设计的Git工作流自动化技能，能够自动诊断和解决Git冲突、分支混乱和错误提交，通过自动化恢复、PR生成和文档同步，实现Git工作流的智能化管理。

GitFlow的设计初衷源于对现代开发工作流的深刻观察：Git虽然强大，但其复杂性也给开发者带来了不小的认知负担。特别是在紧急情况下，开发者可能因为操作失误导致代码丢失或仓库状态混乱。

项目的核心理念可以概括为三个关键词：自动恢复、标签化PR、文档同步。当检测到Git工作流问题时，Agent首先尝试自动诊断和修复；所有修复操作都通过带有适当标签的Pull Request进行报告；同时，相关的文档也会自动更新以保持同步。

这种设计哲学体现了对开发者时间的尊重——让机器处理重复性的诊断和修复工作，让开发者专注于更有创造性的任务。同时，通过PR机制确保所有自动化操作都是透明和可审计的。

GitFlow的功能体系围绕Git工作流的完整生命周期设计，从问题诊断到自动修复，再到报告生成，形成闭环。

诊断是一切自动化操作的基础。GitFlow通过综合分析多个Git命令的输出来识别问题的根本原因。具体来说，它会检查git status了解当前工作区状态，查看git log掌握提交历史，分析git reflog追踪引用变更记录。

这种多维度的分析方法能够识别各种常见的Git问题场景：分离的HEAD状态通常意味着开发者切换到了某个历史提交；合并冲突表明分支之间存在无法自动调和的代码变更；丢失的提交可能源于错误的重置操作；而未提交的本地变更则可能因切换分支而面临丢失风险。

GitFlow采用分层的风险评估策略，根据操作的危险程度决定自动化级别。这种谨慎的态度是必要的，因为Git操作有时具有破坏性，错误的自动化决策可能导致数据丢失。

安全级别的操作包括分离HEAD状态修复和标准合并冲突解决。这类操作风险较低，Agent可以直接执行恢复并生成PR报告。例如，当检测到分离HEAD时，Agent可以自动创建分支保存当前状态，然后引导回到正确的分支。

警告级别涉及可能丢失本地未提交变更的场景。在这种情况下，Agent会首先创建安全备份分支，然后执行修复操作，同时主动通知用户发生了什么以及采取了哪些保护措施。

危险级别包括强制推送和永久删除提交等不可逆操作。对于这类操作，Agent严格遵循人工确认原则，提供清晰的选项供用户选择，绝不会擅自执行。

所有自动化修复完成后，GitFlow会使用GitHub CLI（gh）创建Pull Request。这种设计有几个好处：首先，它保持了代码审查的文化，即使是自动化操作也需要通过PR流程；其次，它提供了完整的审计追踪，团队成员可以看到Agent做了什么以及为什么这么做；最后，它允许人类开发者审查和微调自动化修复的结果。

PR标题遵循严格的标签格式：[label] 修复摘要。项目定义了完整的标签体系：[feat]用于新功能，[fix]用于Bug修复，[style]用于代码格式调整，[docs]用于文档更新，[refactor]用于代码重构，[chore]用于构建流程，[ci]用于CI/CD变更。

这种标签化方法不仅使PR一目了然，也便于后续的变更日志生成和版本管理。

当技能的核心逻辑或设计理念发生变化时，GitFlow会自动更新README.md和SKILL.md以保持文档的准确性。这种文档与代码同步的机制解决了软件项目中常见的文档过时问题。

在许多项目中，代码 evolves 而文档 stagnates，导致新成员难以快速理解系统，老成员需要依赖口头传承的知识。GitFlow通过自动化文档同步，确保知识始终以书面形式存在，并且与当前实现保持一致。

GitFlow的技术栈设计简洁而实用，充分利用了现有的工具和平台。