Git Workflow

---
name: git-workflow
description: "OpenClaw Git 工作流技能。\n \n 当用户提及以下任务时使用：\n - 提交代码或文档\n - 推送到远程仓库\n - 管理多个 Git 仓库\n - 查看 Git 状态\n \n 核心能力:\n - 自动检测文件变更\n - 自动生成提交信息\n - 自动推送到远程仓库\n - 多仓库管理"
---

# Git 工作流技能

## 核心指令

### 第一步：检测文件变更
```bash
# 检查 Git 状态
git status

# 查看变更文件
git diff --name-only
```

### 第二步：添加文件
```bash
# 添加所有变更
git add .

# 或添加指定文件
git add <file1> <file2>
```

### 第三步：生成提交信息
根据变更内容自动生成提交信息：

```bash
# 提交信息格式
<type>: <description>

# 类型说明
feat: 新功能
fix: 修复 bug
docs: 文档更新
style: 代码格式
refactor: 重构
test: 测试
chore: 构建/工具
```

### 第四步：提交并推送
```bash
# 提交
git commit -m "提交信息"

# 推送
git push
```

## 示例

### 示例 1: 分析完成后自动提交
**触发**: 分析任务完成

**操作**:
1. 检测新生成的文件
2. 添加到 Git
3. 生成提交信息
4. 提交并推送

**提交信息示例**:
```
feat: 完成股票分析

- 分析 000657 中钨高新
- 生成三高股票筛选报告
- 保存到 Stock-Analysis 仓库
```

### 示例 2: 多仓库管理
**触发**: 需要提交到多个仓库

**操作**:
1. 识别文件所属仓库
2. 分别提交到对应仓库
3. 分别推送

**仓库示例**:
- Jarvis: 记忆、配置
- Stock-Analysis: 股票分析代码
- Amazon-Analyzer: 亚马逊运营工具

## 故障排除

### 错误 1: Git 未配置
**错误消息**: "Please tell me who you are"

**解决方案**:
```bash
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
```

### 错误 2: 推送失败
**错误消息**: "Authentication failed"

**解决方案**:
1. 检查 Git 凭据
2. 使用 Token 代替密码
3. 配置 SSH Key

### 错误 3: 冲突
**错误消息**: "CONFLICT (content)"

**解决方案**:
1. 查看冲突文件
2. 手动解决冲突
3. 标记为解决
   ```bash
   git add <resolved_file>
   ```
4. 完成提交
   ```bash
   git commit
   ```

## 最佳实践

### 提交频率
- 小改动：随时提交
- 大功能：功能完成后提交
- 每日结束：提交当日工作

### 提交信息
- 清晰简洁
- 使用现在时
- 首字母大写
- 不超过 50 字符

### 分支管理
- main/master: 主分支
- feature/*: 功能分支
- fix/*: 修复分支
- docs/*: 文档分支