docs: CLAUDE.md 新增「批次工作流标准清单」节——十三条链路固化(2026-10-06 用户确认 A 案:开工前三步/环境基线三步/实施两步/收口四步,每步附既往事故出处;总索引定位,与细则冲突以细则为准)
This commit is contained in:
1 parent
0bfaef765a
commit
8438d4c622
1 file changed
+25
@@ -64,6 +64,31 @@
|
||||
3. **豁免面(仅这两处允许主工作区直改)**:根目录 `active.md`(会话收口)与 `.zcode/`(钩子配置)——其余一律走 worktree;主工作区 `git commit` 会被钩子直接拦截
|
||||
4. 本铁律由 PreToolUse 钩子 `.zcode/hooks/worktree-guard.sh` 强制兜底;钩子只约束 agent 侧,用户本人手工改动不受限
|
||||
|
||||
## 批次工作流标准清单(2026-10-06 用户确认固化)
|
||||
|
||||
每个开发/设计批次按以下十三条链路执行。本清单是总索引,各步细则散见上文各节与 `design/dev/` 子文档;与任一细则冲突时以细则为准,发现清单本身过时须同批修订。
|
||||
|
||||
**开工前**
|
||||
1. **先检索后提问**——动手前先查在册记忆与正主文档,防止把已裁决事项当新问题重问,或重踩已记录的坑
|
||||
2. **任务书全列备选案**——批任务书里每个待拍板点列出全部备选方案与各自代价,交用户裁决,不在任务书内自行定夺
|
||||
3. **用户发开工令才动手**——任务书经用户批准(U0)后方开工
|
||||
|
||||
**环境与基线**
|
||||
4. **独立 worktree + 拷导入缓存**——按分支纪律建 worktree;新 worktree 先拷主区 `.godot/` 目录与字体 `.import` 边车文件再跑测试,否则每套测试全量重新导入资源、近似卡死
|
||||
5. **改码前定基线三查**——记录改动前的冒烟全绿数目、单元测试套数、现行模拟基线读数是哪份;改完用同一口径对拍,红绿才能归因到本批改动
|
||||
6. **涉数值改动先采改前读数**——批次要改游戏数值的,改码前先采「改前」模拟读数(与改后同随机种子配对比较),并写明对拍口径;无数值改动禁跑模拟(触发细则见硬性红线)
|
||||
|
||||
**实施**
|
||||
7. **新功能必配新测试**——按任务书卡片写码,新增玩法/机制必须配套新增测试套件进 `tests/run_all`;没有对应测试的变更不许合并
|
||||
8. **验收改动先行声明**——逻辑变更对应的验收变化(模拟基线换代、探针用例增改、旧断言改判)在任务书里预先写明,不事后补
|
||||
|
||||
**收口**
|
||||
9. **批末四闸全绿才合并**——冒烟 + 单元测试 + 场景探针 + 改前改后读数对拍,四项全绿方可在主工作区合并
|
||||
10. **合并后主区全量复跑**——合并本身可能引入冲突或环境差异,落回 master 后再跑一遍全套验证
|
||||
11. **会话收口落记**——`active.md` 快照与工作日志更新;跨会话有效的教训写入记忆库
|
||||
12. **实机目检归用户**——真机人闸由用户执行,用户亲口确认才算验收通过
|
||||
13. **中间产物吸收即死**——结论先迁入正主文档(GDD/待办清单/路线图),中间文件即删且永不提交(细则见硬性红线)
|
||||
|
||||
## 硬性红线(勿违反)
|
||||
|
||||
- **worktree 铁律**:主工作区禁止直接改动与提交(细则见上节;并行会话各占 worktree 互不踩踏)
|
||||
|
||||
Reference in new issue
Block a user