开发与工程 ✓ Microsoft · 官方 git-mergebranch-managementmerge-conflict-resolutiongit-worktreecommit-workflow

分支变更合并助手

将当前会话的主题分支安全合并回基础分支。

FollowSkills 评估 · FSRS-2.0
不推荐
49/ 100 五分制 2.5 / 5
信任安全14 / 25 · 2.8/5

技能明确禁止未经批准的强制推送、跳过 hooks、改写或丢弃提交,并在冲突不确定时要求询问用户;但会直接提交当前工作树未提交变更并在主工作树执行 merge,缺少一般性的执行前确认、数据/路径影响说明和成功后的回滚方案,因此扣分。MIT、Microsoft 归属和仓库来源可追溯,但仅提供治理证据,不能补足操作授权缺口。

可靠稳定8 / 20 · 2.0/5

工作流给出了状态检查、合并、冲突列举、暂存、提交和结果验证等关键路径,失败时对冲突有一定反馈;但依赖未提供的 /commit 技能,未说明分支、工作树路径或命令失败时的处理,也没有覆盖异常状态的测试证据。静态评估且无执行复现,按上限保守扣分。

适用触发10 / 15 · 3.3/5

名称、触发描述和目标场景清晰,适用于把当前 session 的 topic branch 合并回 base branch;但依赖提示中的上下文块、当前 worktree 与 main worktree 结构,未明确非适用场景、权限前提或语义触发边界。它是本地 Git 操作,不依赖海外在线服务,中文用户可通过命令使用,但文档没有中文说明。

规范维护7 / 15 · 2.3/5

结构简洁,包含目标、准则、工作流和验证步骤,并明确若干限制;仓库 README、LICENSE、package.json 提供了 MIT、Microsoft 归属、版本和仓库来源。但技能本身没有安装/依赖说明、示例、FAQ、已知限制、变更记录或维护责任/更新路径,因此扣分。

有效结果6 / 15 · 2.0/5

核心目标和命令序列足够支持一次常规合并,并包含合并后清洁状态和祖先关系验证;但自动提交未提交变更、对提交技能的依赖、异常处理不完整,且没有输出格式或结果报告要求。静态读取无法验证实际可用性,按 effectiveness 不超过 7 的限制评分。

证据核验4 / 10 · 2.0/5

技能中的命令、分支关系和验证条件具有审计性,仓库文件也能核对许可证和基本治理信息;但没有该技能专属测试、CI 覆盖或第三方执行结果,提供的 CI 证据与 merge 技能关键路径无关。静态评估下只能给有限分数。

证据充分度: 评估于 2026年7月20日 审查版本 5b3e1be7be9e
使用前请注意
  • 执行前应明确确认将提交当前工作树的未提交变更,并确认目标主工作树、源分支和目标分支。
  • /commit 技能未随本材料提供,依赖其行为和可用性;应补充缺失依赖时的可诊断失败信息。
  • 成功合并后的回滚步骤、非冲突命令失败处理以及提交内容审查流程未定义。
查看完整评分方法 →

它能做什么 & 适用场景

该技能用于把当前工作树中的主题分支合并到主工作树中的合并基础分支。它会先检查未提交变更,并在需要时调用 /commit 技能提交变更。随后,它在主工作树中执行 Git 合并,并处理或报告冲突。合并完成后,它会检查主工作树是否干净,并验证主题分支是否已成为基础分支的祖先。

读取当前工作树的 Git 状态;若存在未提交变更,调用 /commit 技能;使用 git -C <main-worktree-path> merge <topic-branch> 执行合并;列出冲突文件并在解决后暂存;必要时创建合并提交;检查主工作树状态,并使用 git merge-base --is-ancestor 验证主题分支是否已合并。

  1. 开发者在隔离工作树中完成主题分支开发后,需要将成果合并回主工作树。
  2. 团队成员希望在合并前先处理当前工作树中的未提交变更。
  3. Git 合并产生冲突,需要列出冲突文件并在保留双方意图的前提下解决。
  4. 维护者需要在合并后确认主工作树干净且主题分支确实已并入。

优缺点一览

优点
  • 覆盖提交检查、分支合并、冲突处理和结果验证的完整流程。
  • 明确禁止强制推送、跳过推送钩子以及未经询问重写或丢弃提交。
  • 使用主工作树路径执行合并,适合多工作树协作。
局限
  • 依赖 Git、主工作树路径以及源分支和目标分支等上下文信息。
  • 未提供自动化测试或平台兼容性验证证据。
  • 遇到不确定的冲突解决方案时会暂停并请求用户指导。
  • 未说明技能在不同客户端中的安装和触发方法。

如何安装

源材料只说明该技能位于 microsoft/vscode 仓库的 src/vs/sessions/skills/merge/SKILL.md。未提供将该文件安装到特定客户端技能目录的步骤,因此具体安装位置和命令未有文档说明。

如何使用

在包含主题分支的当前工作树中触发该技能,并提供上下文中的源分支、目标分支和主工作树路径。例如:"将当前会话的工作合并回基础分支。" 具体触发方式未在源材料中说明。

常见问题

它会强制推送或跳过推送钩子吗?
不会。源材料明确禁止未经用户批准使用强制推送,也禁止跳过推送钩子。
当前工作树有未提交变更时会怎样?
技能会先检查状态;如果存在未提交变更,会调用 /commit 技能提交后再继续。
发生合并冲突时会自动决定怎么改吗?
它会列出冲突文件并尝试保留双方意图;如果不确定,会请求用户指导。

同仓库的其他 Skills

均来自 microsoft/vscode

开发与工程 ✓ Microsoft · 官方

工具重命名兼容性检查

防止内置工具重命名破坏现有提示词与工具配置。

开发与工程 ✓ Microsoft · 官方

Copilot Chat OpenTelemetry 埋点指南

为 Copilot Chat 统一设计和维护 OpenTelemetry 埋点。

开发与工程 ✓ Microsoft · 官方

VS Code 配置策略维护助手

规范 VS Code 企业配置策略的注册、导出与验证。

设计与前端 ✓ Microsoft · 官方

VS Code 设计哲学

用价值、原则和设计动作,把“看起来不对”转化为可执行的界面改进。

开发与工程 ✓ Microsoft · 官方

Agent 主机端到端测试助手

用严格的回放夹具维护 VS Code Agent 主机端到端测试。

开发与工程 ✓ Microsoft · 官方

VS Code 集成浏览器架构指南

帮助开发者安全理解和修改 VS Code 集成浏览器的跨进程架构。

开发与工程 ✓ Microsoft · 官方

VS Code Agents 窗口会话架构

帮助代理安全实现和修复 VS Code Agents 窗口功能。

开发与工程 ✓ Microsoft · 官方

智能提交助手

根据仓库惯例生成提交信息并安全提交代码变更。

开发与工程 ✓ Microsoft · 官方

Agent Host 日志分析

定位 Agent Host 导出日志中的会话、传输与主机问题。

开发与工程 ✓ Microsoft · 官方

VS Code 单元测试助手

在 VS Code 源码仓库中按文件、测试名称或匹配模式运行单元测试。

开发与工程 ✓ Microsoft · 官方

VS Code Agent 定制助手

帮助创建、修复和排查 VS Code Agent 定制文件及其加载问题。

开发与工程 ✓ Microsoft · 官方

Code OSS 启动与调试

为 VS Code 源码构建提供隔离启动、Playwright 自动化和多进程调试端口。

开发与工程 ✓ Microsoft · 官方

VS Code 无障碍开发助手

为 VS Code 交互式功能提供可执行的无障碍实现规范。

设计与前端 ✓ Microsoft · 官方

VS Code CSS 布局规范

用 VS Code 规范构建稳健的 CSS 布局与文本截断体验

开发与工程 ✓ Microsoft · 官方

VS Code Chat 性能实验室

基准测试聊天渲染性能,并检测会话中的内存泄漏。

开发与工程 ✓ Microsoft · 官方

组件夹具与截图测试

帮助你为 VS Code 组件创建稳定、可主题化的截图测试夹具。

开发与工程 ✓ Microsoft · 官方

VS Code 冒烟测试助手

运行、筛选并调试 VS Code 端到端冒烟测试。

开发与工程 ✓ Microsoft · 官方

VS Code 崩溃转储符号化

将原生 VS Code 崩溃转储转换为带方法名的可读回溯。

开发与工程 ✓ Microsoft · 官方

VS Code 本地 Web 工作台

在本地 vscode.dev 中验证 VS Code 工作台和 Agents 窗口改动。

开发与工程 ✓ Microsoft · 官方

反馈执行器

读取当前会话反馈并落实对应代码修改。

相关 Skills