Git命令行助手免费版

Git命令行助手 - 免费版

概述

Git命令行助手免费版为开发者提供日常Git CLI操作辅助能力。工具提供快速命令参考表、仓库状态检查、暂存提交操作和远程同步指引,帮助开发者高效使用Git命令行. 本版本适合日常Git命令行操作、快速查找命令和新手学习Git CLI。所有操作遵循安全优先原则,避免误操作.

核心能力

1. 快速参考表

最常用的Git命令速查.

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

2. 仓库状态检查

输入格式

# 快速状态检查
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  # 图形化历史

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

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

3. 暂存与提交

# 暂存文件
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 "新信息"       # 修改提交信息

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

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

4. 分支管理

# 查看分支
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      # 重命名分支

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

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

5. 远程同步

# 获取远程更新
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的核心能力覆盖以下场景关键词：CLI、暂存提交与分支同、适合开发者日常命、令行操作、面向开发者的、命令行辅助工具、提供快速命令参考、暂存提交与远程同、步操作指引、核心能力、分支管理与远程同、安全操作指引等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

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

使用场景

场景一:日常开发工作流

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

#!/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=== 工作流完成 ==="

场景二:快速状态诊断

快速了解当前仓库状态.

#!/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

场景三:安全回退操作

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

#!/bin/bash
# 安全回退操作
echo "=== 安全回退操作 ==="
# ...
# 1. 丢弃工作区变更(未暂存)
echo "丢弃未暂存变更:"
echo "  git restore           # 丢弃单个文件"
echo "  git restore .               # 丢弃所有"
# ...
# 2. 取消暂存(已暂存未提交)
echo -e "\n取消暂存:"
echo "  git restore --staged  # 取消暂存单个文件"
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      # 创建反向提交"
echo "  git push origin     # 推送撤销"
# ...
echo -e "\n注意:避免使用 git reset --hard 和 git push --force"

不适用场景

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

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

触发条件

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

快速开始

Step 1:验证Git环境

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

Step 2:触发操作

在 AI Agent 中输入:

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

Step 3:执行命令

Agent 会按安全优先原则执行Git命令. 响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

Git CLI配置

# ~/.gitconfig
[user]
    name = 你的名字
    email = your@email.com
# ...
[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

# 通用
*.log
*.tmp
*.bak
.DS_Store
Thumbs.db
# ...
# IDE
.vscode/
.idea/
*.swp
# ...
# 依赖
node_modules/
__pycache__/
venv/
# ...
# 环境
.env
.env.local

最佳实践

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

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

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

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

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

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

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

# 安全(推荐)
git push --force-with-lease
# ...
# 危险(不推荐)
# git push --force

常见问题

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

# 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:如何查看某个文件的修改历史?

# 文件提交历史
git log --oneline -- file.txt
# ...
# 文件每行最后修改者
git blame file.txt
# ...
# 文件差异历史
git log -p file.txt
# ...
# 文件重命名历史
git log --follow file.txt

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

# 保存当前工作
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:免费版与专业版有何区别?

依赖说明

运行环境

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

依赖详情

API Key 配置

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

# HTTPS凭证
git config --global credential.helper store
# ...
# SSH密钥
ssh-keygen -t ed25519 -C "your@email.com"

可用性分类

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

错误处理

已知限制

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

输出格式

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