SuperAPI AI 工具集

oh-conflict

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:解决 Pull Request 上的合并冲突。它在隔离的 git worktree 中工作,将 base 分支合并进 PR head,在理解双方改动意图的前提下解决冲突,验证后推送。

调用方式:/oh-conflict <pr-number>,参数为存在合并冲突的 PR 编号。

前提条件:需在 PR 所在仓库根目录运行;PR 应来自 oh-task 会话(分支名为 issue/<number>)。

主要流程:从 AGENTS.md、相关 .oh/ 产物及可用的 RNA MCP 上下文加载项目背景;用 gh pr view 获取 head 与 base 分支名;git fetch origin 后创建 worktree(git worktree add .worktrees/conflict-<pr-number> -B $BRANCH origin/$BRANCH);通过关联 issue 与 git log、git diff 理解 PR 意图;执行 git merge origin/$BASE --no-edit 触发冲突;逐文件解决并 git add;用 git diff --name-only --diff-filter=U 与 git grep 检查无冲突标记,再运行项目检查(如 pnpm typecheck、pnpm test 或 cargo check、cargo test,按项目构建系统调整),检查失败时不得提交或推送;对暂存的冲突解决结果无条件运行仓库本地 /review 技能,按 P1-P3、P4 分级处理;git commit --no-edit 完成合并提交并 git push;最后移除 worktree 并报告冲突文件、解决方式、验证问题与 PR URL。

冲突解决策略:简单情况可自动解决,如双方新增 import 则都保留、相邻不重叠改动都接受;锁文件冲突(package-lock.json、pnpm-lock.yaml、Cargo.lock)接受 base 版本后重新生成。复杂情况需手动解决,如双方修改同一函数、文件被移动同时被编辑、双方修改 schema/type。架构性冲突或无语义冲突但合并后逻辑错误时应上报为 blocked,交由人工决策。

限制与退出条件:成功为冲突全部解决、验证通过并推送;blocked 为需要人工架构决策;error 为无法在不破坏功能的情况下解决。完成后必须调用 signal_completion 工具作为最后动作,否则会话会孤立;若该工具不可用,则以 COMPLETION: status=<status> pr=<url> 或 COMPLETION: status=<status> error=<reason> 格式输出。资料未提供收费、价格与平台支持等信息。