1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | resolving-merge-conflicts-mattpocock-skills |
| 作者/维护者 | Matt Pocock（个人开发者） |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/engineering/resolving-merge-conflicts |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 235,290（GitHub API；为 mattpocock/skills 合集仓库整体星数，不代表本技能自身热度） |
| Forks | 20,048（GitHub API，同上，合集整体口径） |
| 最新版本 | v1.2.3（GitHub Releases，发布于 2026-08-06） |
| 安装方式 | Claude Code 官方插件市场一键安装（含本技能），或通用安装器选择性安装到任意支持 SKILL.md 的 agent |
2. 功能介绍与亮点
resolving-merge-conflicts 是一个专注于处理进行中的 git merge/rebase 冲突的工程技能。它不是简单地“挑一边保留”，而是走一条完整的五步流程：
- 查看合并/变基当前状态，检查 git 历史与冲突文件；
- 为每个冲突找到“原始来源”——通读 commit message、检查 PR、核对原始 issue/工单，理解每处改动背后的真实意图；
- 逐个 hunk 解决冲突：尽量保留双方意图，若不兼容则按合并目标选定一方并记录取舍，绝不臆造新行为，且绝不使用
--abort中途放弃； - 找出项目自身的自动化检查（通常是类型检查、测试、格式化）并运行，修复合并过程中破坏的部分；
- 完成合并/变基：暂存全部改动并提交；若是变基场景则持续推进直到全部 commit 完成。
亮点：
- 意图溯源方法论——不是纯语法层面的自动合并，而是要求追溯每处改动的原始 PR/issue 语境，减少“技术上合并成功但语义丢失”的风险；
- 强制完成纪律——明确禁止
--abort，逼迫把冲突真正解决到底而不是半途而废； - 隶属于一个持续活跃维护、MIT 完全开源的大型技能合集（仓库最近一次提交在 2026-08-24），且已被官方 Claude Code 插件市场收录（v1.2.3，含 25 个技能）；
- 目录下自带 Codex 适配元数据文件（
agents/openai.yaml），是该技能专门做过跨 agent 适配的直接证据。
3. 适用场景
所属分类：工程效率与代码质量
适用于开发者或团队在 git 合并/变基过程中遇到 git 无法自动解决的冲突，尤其是：
- 多人协作、长期存在的功能分支合并回主干时的复杂冲突；
- 冲突双方改动都带有明确业务意图（而非纯格式差异），需要判断取舍而非机械合并；
- 希望合并完成后立即跑通项目自身测试/类型检查，确认没有引入回归的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场 mattpocock-skills（v1.2.3）一键安装，含本技能 |
| Codex | 需适配 | 通过通用安装器 npx skills@latest add 选装；技能目录自带 agents/openai.yaml 元数据，是专门适配 Codex 的直接证据；仓库 ADR 文档显示原生 Codex 插件仍在路线图上 |
| OpenClaw | 需适配 | SKILL.md 为通用格式，官方安装器面向任意 agent；第三方技能目录站点已将本仓库收录并归入 OpenClaw 分类，但无官方原生集成 |
| Hermes Agent | 未验证 | 未找到该技能在 Hermes Agent 官方文档或市场中的直接确认记录 |
5. 推荐理由
这是一个把“合并冲突”当作需要理解语境、而非机械合并的问题来处理的技能：逐块追溯每处改动背后的原始意图，解决完再跑一遍项目自己的检查，全程不允许中途放弃。它不依赖任何外部服务或付费订阅，纯粹基于 git 与项目现有工具链工作，安装门槛低，规则清晰可预期。目前池内已知问题只有一条关于措辞严谨性的建议（非功能缺陷），是同类技能中证据最干净的一个。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | skills.sh 显示该子技能独立安装量约 35.6 万次，是同仓库内数一数二的高频安装项；合集仓库整体星数为 23.5 万，是整个仓库共享的数字，不代表本技能自身热度 |
| 可用性 | 8 | SKILL.md 五步流程清晰、单条指令触发、无需额外配置；仓库最近一次提交在 2026-08-24，本技能内容最近一次实质更新在 2026-07-13；GitHub 按标题检索仅命中 1 条 open issue，且是关于措辞严谨性的文档建议，非功能性缺陷 |
| 安全性 | 9 | 不安装任何外部依赖、不联网外发、不涉及任何凭据；仅执行 git 操作与项目自身已有的检查命令（类型检查/测试/格式化）；MIT 完全开源可审计 |
安全检查清单：
① Shell 命令与权限范围：会执行 git add/git commit 及项目自身已有的检查脚本，范围限定在当前仓库状态与既有工具链内，无越权操作
② 联网外发：无
③ API Key/凭据：不涉及
④ 可疑指令：全文通读未见任何要求模型执行无关操作或外发数据的迹象
⑤ 作者信誉：Matt Pocock，个人开发者，无造假迹象
⑥ License：MIT，明确
⑦ 最近维护：仓库整体 2026-08-24 有提交，本技能内容最近一次改动 2026-07-13
7. 跟同类 Skills 相比的优势
| 名称 | 定位 | 差异点 |
|---|---|---|
| resolving-merge-conflicts（本技能） | Agent Skill，聚焦冲突语义溯源 + 强制跑通项目自身检查后再提交 | 免费开源，不依赖任何订阅或外部服务 |
| GitHub Copilot 合并冲突解决 | GitHub Copilot 付费计划内置的 IDE 级冲突建议功能（2026 年 7 月起面向全部付费计划开放） | 深度集成在 IDE 内，但依赖 Copilot 订阅，且不做“追溯 PR/issue 原始意图”这一层判断 |
| Conflict Resolution（第三方 Claude Code 技能，mcpmarket.com 收录） | 面向复杂代码冲突的结构化解决方法论，强调理解冲突历史并用语法检查/单元测试验证结果 | 同样聚焦冲突解决与结果验证，但未见“绝不 –abort”这类强制完成纪律的设计 |
差异化总结：resolving-merge-conflicts 的核心壁垒不是“自动合并的准确率”，而是要求追溯原始 PR/issue 意图与强制走到底不许半途放弃这两条流程纪律，这在同类工具里较少见——多数方案止步于语法层面的自动合并建议。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。已核实的第三方汇总文章仅将其列入该仓库工程类技能清单，未对其展开单独评价。
9. 其他补充
本技能是 mattpocock/skills 官方插件包（当前 25 个技能）的一部分，随整个插件包一起接受版本更新；单独通过通用安装器安装时同样会跟随原仓库的更新节奏（npx skills update 可拉取最新版本）。
10. 安装使用方式
Claude Code（官方插件市场，推荐）：
/plugin install mattpocock-skills或命令行：
claude plugins install mattpocock-skills安装后建议运行一次 /setup-matt-pocock-skills 完成本仓库的初始化配置（issue 追踪器、标签、文档路径等），但该配置并非本技能工作的前提条件。
Codex / OpenClaw / 其他支持 SKILL.md 的 agent：
npx skills@latest add mattpocock/skills安装时在交互式选择列表中勾选 resolving-merge-conflicts。
触发方式：当前仓库存在 git 尚未解决完的 merge/rebase 冲突时，调用 /resolving-merge-conflicts。无需重启 agent 即可生效。
11. 注意事项
- SKILL.md 正文仅 918 字节，非常精简，未附带分步示例或复杂边缘场景演练，依赖使用者本身具备一定的冲突判断能力；
- 会实际执行
git commit（变基场景下可能连续产生多个 commit）及项目自身的自动化检查命令，建议在有版本控制保护、可回滚的分支上使用； - 第三方安全审计中 Snyk 状态为 Warn（非 Fail），公开页面未展开具体触发原因；
- 属于
mattpocock/skills合集仓库的一部分，若通过官方插件包整体安装，会同时装入该仓库内的其余二十余个技能，而非仅安装本技能。