diff --git a/AGENTS.md b/AGENTS.md index 535d7496..a38a45b0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -129,6 +129,7 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥 ## 常用轻量命令 - 静态合同校验:`npm run validate` +- Cloud Web worktree 依赖准备:`npm run worktree:deps`;新 `.worktree/` 内需要 Web 检查时先复用固定 workspace 的共享依赖,`web:check` 和 `web:build` 会自动调用。 - Cloud Web 静态检查:`npm run web:check` - Cloud Web 构建:`npm run web:build` - Cloud Web M3 只读护栏:`npm run web:m3-readonly` diff --git a/docs/reference/commander-collaboration.md b/docs/reference/commander-collaboration.md index f57e40b1..0a405ae4 100644 --- a/docs/reference/commander-collaboration.md +++ b/docs/reference/commander-collaboration.md @@ -28,6 +28,7 @@ - G14 DEV/PROD、G14 v0.2 和其他 node/lane 的固定 workspace 只在任务明确选择对应 node/lane 时使用;不得把 `/root/hwlab`、`/root/hwlab-v02` 或旧 `hwlab-dev`/`hwlab-prod` 运行面写成所有 HWLAB 任务默认 scratch 区。 - CI/CD source commit 选择必须使用当前 node/lane 的受控 source repo 或 control-plane 自动 fetch 后的 commit-pinned detached worktree,不能因为人工开发 workspace dirty、stale 或存在 `.worktree/` 就阻塞或改变发布。 - 固定 repo 是 source truth 和 worktree 管理入口,不是并行任务 scratch 区;不要在固定 repo 根目录堆叠未提交改动,也不要复用其他任务遗留 `.worktree/`。 +- D601 v0.3 新 `.worktree/` 需要 Cloud Web 检查时,使用 `npm run worktree:deps` 准备共享 Web 依赖;`npm run web:check` 和 `npm run web:build` 会自动先执行该入口。该 helper 只复用固定 workspace 下 ignored 的 `.worktree/hwlab-cloud-web-deps`,不得提交 `node_modules`、dist、cache 或临时 lock 产物。 - D601 legacy 只指旧 DEV/CD、迁移对照和事故回放路径;D601 node-scoped runtime lane 不属于 legacy。 - 不要清理、reset 或复用无关 runner worktree 作为发布真相。