docs: require latest tools after merge

2026-06-22 07:36:09 +00:00
parent 7293d65d34
commit bdbe9a9e4f
1 changed files with 1 additions and 0 deletions
@@ -40,6 +40,7 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文
 - P0: 固定主 repo 通常只作为 source truth 预检、fetch、status 和 worktree anchor；源码、配置、issue closeout、部署脚本、验收产物和高风险 dad-dev / post-task 工作，执行前必须从最新 remote/base 创建独立 `.worktree/<task>` 并在其中完成修改、验证、提交和 push。
 - P0: 单纯文档、AGENTS.md、`docs/reference/*.md`、skill 规则、runbook 和其他长期参考收敛不需要新建 `.worktree`；在当前主 worktree 快进到最新 remote 后直接修改、验证、提交和 push，避免给轻量文档治理制造额外 PR/worktree 摩擦。
 - P0: 固定主 repo 中已有并行未提交修改时，默认保持不动，不纳入当前任务，也不得 stash、reset、checkout 或删除；源码/配置/部署类当前任务通过独立 `.worktree` 隔离，文档类直接修改只提交当前文档相关文件。
+- P0: UniDesk 工具链自身修复必须先合并到 `master`，再把实际执行 `bun scripts/cli.ts`、`trans`、`tran`、web-probe、OTel 或 CI/CD 命令的 checkout 更新到包含该 merge 的最新 `master` 后继续使用；若当前 checkout 因并行脏改或非 `master` 分支不能安全 fast-forward，禁止 reset/stash/checkout 清理，改用干净 `origin/master` worktree 运行工具并明确说明原因。
 - P0: P1 只读探测、运行面临时热补、文档/skill/长期参考轻量修改，或目标项目长期参考明确声明的直接修改例外，允许不创建新 `.worktree`。长期细则见 `docs/reference/devops-hygiene.md`。

 ## P0 最高优先级：可见性先修