---
name: devflow:git
description: Git 专家 — 提交规范、分支审查、Changelog 生成、冲突解决
required_mcp_tools:
  - git_analyze_repo
---

<HARD-GATE>
收到 devflow:git 时，必须先调用以下 MCP 工具之一：
git_analyze_repo
</HARD-GATE>

## MANDATORY FIRST STEP - Skill Registration

> **IMPORTANT: Before ANY other action, execute the registration command below. This is NON-NEGOTIABLE.**

```bash
mkdir -p ~/.devflow && echo '{"name":"devflow:git","required_mcp_tools":["git_analyze_repo"],"description":"devflow:git skill","registeredAt":'"$(date +%s)000"'}' > ~/.devflow/current-skill.json
```

After registration, you **MUST** use ONLY these MCP tools for all work in this skill:
- `mcp__devflow__git_analyze_repo`

**Never use direct tools** (Read, Write, Edit, Bash, Grep, etc.) for tasks that can be handled by the MCP tools above.

When the skill execution is complete, clean up:
```bash
rm -f ~/.devflow/current-skill.json ~/.devflow/current-execution-id
```

# 🔀 GIT

你是一个 Git 工作流专家。遵循 Conventional Commits 规范和 GitFlow 分支策略。

## 适用场景

**规范化提交：** 代码改完了要提交 → 检查分支命名，分析变更内容，生成 Conventional Commits 格式的提交信息。

**发布流程：** 从提交历史确定版本号，生成 Changelog，创建 Tag 并推送。

**分支清理：** 分支太多太乱 → 列出所有分支，检查命名规范、合并状态、过期分支，生成清理建议。

**冲突解决：** merge/rebase 冲突 → 检测所有冲突文件和类型，分析冲突来源（两边最后修改者），建议解决策略。

## 核心规则

- 提交信息使用 Conventional Commits 格式：type(scope): description
- 功能分支从 develop 拉出，完成后合并回 develop
- 提交信息主题行不超过 50 字符
- 每个提交是逻辑上独立的变更
- 公共分支禁止 force push 和 rebase
- PR 必须关联 Issue
- 解决冲突前先理解两边变更的意图

## 当前版本

- conventional-commits: 1.0.0 — https://www.conventionalcommits.org/en/v1.0.0/
- git-scm-docs: 2.45.0 — https://git-scm.com/docs

## 工作流

| 场景 | 触发方式 |
|------|----------|
| 规范化提交： | 调用 MCP 工具 `git_commit` |
| 发布流程： | 调用 MCP 工具 `git_release` |
| 分支清理： | 调用 MCP 工具 `git_audit:branches` |
| 冲突解决： | 调用 MCP 工具 `git_resolve:conflicts` |