📌 Skill基础信息
- Skill名称:resolving-merge-conflicts(Git合并冲突解决)
- 简称:合并冲突解决器
- 来源:社区第三方(FradSer开发)
- 运行宿主:Claude-Code CLI
- 核心定位:专门用于智能化解决Git合并/变基过程中的代码冲突,帮助开发者保持代码意图完整性并确保合并质量。
🧩 内部核心组成
该Skill为基于规则指导的智能冲突解决工具,主要组成如下:
| 组件类型 | 功能描述 |
|---|---|
| 规则引擎 | 提供冲突解决的智能决策框架 |
| 意图分析模块 | 解析冲突双方的代码变更意图 |
| 验证检查器 | 集成项目自动化检查流程(类型检查、测试、格式化) |
核心工作原则:
- 深度理解每个冲突的来源和原始意图
- 优先保留双方意图,仅在必要时做取舍
- 禁止创造新行为,严格遵循原始变更目标
- 强制完成解决流程,禁止中止操作
🛠 安装与启用方式
安装命令:
skills install --user FradSer/dotclaude
前置要求:
- 已安装并配置Claude-Code CLI环境
- 本地存在正在进行中的Git合并/变基冲突状态
- 具备访问相关Git历史、PR和issue的权限
启用方式:在存在Git冲突的项目目录中直接调用该Skill
📋 标准工作流
- 冲突状态检测:Skill自动识别当前Git合并/变基冲突状态
- 冲突分析阶段:
- 检查Git历史记录和冲突文件
- 追溯每个冲突的主要来源(提交信息、PR、原始工单)
- 深度理解每个变更的原始意图和目的
- 冲突解决执行:
- 逐块(hunk)解决冲突,优先保留双方意图
- 在意图冲突时选择符合合并目标的方案并记录取舍
- 严格遵守"不创造新行为"原则
- 质量验证阶段:
- 发现并运行项目的自动化检查(类型检查→测试→格式化)
- 修复合并过程中引入的任何问题
- 完成操作:
- 暂存所有变更并提交
- 如果是变基操作,继续直到所有提交完成变基
⚠️ 关键限制、缺陷、注意事项
平台限制:
- 仅支持Git版本控制系统
- 依赖完整的Git历史记录和元数据访问权限
Token消耗:中等偏高(需要分析大量历史上下文和代码变更)
适用项目类型:
- 具有完整Git历史和文档的项目
- 代码库结构清晰、提交规范的项目
不适用场景:
- Git历史记录不完整或混乱的项目
- 紧急需要快速解决冲突的场景(需要深度分析)
- 冲突涉及二进制文件或非代码文件
生产环境适用性:建议在重要合并前进行测试验证,但具备生产环境使用潜力
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景:
- 大型项目的复杂合并冲突解决
- 需要保持代码意图完整性的重要合并
- 具有完整文档和历史记录的专业项目
- 开发团队注重代码质量和变更追溯性
❌ 不适合场景:
- 简单或明显的冲突解决(过于重量级)
- 时间紧迫需要快速解决的场景
- Git历史记录缺失或质量差的项目
- 新手开发者学习基础Git操作的场景
如何安装
skills install --user FradSer/dotclaude通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com