Git Cli Tool Free

提供Git CLI快速参考、状态检查、暂存提交与分支同步,适合开发者日常命令行操作。

Git命令行助手 - 免费版

概述

Git命令行助手免费版为开发者提供日常Git CLI操作辅助能力。工具提供快速命令参考表、仓库状态检查、暂存提交操作和远程同步指引,帮助开发者高效使用Git命令行。

本版本适合日常Git命令行操作、快速查找命令和新手学习Git CLI。所有操作遵循安全优先原则,避免误操作。

核心能力

1. 快速参考表

最常用的Git命令速查。

任务	命令
状态与差异	git status / git diff / git diff --staged
暂存/取消	git add <path> / git add . / git restore --staged <path>
提交	git commit -m "message"
分支	git branch / git switch -c new / git switch existing
同步远程	git fetch / git pull / git push -u origin <branch>
暂存(stash)	git stash / git stash list / git stash apply
历史	git log --oneline --graph -n 20 / git blame <file>
克隆/初始化	git clone <url> / git init / git remote add origin <url>
远程	git remote -v / git remote show origin / git branch -vv
丢弃变更	git restore <file> / git restore --staged <file>
修改提交	git commit --amend --no-edit / git commit --amend -m "msg"
标签	git tag / git tag v1.0 / git push origin v1.0
合并/变基	git merge <branch> / git rebase <branch>

输入: 用户提供快速参考表所需的指令和必要参数。 处理: 按照skill规范执行快速参考表操作,遵循单一意图原则。 输出: 返回快速参考表的执行结果,包含操作状态和输出数据。

2. 仓库状态检查

bash

# 快速状态检查
git status                           # 当前状态
git status -sb                       # 简短状态+分支信息
git branch --show-current            # 当前分支名
git remote -v                        # 远程仓库
git log --oneline -5                 # 最近5个提交

# 差异检查
git diff                             # 工作区变更
git diff --staged                    # 暂存区变更
git diff --stat                      # 变更统计
git diff HEAD~1                      # 与上次提交比较

# 分支信息
git branch -a                        # 所有分支
git branch -vv                       # 分支跟踪信息
git log --graph --oneline --all -20  # 图形化历史

输入: 用户提供仓库状态检查所需的指令和必要参数。 处理: 按照skill规范执行仓库状态检查操作,遵循单一意图原则。 输出: 返回仓库状态检查的执行结果,包含操作状态和输出数据。

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

3. 暂存与提交

bash

# 暂存文件
git add file.txt                     # 暂存单个文件
git add .                            # 暂存所有变更
git add -A                           # 包括删除操作
git add -p                           # 交互式选择暂存

# 取消暂存
git restore --staged file.txt        # 取消暂存(新命令)
git reset HEAD file.txt              # 取消暂存(旧命令)

# 提交
git commit -m "提交信息"             # 基础提交
git commit -am "提交信息"            # 添加并提交已跟踪文件
git commit --amend --no-edit         # 修改提交(保持信息)
git commit --amend -m "新信息"       # 修改提交信息

输入: 用户提供暂存与提交所需的指令和必要参数。 处理: 按照skill规范执行暂存与提交操作,遵循单一意图原则。 输出: 返回暂存与提交的执行结果,包含操作状态和输出数据。

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

4. 分支管理

bash

# 查看分支
git branch                           # 本地分支
git branch -a                        # 所有分支
git branch -vv                       # 跟踪信息

# 创建和切换
git switch -c feature-name           # 创建并切换(推荐)
git switch main                      # 切换到main
git switch -                         # 切换到上一个分支

# 删除分支
git branch -d feature-name           # 安全删除(已合并)
git branch -D feature-name           # 强制删除

# 重命名
git branch -m old-name new-name      # 重命名分支

输入: 用户提供分支管理所需的指令和必要参数。 处理: 按照skill规范执行分支管理操作,遵循单一意图原则。 输出: 返回分支管理的执行结果,包含操作状态和输出数据。

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

5. 远程同步

bash

# 获取远程更新
git fetch origin                     # 获取不合并
git fetch --all --prune              # 获取所有并清理

# 拉取
git pull                             # 拉取并合并
git pull --rebase                    # 拉取并变基(推荐)

# 推送
git push                             # 推送当前分支
git push -u origin branch-name       # 首次推送并设置跟踪
git push --force-with-lease          # 安全强制推送

输入: 用户提供远程同步所需的指令和必要参数。 处理: 按照skill规范执行远程同步操作,遵循单一意图原则。 输出: 返回远程同步的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：CLI、暂存提交与分支同、适合开发者日常命、令行操作、面向开发者的、命令行辅助工具、提供快速命令参考、暂存提交与远程同、步操作指引、核心能力、分支管理与远程同、安全操作指引等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

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

使用场景

场景一:日常开发工作流

标准的命令行开发工作流。

bash

#!/bin/bash
# 日常开发工作流
echo "=== Git日常工作流 ==="

# 1. 开始工作前同步
echo "1. 同步远程仓库..."
git fetch --all --prune
git pull --rebase

# 2. 创建功能分支
echo -e "\n2. 创建功能分支..."
git switch -c feature/new-feature

# 3. 开发并提交
echo -e "\n3. 暂存并提交..."
git add .
git status
git commit -m "feat: 添加新功能"

# 4. 推送到远程
echo -e "\n4. 推送分支..."
git push -u origin feature/new-feature

# 5. 查看状态
echo -e "\n5. 当前状态:"
git status -sb
git log --oneline -3

echo -e "\n=== 工作流完成 ==="

场景二:快速状态诊断

快速了解当前仓库状态。

bash

#!/bin/bash
# 仓库状态诊断
echo "=== Git仓库状态诊断 ==="

echo "当前分支: $(git branch --show-current)"
echo "远程仓库:"
git remote -v

echo -e "\n工作区状态:"
git status -sb

echo -e "\n最近提交:"
git log --oneline -5

echo -e "\n未推送的提交:"
git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null

echo -e "\n暂存列表:"
git stash list

echo -e "\n分支概览:"
git branch -vv

场景三:安全回退操作

安全地回退不需要的变更。

bash

#!/bin/bash
# 安全回退操作
echo "=== 安全回退操作 ==="

# 1. 丢弃工作区变更(未暂存)
echo "丢弃未暂存变更:"
echo "  git restore <file>          # 丢弃单个文件"
echo "  git restore .               # 丢弃所有"

# 2. 取消暂存(已暂存未提交)
echo -e "\n取消暂存:"
echo "  git restore --staged <file> # 取消暂存单个文件"
echo "  git restore --staged .      # 取消所有暂存"

# 3. 撤销提交(保留变更)
echo -e "\n撤销提交(保留变更):"
echo "  git reset --soft HEAD~1     # 撤销提交,变更回到暂存区"
echo "  git reset HEAD~1            # 撤销提交,变更回到工作区"

# 4. 安全撤销已推送的提交
echo -e "\n撤销已推送提交(安全方式):"
echo "  git revert <commit-sha>     # 创建反向提交"
echo "  git push origin <branch>    # 推送撤销"

echo -e "\n注意:避免使用 git reset --hard 和 git push --force"

不适用场景

以下场景Git命令行助手免费版不适合处理：

• 无明确技术栈的模糊需求
• 纯架构设计决策
• 运维部署管理

触发条件

需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求。

快速开始

Step 1:验证Git环境

bash

git --version
git config user.name
git config user.email

Step 2:触发操作

在 AI Agent 中输入:

text

请帮我查看当前Git仓库状态并提交代码。

Step 3:执行命令

Agent 会按安全优先原则执行Git命令。

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

Git CLI配置

ini

# ~/.gitconfig
[user]
    name = 你的名字
    email = [e-mail]

[init]
    defaultBranch = main

[alias]
    st = status -sb
    co = checkout
    sw = switch
    br = branch
    ci = commit
    lg = log --graph --oneline --all
    last = log -1 HEAD
    diffstat = diff --stat

[pull]
    rebase = true

[push]
    default = current
    autoSetupRemote = true

常用.gitignore

gitignore

# 通用
*.log
*.tmp
*.bak
.DS_Store
Thumbs.db

# IDE
.vscode/
.idea/
*.swp

# 依赖
node_modules/
__pycache__/
venv/

# 环境
.env
.env.local

最佳实践

1. 安全优先:优先使用只读命令,避免破坏性操作

bash

# 先查看再操作
git status          # 查看状态
git diff            # 查看变更
git log             # 查看历史

2. 使用现代命令:switch和restore比checkout更清晰

bash

# 推荐(新命令)
git switch branch-name
git restore file.txt
git restore --staged file.txt

# 不推荐(旧命令,功能混淆)
# git checkout branch-name
# git checkout -- file.txt

3. 提交前检查:养成提交前检查的习惯

bash

git status          # 确认暂存内容
git diff --staged   # 确认变更内容
git log --oneline -3  # 确认提交历史

4. 使用--force-with-lease:替代--force

bash

# 安全(推荐)
git push --force-with-lease

# 危险(不推荐)
# git push --force

常见问题

Q1:git pull和git fetch有什么区别?

bash

# git fetch:只获取,不合并
git fetch origin
# 获取后可以查看差异
git diff HEAD origin/main
# 手动决定是否合并
git merge origin/main

# git pull:获取并自动合并
git pull
# 等同于 git fetch + git merge

# git pull --rebase:获取并变基(推荐)
git pull --rebase
# 等同于 git fetch + git rebase

Q2:如何查看某个文件的修改历史?

bash

# 文件提交历史
git log --oneline -- file.txt

# 文件每行最后修改者
git blame file.txt

# 文件差异历史
git log -p file.txt

# 文件重命名历史
git log --follow file.txt

Q3:如何临时保存当前工作?

bash

# 保存当前工作
git stash
git stash save "工作描述"

# 查看暂存列表
git stash list

# 恢复暂存(保留暂存)
git stash apply
git stash apply stash@{2}

# 恢复暂存(删除暂存)
git stash pop

# 删除暂存
git stash drop stash@{0}
git stash clear  # 清除所有

Q4:免费版与专业版有何区别?

能力维度	免费版	专业版
命令参考	基础命令	完整命令库
自动化	手动执行	脚本自动化
工作流	单人	团队工作流
诊断	基础状态	深度诊断
模板	基础.gitignore	多场景模板
故障排除	基础	深度排障

依赖说明

运行环境

• Agent 平台:支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统:Windows / macOS / Linux
• 运行时:Git 2.20+

依赖详情

依赖项	类型	是否必需	获取方式
Git	运行时	必需	git-scm.com 下载
Bash	运行时	推荐	系统自带
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

• 本 Skill 基于 Markdown 指令,无需额外 API Key
• 远程仓库认证:

bash

# HTTPS凭证
git config --global credential.helper store

# SSH密钥
ssh-keygen -t ed25519 -C "[e-mail]"

可用性分类

• 分类:MD+EXEC(纯 Markdown 指令,需要 exec 命令行执行能力)
• 说明:基于 Markdown 的 AI Skill,通过自然语言指令驱动 Agent 执行Git CLI操作
• 适用规模:个人开发者日常使用

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响