From 6b1cca0fe41455b87f7e2e11135c90dcfe50b965 Mon Sep 17 00:00:00 2001 From: JianFeeeee Date: Mon, 14 Sep 2026 20:05:15 +0800 Subject: [PATCH] =?UTF-8?q?docs(dev-tooling):=20=E5=8A=A0=E4=B8=80?= =?UTF-8?q?=E6=9D=A1=E6=8F=90=E4=BA=A4=E7=BA=AA=E5=BE=8B=20=E2=80=94?= =?UTF-8?q?=E2=80=94=20=E5=A4=9A=20agent=20=E5=85=B1=E7=94=A8=E5=B7=A5?= =?UTF-8?q?=E4=BD=9C=E5=8C=BA=EF=BC=8C=E6=8F=90=E4=BA=A4=E5=89=8D=E5=85=88?= =?UTF-8?q?=E7=9C=8B=20git=20status=20=E9=87=8C=E6=9C=89=E6=B2=A1=E6=9C=89?= =?UTF-8?q?=E5=88=AB=E4=BA=BA=E7=9A=84=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 这个工作区是多条会话共用的：2026-09-14 20:02~20:04 另一条会话正在改 deploy/install.sh、deploy/prune-deploy-artifacts.sh、deploy/redeploy-gateway.sh （-trimpath 那组加固），而我同时在同一个仓库里连续提交。 `git add -A` 会把别人没写完、没审过的改动一起做进我的提交，且从 git log 看不出归属。 规矩：显式列出要提交的路径；提交信息里不把别人的改动算成自己的。 （本次三次 pi-bridge 提交都是显式路径，事后用 git show --stat 核对过没有混入。） --- docs/DEV-TOOLING.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/DEV-TOOLING.md b/docs/DEV-TOOLING.md index 94d76e5..3bcaa74 100644 --- a/docs/DEV-TOOLING.md +++ b/docs/DEV-TOOLING.md @@ -171,6 +171,13 @@ bash deploy/prune-deploy-artifacts.sh --self-check # 判据自检（16 项， 实测：从测试文件取夹具，让巨行用例（单条往临时目录写 ~12 MiB）跑了**两次** （测试总数 475；修完 459）。夹具放**非测试模块**（`lib/session-fixtures.mjs`）， 判据也进套件（`env-guard.test.mjs` 里那条扫描）。 +- **提交前先看 `git status` 里有没有"不是我的"文件。** 这个工作区是**多 agent 共用的** + —— 2026-09-14 20:02~20:04 就有另一条会话在改 `deploy/install.sh`、 + `deploy/prune-deploy-artifacts.sh`、`deploy/redeploy-gateway.sh`（`-trimpath` 那组加固）， + 而当时我正在同一个仓库里连续提交。`git add -A` 会把**别人没写完、没审过的改动** + 一起做进我的提交里，而且从 `git log` 上看不出来是谁的。 + **规矩：显式列出要提交的路径，别用 `-A`/`-u` 图省事**；提交信息里也不要把 + 别人的改动算作自己的成果。（这次三次提交都是显式路径，事后 `git show --stat` 核对过。） - **写点要"一处覆盖全部"，且覆盖范围不取决于入口。** 同一条"ENOSPC 被翻译成环境问题" 在这套代码里被漏过**三次**，而且是**三个不同的入口假设**（不是同一处错了三次）： ① `test/lib/session-fixtures.mjs` 的 `writeSession`（第一版只包 `writeFileSync`，