Git 分支管理、冲突解决与提交规范助手,覆盖个人开发者日常版本控制场景。
Git 工作流助手(免费版)是一项面向实际任务的技能,主要用于本工具为独立开发者提供 Git 日常操作的结构化指引,覆盖分支管理、冲突解决、提交规范三大核心场景;通过自然语言指令驱动,帮助开发者快速完成版本控制任务,降低 Git 学习成本,提升提交信息质量;
它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
本工具为独立开发者提供 Git 日常操作的结构化指引,覆盖分支管理、冲突解决、提交规范三大核心场景。通过自然语言指令驱动,帮助开发者快速完成版本控制任务,降低 Git 学习成本,提升提交信息质量。免费版聚焦个人开发场景中的高频操作,提供开箱即用的命令速查与规范模板。
| 能力模块 | 描述 | 典型用法 |
|---|---|---|
| 分支管理 | 创建、切换、合并、删除分支 | 创建并切换到 feature/login 分支 |
| 冲突解决 | 识别冲突标记并提供解决策略 | 帮我解决 Git 合并冲突 |
| 提交规范 | 生成符合 Conventional Commits 的提交信息 | 为这些改动生成提交信息 |
| 撤销回滚 | 撤销暂存、回滚提交、恢复删除文件 | 撤销最后一次提交 |
技术实现要点:核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。 |
用input_params参数进行配置。
输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作用config_options参数进行配置。
输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
config_options参数,支持修改/重置/导入操作用output_format参数进行配置。
输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
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工作流助手免费版不适合处理:
需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求。
# 初始化身份信息 git config --global user.name "Your Name" git config --global user.email "email@example.com" # 设置默认分支名 git config --global init.defaultBranch main # 配置常用别名 git config --global alias.co checkout git config --global alias.br branch git config --global alias.ci commit git config --global alias.st status git config --global alias.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 # 推送并设置上游
结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。
-D: 命令参数,用于指定操作选项Conventional Commits 格式:
( ):
| Type | 描述 | 示例 |
|---|---|---|
| feat | 新功能 | feat(auth): 添加登录功能 |
| fix | 修复缺陷 | fix(api): 修复接口超时 |
| docs | 文档更新 | docs(readme): 更新安装说明 |
| style | 代码格式 | style: 格式化代码 |
| refactor | 重构 | refactor(utils): 优化工具函数 |
| perf | 性能优化 | perf(list): 优化列表渲染 |
| test | 测试 | test(auth): 添加登录测试 |
| chore | 构建/工具 | chore: 更新依赖 |
| revert | 回滚 | revert: 回滚登录功能 |
git stash # 暂存当前修改
git stash save "WIP: 登录功能" # 带消息暂存
git stash list # 查看暂存列表
git stash pop # 恢复并删除暂存
git stash apply # 恢复但保留暂存
git stash drop stash@{0} # 删除指定暂存
git stash clear # 清空所有暂存
提交前先拉取:避免不必要的冲突
git pull --rebase origin main
功能分支及时合并:避免长期分叉导致冲突累积
避免直接提交到 main:通过功能分支合并
重要操作先备份:危险操作前创建备份分支
git branch backup-before-reset
提交粒度适中:一个提交解决一个问题
使用 .gitignore:忽略不需要追踪的文件
git reset --soft HEAD~1
git commit --amend -m "新的提交信息"
git reflog # 查找分支最后的提交 git checkout -b recovered-branch COMMIT_ID
git revert COMMIT_ID # 生成一个反向提交 git revert --no-commit COMMIT_ID # 不自动提交
git merge --abort # 取消合并,恢复合并前状态
git clean -n # 预览将要删除的文件 git clean -f # 删除未追踪文件 git clean -fd # 删除未追踪文件和目录
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Git | 命令行工具 | 必需 | 系统包管理器安装 |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |