智能 Git 操作助手

要解决什么问题

日常让 AI 帮你 git commit、merge 或 push 时，常见风险是：未确认就执行写操作、一次提交混入无关文件、合并冲突被粗暴自动解决、以及出事之后找不到「操作前」的 HEAD 与 diff。本 Skill 把 Git 写操作当成需要审计的流程，而不是一键脚本。

它如何工作

技能按固定 10 步工作流 运行，并在 Step 0 就识别模式（commit、commit-file、merge、rebase、push、all-in-one），展示将要执行的命令并等待 y/n 确认。

• 预检查：汇总脏工作区、未跟踪文件、是否落后于远程等警告，用户拒绝则中止。
• 快照与暂存策略：记录操作前 HEAD hash 与完整 diff；commit-file 只暂存非目标变更，避免把无关改动带进提交。
• 差异分析：列出变更文件、行数统计，并提示调试代码、临时注释等不宜提交的内容。
• 冲突处理：merge/rebase 后若存在冲突，不自动合并；展示 <<<<<<< 区块，逐文件引导标记已解决后再 continue/commit。
• 提交消息：Step 7 不直接提交——先生成默认消息模板，用户可 y/n 或自定义；选 n 则撤回，恢复到操作前状态。
• 报告与回退：操作结束后优先调用 scripts/generate_git_report.py 生成 HTML 报告，失败则降级 Markdown；报告内包含基于 pre-hash 的回退命令。

默认行为是 只提交不上传：除非用户明确要求，push 不会执行。

适用边界

• 复杂冲突（同一区域双方修改）需人工介入，Skill 只辅助展示与步骤，不替你做语义级合并决策。
• 每次提交强调 单一逻辑变更；大范围混提需要你自己拆分意图或多次走流程。
• HTML 报告依赖 Python3 与捆绑脚本；环境不满足时仍可用 Markdown 报告，但可视化程度会下降。