branch-managerlisted
Install: claude install-skill 10CG/aria-plugin
# 分支管理器 (Branch Manager)
> **版本**: 2.0.0 | **十步循环**: B.1, C.2
> **更新**: 2026-01-20 - 自动模式决策 (单一入口架构)
## 快速开始
### 我应该使用这个 skill 吗?
**使用场景**:
- B.1: 开始新任务,需要创建功能分支
- C.2: 完成开发,需要推送并创建 PR
**不使用场景**:
- 简单的 commit 操作 → 使用 `commit-msg-generator`
- 跨模块批量提交 → 使用 `strategic-commit-orchestrator`
---
## 核心功能
| 功能 | 十步循环 | 描述 |
|------|---------|------|
| **自动模式决策** | B.1 | 根据任务复杂度智能选择 Branch/Worktree |
| 创建分支 | B.1 | 验证环境 + 创建规范分支 + 推送远程 |
| 创建 PR | C.2 | 推送分支 + 创建 Forgejo PR + 等待审批 |
---
## 自动模式决策 (Auto Mode Decision)
> **新增于 v2.0.0** - 单一入口架构
branch-manager 现在支持**自动模式决策**,根据任务复杂度智能选择:
- **模式 A (Branch)**: 常规分支创建流程,适用于简单修改
- **模式 B (Worktree)**: 隔离工作目录,适用于复杂功能开发
### 模式选择算法
系统根据 5 个维度评分,**总分 >= 3 分时自动选��� Worktree 模式**:
| 评分因素 | 权重 | 评分规则 | 分数 |
|---------|------|---------|------|
| `file_count` | 低 | 1-3 个文件 | 0 |
| | | 4-10 个文件 | +1 |
| | | 10+ 个文件 | +3 |
| `cross_directory` | 中 | 不跨目录 | 0 |
| | | 跨目录 | +2 |
| `task_count` | 低 | 1-3 个任务 | 0 |
| | | 4-8 个任务 | +1 |
| | | 8+ 个任务 | +3 |
| `risk_level` | 中 | 低 (typo, config) | 0 |
| | | 中 (小功能) | +1 |
| | | 高 (重构, API 变更) | +3 |
| `parallel_needed` | 高 | 不需要并行 | 0 |
| | | 需要并行开发 | +5 |
**决策阈值**: `score >= 3` → Worktree, `score < 3` → Branch
### 模式选择示例
```yaml
# 示例 1: 简单 bugfix → Branch 模式
输入:
files: ["lib/utils.py"]
task_count: 1
risk_level: low
评分: 0 + 0 + 0 + 0 + 0 = 0
结果: Branch 模式 (简单快速)
# 示例 2: 中等功能 → Branch 模式
输入:
files: 3 个 backend 文