Rebase 影响分析
分析分叉分支 rebase 的后果,在执行 rebase 前生成结构化分析报告。
直接操作(无需 Sub-Agent)
这些简单操作立即执行:
| 操作 | 命令 | 何时直接使用 |
|---|---|---|
| 查看分叉状态 | git rev-list --count --left-right <local>...<target> |
用户只想看 ahead/behind 数 |
| 查看分支列表 | git branch -vv |
用户只想查看分支信息 |
| 快进合并 | git rebase <target> |
ahead=0,只有 behind(非分叉) |
Sub-Agent 委托
code-rebase-analyzer
用于: 分叉分支的完整 rebase 影响分析
何时委托:
- 分支同时 ahead > 0 且 behind > 0(分叉状态)
- 用户要求"分析 rebase 风险"或"rebase 前检查"
- 需要冲突预测、功能影响评估、兼容性检查
参数:
{
"local_branch": "当前分支(自动检测)",
"target_branch": "目标分支(默认 main)"
}
决策树
用户请求:
├─ "查看分支状态" / "ahead behind"
│ └─ 直接使用 git rev-list --count --left-right
│
├─ 只有 behind(ahead=0)
│ └─ 直接快进:git rebase <target>
│
├─ "分析 rebase" / "rebase 风险" / "rebase 影响"
│ └─ 先确认分叉状态
│ ├─ 非分叉 → 提示无需分析
│ └─ 分叉 → 委托给 code-rebase-analyzer
│
└─ "rebase 前检查" / "冲突预测"
└─ 委托给 code-rebase-analyzer(完整 6 阶段分析)
并行执行
多分支分析
用户: "分析 feature-a 和 feature-b 分支的 rebase 风险"
→ 并行启动:
Agent 1: code-rebase-analyzer(feature-a → main)
Agent 2: code-rebase-analyzer(feature-b → main)
→ 汇总对比展示
工作流
步骤 1: 确认分叉状态
git branch --show-current
git rev-list --count --left-right HEAD...<target>
步骤 2: 判断是否需要分析
- ahead > 0 且 behind > 0 → 需要分析
- 其他情况 → 直接操作或提示
步骤 3: 启动分析 Agent
Task({
subagent_type: "general-purpose",
description: "分析 rebase 影响",
prompt: `你是 code-rebase-analyzer。分析当前分支 rebase 到 ${target} 的影响,包括分叉拓扑、冲突预测、功能影响、兼容性评估和安全执行策略。`
})
步骤 4: 展示分析报告
错误处理
- 非分叉状态: 提示用户可以直接操作,无需分析
- 工作区不干净: 提示先
git stash或git commit - 目标分支不存在: 列出可用分支供选择
Converted and distributed by TomeVault — claim your Tome and manage your conversions.