Git工作流助手免费版

Git 工作流助手（免费版）

概述

本工具为独立开发者提供 Git 日常操作的结构化指引，覆盖分支管理、冲突解决、提交规范三大核心场景。通过自然语言指令驱动，帮助开发者快速完成版本控制任务，降低 Git 学习成本，提升提交信息质量。免费版聚焦个人开发场景中的高频操作，提供开箱即用的命令速查与规范模板.

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：冲突解决与提交规、范助手、覆盖个人开发者日、常版本控制场景、面向独立开发者的、工作流辅助工具、聚焦分支管理、范三大核心能力、分支创建、合并的标准化操作、合并冲突识别与基、础解决策略、提交规范生成、命令速查与撤销回、滚操作等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：个人项目分支规划

开发者需要在个人项目中规划功能分支，保持主分支稳定.

用户：我要开发登录功能，帮我规划分支策略
# ...
助手：
1. 从 main 分支创建功能分支
   git checkout -b feature/login main
# ...
2. 开发完成后提交
   git add .
   git commit -m "feat(auth): 添加登录功能"
# ...
3. 合并回主分支
   git checkout main
   git merge feature/login
   git branch -d feature/login

场景二：规范化提交信息生成

开发者完成代码改动后，需要生成符合规范的提交信息.

用户：为以下改动生成提交信息
- 修改了支付模块的金额计算逻辑
- 修复了小数精度丢失问题
# ...
助手：
git commit -m "fix(payment): 修复支付金额计算精度丢失问题
# ...
- 使用整数分单位替代浮点元单位
- 统一金额计算入口方法
- 补充边界测试用例"

场景三：合并冲突处理

功能分支合并时出现冲突，需要快速定位并解决.

用户：合并 feature/login 时出现冲突，怎么处理
# ...
助手：
1. 查看冲突文件
   git status
# ...
2. 冲突标记格式
   <<<<<<< HEAD
   当前分支内容
   =======
   合并分支内容
   >>>>>>> feature/login
# ...
3. 手动编辑后标记解决
   git add .
   git commit
# ...
4. 如需放弃合并
   git merge --abort

不适用场景

以下场景Git工作流助手免费版不适合处理：

• 实际人员绩效评估
• 财务预算审批
• 合同法务审核

触发条件

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求.

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

基础配置

# 初始化身份信息
git config --global user.name "Your Name"
email "email@example.com"
# ...
# 设置默认分支名
git config --global init.defaultBranch main
# ...
# 配置常用别名
git config --global alias.co checkout
lg "log --graph --oneline --all"

常用命令速查

# 状态查看
git status                         # 查看工作区状态
git log --oneline                  # 简洁日志
git log --graph --oneline --all    # 图形化日志
git diff                           # 查看未暂存改动
git diff --staged                  # 查看已暂存改动
git show COMMIT_ID                 # 查看提交详情
# ...
# 分支操作
git branch                         # 本地分支列表
git branch -a                      # 所有分支（含远程）
git branch feature/login           # 创建分支
git checkout -b feature/login      # 创建并切换
git switch -c feature/login        # 新语法创建并切换
git checkout feature/login         # 切换分支
git switch feature/login           # 新语法切换
git branch -d feature/login        # 安全删除（已合并）
git branch -D feature/login        # 强制删除
# ...
# 合并操作
git merge feature/login            # 合并分支
git merge --no-ff feature/login    # 禁用快进合并（保留记录）
# ...
# 远程操作
git remote -v                      # 查看远程仓库
git fetch origin                   # 获取远程更新
git pull origin main               # 拉取并合并
git push origin main               # 推送到远程
git push -u origin feature/login   # 推送并设置上游

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

提交规范模板

Conventional Commits 格式：

(): 
# ...

# ...

暂存操作配置

git stash                          # 暂存当前修改
git stash save "WIP: 登录功能"     # 带消息暂存
git stash list                     # 查看暂存列表
git stash pop                      # 恢复并删除暂存
git stash apply                    # 恢复但保留暂存
git stash drop stash@{0}           # 删除指定暂存
git stash clear                    # 清空所有暂存

最佳实践

1. 提交前先拉取：避免不必要的冲突

   git pull --rebase origin main
   

2. 功能分支及时合并：避免长期分叉导致冲突累积

3. 避免直接提交到 main：通过功能分支合并

4. 重要操作先备份：危险操作前创建备份分支

   git branch backup-before-reset
   

5. 提交粒度适中：一个提交解决一个问题

6. 使用 .gitignore：忽略不需要追踪的文件

常见问题

Q1：如何撤销最后一次提交但保留改动？

git reset --soft HEAD~1

Q2：如何修改最后一次提交的信息？

git commit --amend -m "新的提交信息"

Q3：如何恢复误删的分支？

git reflog                        # 查找分支最后的提交
git checkout -b recovered-branch COMMIT_ID

Q4：如何回滚某个提交？

git revert COMMIT_ID              # 生成一个反向提交
git revert --no-commit COMMIT_ID  # 不自动提交

Q5：合并冲突太多想放弃怎么办？

git merge --abort                 # 取消合并，恢复合并前状态

Q6：如何清理未追踪的文件？

git clean -n                      # 预览将要删除的文件
git clean -f                      # 删除未追踪文件
git clean -fd                     # 删除未追踪文件和目录

依赖说明

运行环境

• Agent 平台: 支持读取 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统: Windows / macOS / Linux
• Git 版本: 建议 2.20 及以上

依赖详情

API Key 配置

• 本工具为纯 Markdown 指令驱动，无需额外 API Key
• Git 远程推送需要配置 SSH Key 或个人访问令牌

可用性分类

• 分类: MD+EXEC（Markdown 指令 + 命令行执行）
• 说明: 通过自然语言指令驱动 Agent 执行 Git 操作，部分功能需要 exec 命令行执行能力

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

输出格式

{
  "success": true,
  "data": {
    "result": "Git工作流助手免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "git workflow cn"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}