# Worktree Rebase Merge > 将当前 worktree 的任务提交 rebase 到本地目标分支，并从目标 worktree 合并。用于明确要求本地集成；仅创建提交使用 git-commit。 - Skill: `tisfeng/worktree-rebase-merge` (Agent Skill, multi-file: 6 files) - Install (CLI): `npx skillmds@latest add tisfeng/worktree-rebase-merge` - Raw SKILL.md: https://api.skillmd.com/api/skills/tisfeng/worktree-rebase-merge/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tisfeng (https://skillmd.com/u/tisfeng) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tisfeng/worktree-rebase-merge --- # Worktree Rebase/Merge 工作流 将当前 checkout 视为源：必要时创建任务分支并提交，rebase 到目标分支， 再从目标分支的 worktree 合并。源与目标相同时只提交，不 rebase 或 merge。 ## 依赖与授权 完整交付依赖 `git-commit` 的提交、分支命名和已有提交回执能力。从当前 Skill 清单 定位实际入口，未提供位置时才检查 [同级安装位置](../git-commit/SKILL.md)。缺失时可完成 只读预检，但在首次分支、暂存、提交、rebase 或 merge 写入前停止。 本 Skill 只在用户明确要求本地集成时执行 Git 写入。仅预览或只读请求不创建分支/ worktree、不暂存、提交、rebase 或 merge。除非用户明确要求，不 fetch、pull 或 push。 ## Git 状态保护 - 开始前确认允许路径、提交范围、用户限制，以及源/目标的 HEAD、索引、工作树、 worktree 占用和进行中操作。 - Git 写操作串行执行；每次写入前复验相关状态，写入后确认结果符合预期。 - rebase 前冻结源提交范围与目标 OID；rebase 后核对改写结果。merge 前确认源干净、 目标仍为冻结 OID，且目标 worktree 没有漂移。 - 不使用 reset、强制移动 ref、stash 或 clean，不切换用户其他 checkout 的分支。 - 发现非预期漂移、未解冲突、范围不一致、不能安全处理的语义冲突或权限拒绝时， 保留现场并停止后续写入。 ## 主流程 1. 读取 [集成协议](references/integration-workflow.md)，使用其只读 helper 收集稳定的源/目标事实。 2. 用户指定目标时使用该分支；否则按集成协议实时解析远程默认分支。目标或 remote 有歧义、无法证明实时默认分支或本地目标不存在时，在写入前停止并请用户指定。 3. detached HEAD 按集成协议挂接到不覆盖现有 ref 的任务分支。没有 staged、unstaged、 untracked 或相对目标的提交时，不创建空分支。 4. 源与目标相同时，只使用 `git-commit` 完成提交和回执。 5. 其他情况先用 `git-commit` 提交获准的源变更，要求源 worktree 干净；再检查完整 `..` 提交和路径范围，执行 `git rebase ` 并验证改写结果。 6. 在干净的目标 worktree 执行 `git merge `。没有目标 worktree 时，在仓库外创建临时 worktree，成功合并后删除；冲突或失败时保留供恢复。 7. 读取 [集成回执](references/reporting.md)，报告真实分支、OID、worktree、rebase/merge、工作树和 Push 状态；单提交或多提交统计复用 `git-commit` 的回执契约。 ## 完成与停止条件 直接提交模式在 `git-commit` 完成时结束。普通集成只有在源已成功 rebase、目标从冻结 OID 按预期合并、源与目标最终状态已验证且回执完整时才算完成。目标只有脏 worktree 时，允许先完成源提交，然后在 rebase/merge 前暂停；恢复步骤见集成协议。