diff --git a/AGENTS.md b/AGENTS.md index baa8eed6..5889da65 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,6 +40,7 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台;本文 - P0: 固定主 repo 通常只作为 source truth 预检、fetch、status 和 worktree anchor;源码、配置、issue closeout、部署脚本、验收产物和高风险 dad-dev / post-task 工作,执行前必须从最新 remote/base 创建独立 `.worktree/` 并在其中完成修改、验证、提交和 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 最高优先级:可见性先修