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

2026-08-31 17:34:27 +08:00
parent e82eb4e857
commit 9c1fb956e4
13 changed files with 249 additions and 25 deletions
@@ -7,6 +7,8 @@
 - 当前工作区和目标 worktree 路径没有未处理状态或归属冲突。
 - 环境配置风险已按项目规范处理；凭据风险为零。

+创建、复用或关闭独立 worktree 时，同时读取 [Worktree 生命周期](worktree-lifecycle.md)。
+
 ## 隔离创建

 根据项目规范决定预集成分支基于源还是目标。没有规范时说明两种历史形状，由用户选择，不能默认套用固定组织模型。
@@ -32,4 +34,6 @@ git status --short --branch

 确认源、目标引用仍等于操作前哈希；只有预集成分支发生变化。记录 merge 提交、测试结果和未验证边界。

-保留 worktree 供用户复核。清理 worktree、删除分支或中止 merge 都是独立操作，不属于自动收尾。
+必须以目标引用为基准检查 `git diff --check "<target>...HEAD"`、`git diff --stat "<target>...HEAD"`、`git diff --name-status "<target>...HEAD"` 和 `git log --oneline "<target>..HEAD"`。最终文件清单包含本地配置、缓存、IDE 文件或无关需求文件时停止，不得进入交付阶段。
+
+需要人工复核时暂时保留 worktree 并标记为 `delivery-ready`。用户确认仅本地交付，或完成已授权的发布后，生命周期进入 `cleanup-ready`，必须继续执行清理门禁。中止 merge 和删除分支不属于自动收尾。