yg-team-cli 2.7.1 → 2.8.0

package/README.md

@@ -16,6 +16,7 @@
 | `split-prd` | 将 PRD 文档拆分为多个功能规格 |
 | `breakdown` | 将 spec 拆分为 milestones 和 todos |
 | `dev` | 选择并执行开发任务 |
+| `dev:wt` | Worktree Orchestrator - 多角色并行开发 |
 | `add-feature` | 添加新功能 |
 | `bugfix` | 创建 Bugfix 记录 |
 | `hotfix` | 紧急修复 |
@@ -782,6 +783,145 @@ team-cli dev
 - 更新 spec 文件
 - 下次运行 `team-cli dev` 时会显示为已完成
 
+### 17. Worktree Orchestrator - 多角色并行开发
+
+利用 Git Worktree 实现多角色并行开发的编排工具：
+
+```bash
+# 启动编排器
+team-cli dev:wt
+
+# 创建新的并行开发会话
+team-cli dev:wt --new --ticket USER-123 --goal "用户登录功能"
+
+# 列出所有 worktree
+team-cli dev:wt --list
+
+# 查看会话状态
+team-cli dev:wt --status
+
+# 运行指定阶段
+team-cli dev:wt --run-phase 1 --ticket USER-123
+
+# 验证交接物
+team-cli dev:wt --verify --ticket USER-123
+```
+
+**架构设计：**
+
+```
+project/
+├── ../wt/                    # Worktree 根目录（与项目同级）
+│   └── USER-123/             # TICKET 目录
+│       ├── planner/          # Planner worktree
+│       ├── architect/        # Architect worktree
+│       ├── backend/          # Backend worktree
+│       ├── frontend/         # Frontend worktree
+│       ├── qa/               # QA worktree
+│       └── reviewer/         # Reviewer worktree
+└── .handoff/                 # 交接物目录
+    └── USER-123/             # TICKET 交接物
+        ├── planner/          # Planner 产出物
+        ├── architect/        # Architect 产出物
+        ├── backend/          # Backend 产出物
+        ├── frontend/         # Frontend 产出物
+        ├── qa/               # QA 产出物
+        ├── reviewer/         # Reviewer 产出物
+        ├── MANIFEST.json     # 交接物清单
+        └── reports/          # 执行报告
+```
+
+**六个研发阶段：**
+
+| 阶段 | 名称 | 主要角色 | 并行策略 |
+|------|------|---------|---------|
+| 1 | 需求与 BDD 设计 | Planner | 独立工作 |
+| 2 | 架构与契约 | Architect | 独立工作 |
+| 3 | OpenAPI + Mock | Backend | 独立工作 |
+| 4 | 并行实现 | Backend + Frontend | 并行开发 |
+| 5 | BDD 验收 | QA | 独立工作 |
+| 6 | 集成与发布 | Reviewer | 独立工作 |
+
+**交互流程：**
+
+```
+═══════════════════════════════════════════════════════
+  Worktree Orchestrator
+═══════════════════════════════════════════════════════
+
+选择操作:
+  1. 📋 新建并行开发会话
+  2. 📂 列出所有 Worktree
+  3. 📊 查看会话状态
+  4. ▶️ 运行阶段
+  5. ✅ 验证交接物
+  6. 🚪 退出
+```
+
+**新建会话示例：**
+
+```
+▸ 输入 TICKET ID (例如 USER-123): USER-123
+▸ 输入任务目标: 实现用户登录功能
+▸ 选择参与角色:
+  ✓ Planner (需求与 BDD)
+  ✓ Architect (架构)
+  ✓ Backend (后端)
+  ✓ Frontend (前端)
+  ✓ QA (BDD 验收)
+  ✓ Reviewer (审查)
+
+✓ 会话创建成功!
+  Worktree 目录:
+    - ../wt/USER-123/planner
+    - ../wt/USER-123/architect
+    - ../wt/USER-123/backend
+    - ../wt/USER-123/frontend
+    - ../wt/USER-123/qa
+    - ../wt/USER-123/reviewer
+
+  交接物目录:
+    .handoff/USER-123/
+
+是否立即开始运行 Phase 1? (y/N)
+```
+
+**Gate 门禁检查：**
+
+```
+═══════════════════════════════════════════════════════
+  🚪 Gate 1 检查: 需求与 BDD 设计
+═══════════════════════════════════════════════════════
+
+✓ 前置阶段已全部完成
+
+📋 Gate 检查清单:
+  [ ] SPEC.md 包含目标/非目标/范围
+  [ ] TASKS.md 任务拆分到可独立合并
+  [ ] BDD 场景 Given/When/Then 完整
+  [ ] 验收标准与 BDD 场景一一对应
+
+────────────────────────────────────────────────────────
+是否确认通过此 Gate? (y/N):
+```
+
+**交接物清单：**
+
+| 角色 | 文件 | 类型 | 说明 |
+|------|------|------|------|
+| Planner | SPEC.md | spec | 功能规格文档 |
+| Planner | TASKS.md | tasks | 任务拆分 |
+| Planner | BDD_FEATURES/*.feature | feature | BDD 场景 |
+| Architect | ADR.md | adr | 架构决策记录 |
+| Architect | API_RULES.md | api | API 设计规则 |
+| Backend | API_OPENAPI.yaml | openapi | OpenAPI 规范 |
+| Backend | API_EXAMPLES.md | api | API 示例 |
+| Backend | TESTING_*.md | testing | 测试报告 |
+| QA | BDD_REPORT.md | report | BDD 验收报告 |
+| Reviewer | REVIEW.md | review | 审查报告 |
+| Reviewer | RELEASE.md | release | 发布方案 |
+| Reviewer | ROLLBACK.md | rollback | 回滚方案 |
+
 ---
 
 ## 环境变量配置