feat(git): 完善 Worktree 生命周期与发布约定

2026-08-31 17:34:27 +08:00
parent e82eb4e857
commit 9c1fb956e4
13 changed files with 249 additions and 25 deletions
@@ -1,6 +1,6 @@
 ---
 name: integrate
-description: 评估两个 Git 分支的集成风险，并在用户逐步确认后通过隔离 worktree 准备、验证和发布预集成分支。适用于合并前验证或准备 MR/PR；直接修改目标分支、一键推送或未经审查处理冲突不应触发本 Skill。
+description: 评估两个 Git 分支的集成风险，并在用户逐步确认后通过隔离 worktree 准备、验证、发布和清理预集成分支。适用于合并前验证、准备 MR/PR 或关闭预集成 worktree；直接修改目标分支、一键推送或未经审查处理冲突不应触发本 Skill。
 ---

 # Git 分支集成
@@ -12,6 +12,7 @@ description: 评估两个 Git 分支的集成风险，并在用户逐步确认
 - `assess`：只读比较分支、预判冲突和识别交付风险。执行时读取 [评估规则](references/assess.md)。
 - `prepare`：在独立 worktree 中创建预集成分支、执行 merge 并验证。执行时读取 [准备规则](references/prepare.md)。
 - `publish`：推送预集成分支并准备 MR/PR。执行时读取 [发布规则](references/publish.md)。
+- `cleanup`：本地交付或发布完成后关闭独立 worktree。执行时读取 [Worktree 生命周期](references/worktree-lifecycle.md)。

 用户要求“集成”但未明确阶段时，从 `assess` 开始。前一阶段的授权不能自动扩展到后一阶段。

@@ -22,7 +23,9 @@ description: 评估两个 Git 分支的集成风险，并在用户逐步确认
 - fetch、worktree 创建、分支创建、merge、冲突暂存、commit、push 和创建 MR/PR 分别展示准确命令并取得对应确认。
 - 工作区不干净、引用不可解析、已有 worktree 冲突或分支归属不清时停止写操作。
 - 不自动使用 `ours`、`theirs`、rebase、reset、stash、强制推送或历史改写。
- 不直接把预集成分支合入目标分支，也不自动删除 worktree 或分支。
+- 不直接把预集成分支合入目标分支，也不删除预集成分支。
+- Worktree 生命周期结束后必须进入 `cleanup` 门禁；未确认准确路径、状态、HEAD 和分支引用前不得移除，也不得使用 `--force`。
+- 预集成是否合格以目标分支到预集成分支的真实差异为准，不能只凭 merge 输出、分支名、提交数量或测试通过判断。

 ## 环境和本地配置

@@ -36,6 +39,7 @@ description: 评估两个 Git 分支的集成风险，并在用户逐步确认

 - 只读集成评估报告；
 - 本地隔离且已验证的预集成分支；
- 经独立授权推送的预集成分支及 MR/PR 建议。
+- 经独立授权推送的预集成分支及 MR/PR 建议；
+- 生命周期已经结束并安全移除额外 worktree，同时保留预集成分支和提交。

 报告源、目标、预集成分支和对应哈希，列出冲突处理、验证结果、环境配置判断及仍需人工完成的动作。