QClaw通过四大方案解决Git分支混乱与合并冲突问题：一、内置GitHub管理技能实现自然语言驱动的分支操作；二、智能冲突分析识别文件、行号及修改意图并提供建议；三、同步远程分支保护规则并前置校验；四、用Junction符号链接实现多Agent间Git技能隔离与状态共享。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QClaw 进行代码协作时遇到分支管理混乱或合并冲突难以定位的问题，则可能是由于缺乏对 Git 工作流的结构化支持与上下文感知能力。以下是针对该问题的多种辅助方案：
一、启用内置 GitHub 管理技能执行分支操作
QClaw 通过预装的 GitHub 管理技能，可直接解析自然语言指令并调用 Git 命令完成分支生命周期管理，无需手动输入 CLI，所有操作均在本地沙箱中执行，保障数据不出设备。
1、打开 QClaw 客户端，点击左下角「技能市场」按钮。
2、在搜索框中输入 GitHub 管理，确认状态为「已安装」；若未安装，点击「安装」并等待提示「技能加载完成」。
3、在微信中向已绑定的 QClaw 发送指令，例如：“在 my-project 仓库中基于 main 创建 feature/login 分支，并切换过去”。
4、QClaw 自动执行 git checkout -b feature/login 并返回操作成功提示及当前分支状态。
二、通过自然语言触发智能冲突分析与建议
当 Pull Request 或本地 merge 出现冲突时，QClaw 可读取 .git/REBASE_HEAD 或 MERGE_HEAD 文件内容，结合当前工作区变更，识别冲突文件、行号及修改意图，生成可执行的解决路径建议。
1、确保待分析项目已通过 git status 显示存在未合并冲突（如 “Unmerged paths”）。
2、在微信中发送：“分析当前仓库的合并冲突，并列出优先处理的三个文件”。
3、QClaw 扫描 .git/CONFLICTS 缓存（若启用）或直接解析 index 和工作树差异，输出类似：“conflict/file.py（行 42–45）、src/utils.js（行 108）、README.md（行 1–3）”。
4、继续发送：“展示 file.py 的冲突块及推荐保留哪一方修改”，QClaw 将高亮显示双方变更并标注语义相似度得分。
将普通的 GitHub README 页面、技能落地页或 Markdown 引言，转化为封面式英雄布局（hero layout），包含居中标题、以引语开篇、风格克制……
三、配置自动化分支保护策略联动
QClaw 支持将 GitHub 仓库的 branch protection rules 同步至本地策略引擎，在执行 push 或 create PR 前主动校验是否符合保护条件（如 require pull request reviews、require status checks），避免因规则不符被远程拒绝。
1、进入 QClaw 设置页 → 「Git 集成」→ 「分支保护同步」，点击「启用并刷新规则」。
2、QClaw 自动调用 GitHub API 获取 /repos/{owner}/{repo}/branches/{branch}/protection 返回值。
3、当用户尝试向 protected 分支直接 push 时，QClaw 拦截操作并提示：“main 分支启用了审查强制策略，请先创建 Pull Request”。
4、用户可立即追加指令：“为当前提交创建 PR 到 main，标题为 feat: login UI update，描述包含变更摘要”，QClaw 自动生成 PR 并返回链接。
四、使用 Junction 符号链接实现跨平台 Skill 版本隔离
针对多 Agent（如 QClaw / WorkBuddy）共用同一套 Git 管理的 Skill 目录时可能出现的分支错乱问题，QClaw 支持 Windows 原生 Junction 方式映射 skill-git-manager 目录，使不同 Agent 实际操作同一份 Git 仓库但互不干扰工作区状态。
1、在命令行中以管理员身份运行：mklink /J C:\QClaw\skills D:\My Skills\skill-git-manager。
2、启动 QClaw 后，在设置中指定技能根目录为 C:\QClaw\skills。
3、执行 git status 时，QClaw 实际读取的是 D:\My Skills\skill-git-manager 下的 .git 数据，而其他 Agent 若指向相同物理路径，即可共享分支历史与标签。
4、切换分支操作（如 git checkout dev）将实时反映在所有绑定该 Junction 的 Agent 中，消除因目录复制导致的 commit ID 不一致问题。
