用途：该技能用于 Apidog CLI 的分支协作场景，补充最容易被误用的规则，包括分支上下文、AI 分支、pick-to、写入权限、受保护分支与合并确认。使用前置条件是先阅读 ../apidog-cli/SKILL.md；若稳定入口技能与本领域技能冲突，以当前 CLI 帮助和本技能为准。精确参数始终以当前 CLI 帮助为准。
主要能力：管理分支（创建、查看、更新、归档、删除）、创建 AI 分支并从源分支修改资源、用 pick-to 导入源分支资源到 AI 分支、合并分支、创建或审批合并请求，以及处理 AI 写入权限限制。资源命令通常支持 --branch <branchName>，查询、创建、更新和测试运行需保持同一分支上下文。
使用方式：分支管理入口为 apidog branch --help，合并请求入口为 apidog merge-request --help。写分支前先确认策略：直接编辑目标分支，或通过 AI 分支编辑（适合 AI 生成的 API、测试用例、测试场景或配置变更，也适合目标分支受保护或外部 AI 直接写入被禁用的情形）。写入前确认项目 ID、源分支与目标分支、需修改的资源范围、是否允许后续创建合并请求或合并。
AI 分支流程：确认源分支与目标变更 -> 创建 AI 分支（用 --from <sourceBranchName>）-> pick-to 已有资源 -> 在 AI 分支修改 -> 用 get/run/report 验证 -> 预览 merge-request -> 用户确认后创建合并请求或合并。AI 分支初始为空，不会自动复制源分支全部资源；branch get 可能返回 type: SPRINT 且 isAiBranch: true，但 AI 分支操作仍应按当前帮助在需要时使用 --type ai。
限制与规则：pick-to 必须传 --type ai，只能从主分支或普通 Sprint 分支导入到 AI 分支，不能导入主分支，不能以 AI 分支为源；可用 --include-endpoint-cases 连带导入接口用例。主分支、Sprint 分支和普通分支可能需要开启外部 AI 编辑权限，典型错误为 Automation caller branch required；创建 AI 分支成功但写入仍可能因 AI 分支的 AI 编辑被禁用而失败。写入受限时不要自动切换策略，应询问用户。不得在未确认时创建 AI 分支、未 pick-to 就修改已有源分支资源、省略 --branch、未经确认合并或创建/审批合并请求、擅自删除或归档分支。
排查要点：无分支参数找不到资源时改用 --branch <branchName> 重试；AI 分支缺源资源先用 branch pick-to；分支有计数但 AI 分支页面为空时不要假定已导入，仍需 pick-to；分支运行配置 404 时确认用例、接口、环境、分支均存在再切到 apidog-cli-checkup；受保护分支阻止合并时改用 merge-request。