chore: record main worktree sync merge

This commit is contained in:
Codex
2026-06-29 14:11:20 +00:00
parent 49918d1802
commit 10c5daf618
2 changed files with 7 additions and 1 deletions
+5 -1
View File
@@ -2,6 +2,10 @@
UniDesk 是一个以主 server 为统一入口的分布式工作平台。本文件只做自动加载的顶级索引;长期规则、详细流程和判定标准必须放到 skill 或 `docs/reference/*.md`
## P0: 主 worktree 同步提交第一原则
- P0: 主 worktree 同时存在脏改且落后 `origin/master` 时,必须先 `git stash push -u` 保存当前脏改(包含 untracked),再 `git pull --ff-only origin master` 快进到最新 `master`,然后 `git stash apply` 并按语义合并,确认 diff 后 `git commit``git push origin master`;禁止用 reset、drop 或覆盖式 checkout 丢弃并行改动。
## P0: backend-core 运行面冻结
- P0: backend-core 运行面恢复 healthy 后,除非用户明确要求,不得再触碰 backend-core 运行面;禁止主动执行 `server rebuild backend-core``server restart backend-core`、手工重建/重启/替换 `unidesk-backend-core` 容器或等价生产变更。
@@ -16,7 +20,7 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台。本文
- P0: 本机可能有多个并行开发任务;发现未预期本地修改时默认保留,不得自动 `git reset``git checkout --`、删除或回滚他人修改。
- P0: 当前目录的主工作区(非 `.worktree/` 路径)必须固定停留在 `master` 分支;禁止把主工作区切到其他分支,非 `master` 开发必须使用独立 `.worktree/<task>`
- P0: 主 worktree 同时存在脏改且落后 `origin/master` 时,先用 stash 保存当前脏改(包含 untracked),再 `pull --ff-only` 快进到最新 `master`,然后 apply stash 并按语义合并;禁止用 reset/drop/checkout 覆盖并行改动
- P0: 主 worktree 同步冲突处理以文件开头的“主 worktree 同步提交第一原则”为最高入口;语义合并时保留并行改动的有效意图,不回滚到旧运行面或旧配置路径
- P0: 固定主 repo 通常只做 source-truth 预检、fetch、status 和 worktree anchor;源码、配置、部署脚本、issue closeout 和高风险 dad-dev 工作必须使用独立 `.worktree/<task>`。文档/skill/长期参考轻量修改可直接在当前主 worktree 处理。细则见 `docs/reference/devops-hygiene.md`
- P0: 清理任务 worktree 前必须按语义确认已合入 `master`:工作区 clean,相关提交是 `origin/master` 祖先或被 `--cherry-pick` 判定为等价吸收,必要时检查关键文件 diff/PR merge commit;不得仅因分支落后就删除。仍有未合入语义、未提交文件或不确定归属时,先合并/提交/推送到 `master` 或记录阻塞,不清理 worktree。
- P0: UniDesk 工具链自身修复必须先合并到 `master`,再把实际执行工具命令的 checkout 更新到包含该 merge 的最新 `master` 后继续使用;若当前 checkout 有并行脏改或非 master 分支导致不能安全 fast-forward,禁止 reset/stash/checkout 清理,改用干净 `origin/master` worktree 运行工具并说明原因。