diff --git a/CLAUDE.md b/CLAUDE.md index 5a676f46..b8d5d225 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -82,7 +82,7 @@ **第三段·实现**——产出代码与配置文件，可运行的游戏。 - 触发：需求卡片永不单独施工，统一由用户指定迭代号触发（=U0 开工令）；执行按 /iter 技能与下方批次工作流标准清单。 - **设计权威文档（GDD/art-bible 等承载设计决定的文档）在实现批内一律不更新**——文档与用户想法等同对等，任何更新必须经用户同意；实现批只出迭代实现报告（见下方第 12 条文档同步闸）。 -- 收口人闸：实机目检清单＋代拍板追认单交用户；后置不阻塞收口，用户验完才算真完。 +- 收口人闸：实机目检清单＋代拍板追认单登记交用户即完成批内义务；真人检测不阻塞收口、不阻塞后续迭代开工，用户自行安排时间验收（2026-10-12 用户立规，替代旧「用户验完才算真完」口径）。 ## 批次工作流标准清单（2026-10-06 用户确认固化） @@ -107,7 +107,7 @@ 10. **合并后主区全量复跑**——合并本身可能引入冲突或环境差异，落回 master 后再跑一遍全套验证 11. **会话收口落记**——`active.md` 快照与状态记录更新（含删除已完结旧条目，退役规则见 `design/dev/doc-conventions.md` §10）；跨会话有效的教训写入记忆库 12. **文档同步闸 v2（2026-10-10 用户改立，替代 2026-10-09 版）**——文档更新时间点分两层：**机械面文档**（roadmap 行换代、registry、active.md 记账、README/工具注）合并/入库前随批更新完毕方算收口（原口径不变）；**设计权威文档**（GDD/art-bible 等承载用户设计决定的文档）实现批内一律不更新——文档与用户想法等同，更新必须经用户同意：实现批收口产出**迭代实现报告**（`design/qa/iter-实现报告-<日期>.md`，一个迭代一份，含各卡状态＋代拍板追认单＋**GDD 反哺点节**——实现与设计的差异/缺口逐条列明），反哺点收口时同步登记 `design/gdd/06-待办清单.md`，用户逐点裁决后另批落文（可随批捎带，窗口长短由用户控制）。反哺点未落文期间，相关 GDD 节按 06 登记视为待反哺状态——读该节做新设计/写新卡前先查 06，勿把旧文当现行事实。需求卡片仍必列「关联文档同步面」，同步义务按两层标注（机械面=随批更新；设计面=报告反哺） -13. **实机目检归用户**——真机人闸由用户执行，用户亲口确认才算验收通过 +13. **实机目检归用户，只登记不阻塞**——真人检测项由 agent 登记进迭代实现报告目检总清单与 07-体验验证清单，登记完毕批内义务即完成；自动化闸全绿即可合并收口，用户自行安排时间验收，结论按 07 清单回流路径回流；禁止把「等用户目检」当作停工理由或任务完成的必要前置（2026-10-12 用户立规，替代原「用户验完才算验收通过」口径） 14. **中间产物吸收即死**——结论先迁入权威文档（GDD/待办清单/路线图），中间文件即删且永不提交（细则见硬性红线） ## 硬性红线（勿违反） @@ -119,6 +119,7 @@ - **用语红线（2026-10-04 用户立规，黑话审计后落文）**：面向用户的一切输出——文档、状态记录（active.md）、报告、清单、对话——禁止自造黑话与代号式命名；判据 = 业内读者没读过项目历史也能一遍看懂，需要作者解释才能懂的词必须展开成完整白话句（三种固定形态、本仓反例全表与正确写法见 `design/dev/doc-conventions.md` 第 4 节） - **呈报六问铁规（2026-10-07 用户立规）**：向用户呈报一切事物——bug、需求、概念设计、提案——一律按六问结构顺序展开，确认后才动手实现：①**What 现状与差异**——现在是什么样（引用文件、行为等事实）+ 要做什么/改什么；②**Why 期望与动机**——目标态是什么样、为什么值得改，含「不做的代价」；③**How 怎么改**——修改路径，有备选案全部列出不私藏；④**Where 影响面**——改动波及哪些系统、文件、流程、既有裁决；⑤**怎么算改对了**——可判定的验收标准，不写模糊话；⑥**不确定的地方**——没把握、需要用户裁决的点，单列收尾不埋正文。**Who/When 不进呈报正文**——谁来执行、什么时候做由用户决定，由 roadmap 与需求卡片承接，呈报里最多一句话带过。**适用范围（2026-10-08 用户补立）**——六问结构只用于**首次描述需求、bug 缺陷或相关方案**的呈报；同一方案的后续对答（追问、讨论、细化、执行汇报）不再套用六问结构，除非用户显式要求 +- **真人检测不阻塞（2026-10-12 用户立规）**：一切需要真人检测/实机目检/人工验收的事项一律「只登记、不等待」——登记进 07-体验验证清单（或当批实现报告目检总清单）即完成 agent 侧义务；自动化闸全绿即可合并收口，后续迭代照常开工，验收时间由用户自行安排。禁止把等真人检测当作任务阻塞点、停工理由或收口必要条件，也禁止因往期遗留真人检测项而拦截新迭代开工 - **数值单一事实源**：玩法数值只存 `data/tables/`（.tres），经 `ConfigDB` autoload 类型化单点读取；禁止数值字面量与自建 `load()` 表路径 - **RNG 单点**：禁止 `randomize()` / 自建 RandomNumberGenerator——随机只经 `RngService` 统一流（单盐单计数器+用途标签+全事件日志，ADR-0007 裁丙 2026-09-27） - **Core 层零 UI 依赖**：完整战斗必须可 `--headless --script` 跑通 diff --git a/design/gdd/07-体验验证清单.md b/design/gdd/07-体验验证清单.md index 263bb6ca..663a800b 100644 --- a/design/gdd/07-体验验证清单.md +++ b/design/gdd/07-体验验证清单.md @@ -1,6 +1,6 @@ # 07-体验验证清单 -本文登记**需要真人体验/观测才能下结论**的验证项，与 [06-待办清单](06-待办清单.md) 分工：06 登记"要拍板的事"，本文登记"要玩过才知道的事"。每条注明**结论回流**路径——体验感受不满不等于当场改数：数值终值归其登记的归属批，体验反馈是该批的输入。 +本文登记**需要真人体验/观测才能下结论**的验证项，与 [06-待办清单](06-待办清单.md) 分工：06 登记"要拍板的事"，本文登记"要玩过才知道的事"。每条注明**结论回流**路径——体验感受不满不等于当场改数：数值终值归其登记的归属批，体验反馈是该批的输入。**登记不阻塞（2026-10-12 用户立规）**：真人检测项登记进本清单后，实现批照常合并收口、后续迭代照常开工，验收时间由用户自行安排，结论按各条回流路径回流。 状态词汇设计权威=增益状态 状态词表节（原提案 v1.0 已按生命周期条款退役,git 提交 7f24b64 可考）