From 5dae674d25e328e6c2ffb40220bc18ff5fbe34bf Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Fri, 2 Oct 2026 16:37:23 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B5=8B=E8=AF=95=E6=89=A7=E8=A1=8C=E4=B8=A4?= =?UTF-8?q?=E5=85=A5=E5=8F=A3=E9=93=81=E8=A7=84=E8=90=BD=E6=96=87:=20CLAUD?= =?UTF-8?q?E.md=20=E7=A1=AC=E6=80=A7=E7=BA=A2=E7=BA=BF=E6=96=B0=E5=A2=9E?= =?UTF-8?q?=E5=85=A8=E6=AE=B5=E8=87=AA=E5=8C=85=E5=90=AB=E6=9D=A1=E6=AC=BE?= =?UTF-8?q?=EF=BC=88=E6=B5=8B=E8=AF=95=E7=B1=BB=E6=89=A7=E8=A1=8C=E3=80=94?= =?UTF-8?q?=E5=86=92=E7=83=9F/=E5=8D=95=E5=85=83run=5Fall/=E6=A8=A1?= =?UTF-8?q?=E6=8B=9FMC=C2=B7verifier=C2=B7=E8=B0=83=E5=8F=82=E5=B7=A5?= =?UTF-8?q?=E5=85=B7/=E5=9C=BA=E6=99=AF=E6=8E=A2=E9=92=88=E3=80=95?= =?UTF-8?q?=E5=8F=AA=E8=AE=B8=E4=B8=A4=E8=A7=A6=E5=8F=91=E5=85=A5=E5=8F=A3?= =?UTF-8?q?=3D=E2=91=A0=E8=BF=AD=E4=BB=A3loop=E5=BC=80=E5=8F=91=E3=80=94?= =?UTF-8?q?=E5=86=92=E7=83=9F=E6=8C=82=E5=BC=80=E5=8F=91=E5=AE=8C=E6=88=90?= =?UTF-8?q?=E5=90=8E=E5=87=BA=E5=8F=A3/=E8=90=BD=E7=B1=8D=E9=97=B8?= =?UTF-8?q?=EF=BC=8Cloop=E5=86=85=E8=BF=87=E7=A8=8B=E6=80=A7=E9=AA=8C?= =?UTF-8?q?=E8=AF=81=E5=B1=9E=E5=BC=80=E5=8F=91=E5=B7=A5=E4=BD=9C=E3=80=95?= =?UTF-8?q?=E2=91=A1=E7=94=A8=E6=88=B7=E4=B8=BB=E5=8A=A8=E7=82=B9=E5=90=8D?= =?UTF-8?q?=EF=BC=9B=E5=85=B6=E4=BD=99=E7=9F=AD=E5=B0=8F=E4=BC=9A=E8=AF=9D?= =?UTF-8?q?=E4=B8=80=E5=BE=8B=E9=9B=B6=E6=B5=8B=E8=AF=95+=E5=85=88?= =?UTF-8?q?=E8=AF=B7=E7=A4=BA=E5=8F=A3=E5=BE=84=EF=BC=89+worktree=E9=93=81?= =?UTF-8?q?=E5=BE=8B=E6=94=B6=E5=B0=BE=E9=97=B8=E6=8E=AA=E8=BE=9E=E9=99=90?= =?UTF-8?q?=E5=AE=9A=E8=BF=AD=E4=BB=A3loop=E6=89=B9=E6=AC=A1=EF=BC=88?= =?UTF-8?q?=E9=9D=9Eloop=E6=89=B9=E9=BB=98=E8=AE=A4=E4=B8=8D=E8=B7=91?= =?UTF-8?q?=E9=97=B8=E3=80=81=E7=82=B9=E5=90=8D=E6=88=96=E5=BD=93=E5=9C=BA?= =?UTF-8?q?=E9=97=AE=EF=BC=89=E2=80=94=E2=80=94=E6=89=BF=E6=8E=A5=E5=8F=B0?= =?UTF-8?q?=E8=B4=A6313=E7=94=A8=E6=88=B7=E6=89=B9=E3=80=8C=E8=A6=81?= =?UTF-8?q?=E7=9A=84=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 6c9b3df5..733d9140 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -60,13 +60,14 @@ 主工作区（本目录，`master` 检出）只作**合并落点与共享状态载体**，一切开发/设计改动不得直接发生在主工作区： 1. **开工**：每个任务批次先建独立 worktree 分支再动手：`git worktree add ../g-plan2-<任务名> -b <任务分支>`。所有代码/文档/数值改动与验证跑测都在 worktree 内进行（注意：未跟踪文件不会出现在新 worktree，需手工搬运） -2. **收尾**：验证全绿（冒烟 + 场景探针）后，在主工作区 `git merge --no-ff <任务分支>` 落回 master，然后 `git worktree remove` + 删分支；合并前先看 active.md 尾部台账，避免与并行会话撞号/漏捎带 +2. **收尾**：迭代 loop 批次在验证全绿（冒烟 + 场景探针；冒烟挂迭代开发完成后的出口/落籍闸）后，在主工作区 `git merge --no-ff <任务分支>` 落回 master，然后 `git worktree remove` + 删分支；合并前先看 active.md 尾部台账，避免与并行会话撞号/漏捎带。非 loop 批次收口跑闸与否按「测试执行两入口铁规」（见硬性红线）：默认不跑，用户点名或当场问 3. **豁免面（仅这两处允许主工作区直改）**：根目录 `active.md`（会话收口）与 `.zcode/`（钩子配置）——其余一律走 worktree；主工作区 `git commit` 会被钩子直接拦截 4. 本铁律由 PreToolUse 钩子 `.zcode/hooks/worktree-guard.sh` 强制兜底；钩子只约束 agent 侧，用户本人手工改动不受限 ## 硬性红线（勿违反） - **worktree 铁律**：主工作区禁止直接改动与提交（细则见上节；并行会话各占 worktree 互不踩踏） +- **测试执行两入口铁规（2026-10-02 用户立规）**：测试类执行——冒烟测试、单元测试（tests/run_all）、模拟验证（MC/verifier/调参批量工具）、场景探针等一切跑游戏的验证调用——只有两个触发入口：①**迭代 loop 开发**（冒烟挂迭代开发完成后的出口/落籍闸，loop 内过程性验证属开发工作本身）；②**用户主动点名**。除此之外（问答/调研/文档/审查/零散小改等短小会话）一律零测试，不得擅自调用任何测试；确需测试支撑结论时先请示，以静态阅读/推理作答并注明未跑测 - **中间产物吸收即死（2026-10-01 立规）**：中间文档（批任务书/机检报告/调研审计报告/模拟读数/迭代计划书/目检清单）寿命=迭代寿命——结论先吸收进正主文档、未决项先迁 `design/gdd/06-待办清单.md` 或 roadmap，然后文件即删，且永不提交 git；活文档=唯一事实源，git=变更记录。细则见 `design/dev/doc-conventions.md` 第 11 节 - **数值单一事实源**：玩法数值只存 `data/tables/`（.tres），经 `ConfigDB` autoload 类型化单点读取；禁止数值字面量与自建 `load()` 表路径