yg-team-cli 2.8.0 → 2.8.1

package/README.md

@@ -16,7 +16,6 @@
 | `split-prd` | 将 PRD 文档拆分为多个功能规格 |
 | `breakdown` | 将 spec 拆分为 milestones 和 todos |
 | `dev` | 选择并执行开发任务 |
-| `dev:wt` | Worktree Orchestrator - 多角色并行开发 |
 | `add-feature` | 添加新功能 |
 | `bugfix` | 创建 Bugfix 记录 |
 | `hotfix` | 紧急修复 |
@@ -26,6 +25,10 @@
 | `status` | 查看项目状态 |
 | `lint` | 前后端代码质量检查 |
 | `logs` | 查看 AI 开发会话历史 |
+| `fe-start` | 创建前端工作分支 (从 master 切出) |
+| `fe-dev` | 合入 develop 分支提测 |
+| `fe-release` | 创建 release 分支并自动 bump 版本号 |
+| `fe-sync` | 同步 master 最新代码到当前分支 |
 
 ---
 
@@ -33,6 +36,19 @@
 
 以下记录了 team-cli 的开发进展，按时间倒序排列。
 
+### 2026-03-25 - 前端 Git 工作流命令
+
+**v2.7.0** - 新增前端 Git 工作流自动化命令
+
+- **新增**: `fe-start` 命令 — 从 master 创建前端工作分支，支持 feat/fix/hotfix/refactor 四种类型，交互式选择或 `--type` 指定
+- **新增**: `fe-dev` 命令 — 一键将当前分支合入 develop 提测，自动 checkout → pull → merge → push → 切回
+- **新增**: `fe-release` 命令 — 从 master 创建 release 分支，支持自动 SemVer 版本号递增（patch/minor/major），自动更新 package.json 并提交
+- **新增**: `fe-sync` 命令 — 同步 master 最新代码到当前工作分支（fetch + merge）
+- **新增**: `fe-git.ts` 共享工具层 — 前置检查（Git 仓库、工作区洁净、分支合法性）、安全扫描（构建产物/环境变量/node_modules/秘钥证书/敏感配置）、不稳定依赖检查、版本号操作
+- **安全**: 所有 push 操作前自动扫描分支差异，拦截 dist/build/.env/node_modules/秘钥等危险文件
+- **安全**: release 时自动检查不稳定依赖（-alpha/-beta/-dev/-rc/-canary/-next），询问确认
+- **测试**: 38 个单元测试覆盖所有命令的正常流程、异常处理、冲突回滚
+
 ### 2026-02-03 - PRD → Spec 工作流重构
 
 **v2.5.0** - 新增 PRD → Spec 两阶段工作流
@@ -783,145 +799,6 @@ 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 | 回滚方案 |
-
 ---
 
 ## 环境变量配置