Files
gplan-2/reports
DKChan 4a650d0ed3 写卡(营地交互修复批·一张卡三需求点): reports/需求卡片-营地交互修复批-2026-11-05.md 成文——件1 开局被开始层盖住(契约1 限开局/续玩两路径的隐藏点收一处+摘 main.gd:194 冗余句)、件2 弹窗钮序镜像(推进→次→维持,四处共用件同一序,成员与连接零动)、件3 顶栏加可见栏体(色值做成 UiKit 带 α 派生常量 CAMP_HUD_BAND=Color(CAMP_HEADER_BAND,0.80),矩形由顶栏件自建); 对照表 R1-R8 七格齐+判据出处行锚+能力行(两枚新增能力同批入 game/tests/README.md:162-163); 卡片头部申报 验收档=中、设计事实源三处定稿(camp.md v2.8/HUD框架 §提示与弹层/art-bible v3.43)+色值落点定稿与两项 Godot 4.7.2 实测(const 派生 const 编译通过 to_html=true 得 6e4526cc;色道单精度使 a==0.80 为 false → 断言禁浮点分量直等,改 to_html 比对); 三轮内改的四处架构违规=①R3 撤"升成员供测试直取"(抵触 architecture.md:168 视图单元接口/:323 禁直引实现内部,改公开子节点序)②顶栏 α 从视图内挪进公共件(依 ui_kit.gd:2 全站取色唯一出口)③契约4 措辞纠正(禁新增语义色而非禁派生常量,依 HP_BAR_TRACK:200 收口先例)④同步面补 architecture.md:175 CampHudBand 行; 两轮独立复核全落=轮次1(22 条:19 采信落卡/2 转用户裁 Q1 Q2/2 条经写卡段回读推翻)+轮次2(5 条:R3 双钮断言必红硬伤改 child(2)+子节点数非空前置、R5 补开营地前置(camp_scene_view.gd:51 初始隐)、T3.0 补入树后读数时机、行号八处与尺寸链确认、Q1 裁决解释面按自判落并向用户报备); 同批登记两条工程改动待办(认锚式不含中文段 pipeline_gate.py:68;层序落位单口扫描面不含子目录 source_guard_test.gd:85-99,均工具代码/待执行); 待办清单本条状态 文档设计已闭合+已写卡; 本步凭据: 流水线闸直跑 PASS(待办条目 27/卡片口径 2 张全过)+tools/run_all_gates.sh --docs exit=0「验收通过,闸况与基线一致无新增红」(回执 domain=docs 基线 00d7bbfb); 过程附记: 用语闸 doc_term 曾把待办条目里文件名 ui_registry.gd 的子串 registry 判为退役词疑似现行(基线绿→现红),已改以函数名 apply_layer_contract() 作锚避开误报、可检索性不丢,该误报属闸件面另议
2026-11-05 23:56:38 +08:00
..
写卡(营地交互修复批·一张卡三需求点): reports/需求卡片-营地交互修复批-2026-11-05.md 成文——件1 开局被开始层盖住(契约1 限开局/续玩两路径的隐藏点收一处+摘 main.gd:194 冗余句)、件2 弹窗钮序镜像(推进→次→维持,四处共用件同一序,成员与连接零动)、件3 顶栏加可见栏体(色值做成 UiKit 带 α 派生常量 CAMP_HUD_BAND=Color(CAMP_HEADER_BAND,0.80),矩形由顶栏件自建); 对照表 R1-R8 七格齐+判据出处行锚+能力行(两枚新增能力同批入 game/tests/README.md:162-163); 卡片头部申报 验收档=中、设计事实源三处定稿(camp.md v2.8/HUD框架 §提示与弹层/art-bible v3.43)+色值落点定稿与两项 Godot 4.7.2 实测(const 派生 const 编译通过 to_html=true 得 6e4526cc;色道单精度使 a==0.80 为 false → 断言禁浮点分量直等,改 to_html 比对); 三轮内改的四处架构违规=①R3 撤"升成员供测试直取"(抵触 architecture.md:168 视图单元接口/:323 禁直引实现内部,改公开子节点序)②顶栏 α 从视图内挪进公共件(依 ui_kit.gd:2 全站取色唯一出口)③契约4 措辞纠正(禁新增语义色而非禁派生常量,依 HP_BAR_TRACK:200 收口先例)④同步面补 architecture.md:175 CampHudBand 行; 两轮独立复核全落=轮次1(22 条:19 采信落卡/2 转用户裁 Q1 Q2/2 条经写卡段回读推翻)+轮次2(5 条:R3 双钮断言必红硬伤改 child(2)+子节点数非空前置、R5 补开营地前置(camp_scene_view.gd:51 初始隐)、T3.0 补入树后读数时机、行号八处与尺寸链确认、Q1 裁决解释面按自判落并向用户报备); 同批登记两条工程改动待办(认锚式不含中文段 pipeline_gate.py:68;层序落位单口扫描面不含子目录 source_guard_test.gd:85-99,均工具代码/待执行); 待办清单本条状态 文档设计已闭合+已写卡; 本步凭据: 流水线闸直跑 PASS(待办条目 27/卡片口径 2 张全过)+tools/run_all_gates.sh --docs exit=0「验收通过,闸况与基线一致无新增红」(回执 domain=docs 基线 00d7bbfb); 过程附记: 用语闸 doc_term 曾把待办条目里文件名 ui_registry.gd 的子串 registry 判为退役词疑似现行(基线绿→现红),已改以函数名 apply_layer_contract() 作锚避开误报、可检索性不丢,该误报属闸件面另议
2026-11-05 23:56:38 +08:00
写卡(营地交互修复批·一张卡三需求点): reports/需求卡片-营地交互修复批-2026-11-05.md 成文——件1 开局被开始层盖住(契约1 限开局/续玩两路径的隐藏点收一处+摘 main.gd:194 冗余句)、件2 弹窗钮序镜像(推进→次→维持,四处共用件同一序,成员与连接零动)、件3 顶栏加可见栏体(色值做成 UiKit 带 α 派生常量 CAMP_HUD_BAND=Color(CAMP_HEADER_BAND,0.80),矩形由顶栏件自建); 对照表 R1-R8 七格齐+判据出处行锚+能力行(两枚新增能力同批入 game/tests/README.md:162-163); 卡片头部申报 验收档=中、设计事实源三处定稿(camp.md v2.8/HUD框架 §提示与弹层/art-bible v3.43)+色值落点定稿与两项 Godot 4.7.2 实测(const 派生 const 编译通过 to_html=true 得 6e4526cc;色道单精度使 a==0.80 为 false → 断言禁浮点分量直等,改 to_html 比对); 三轮内改的四处架构违规=①R3 撤"升成员供测试直取"(抵触 architecture.md:168 视图单元接口/:323 禁直引实现内部,改公开子节点序)②顶栏 α 从视图内挪进公共件(依 ui_kit.gd:2 全站取色唯一出口)③契约4 措辞纠正(禁新增语义色而非禁派生常量,依 HP_BAR_TRACK:200 收口先例)④同步面补 architecture.md:175 CampHudBand 行; 两轮独立复核全落=轮次1(22 条:19 采信落卡/2 转用户裁 Q1 Q2/2 条经写卡段回读推翻)+轮次2(5 条:R3 双钮断言必红硬伤改 child(2)+子节点数非空前置、R5 补开营地前置(camp_scene_view.gd:51 初始隐)、T3.0 补入树后读数时机、行号八处与尺寸链确认、Q1 裁决解释面按自判落并向用户报备); 同批登记两条工程改动待办(认锚式不含中文段 pipeline_gate.py:68;层序落位单口扫描面不含子目录 source_guard_test.gd:85-99,均工具代码/待执行); 待办清单本条状态 文档设计已闭合+已写卡; 本步凭据: 流水线闸直跑 PASS(待办条目 27/卡片口径 2 张全过)+tools/run_all_gates.sh --docs exit=0「验收通过,闸况与基线一致无新增红」(回执 domain=docs 基线 00d7bbfb); 过程附记: 用语闸 doc_term 曾把待办条目里文件名 ui_registry.gd 的子串 registry 判为退役词疑似现行(基线绿→现红),已改以函数名 apply_layer_contract() 作锚避开误报、可检索性不丢,该误报属闸件面另议
2026-11-05 23:56:38 +08:00

reports/ — 过程件容器

design/ 只放持久化设计文档与规范,过程件一律不放。过程件落本目录,按「吸收即死」到期即死。

放什么

文件 内容 谁写
需求卡片-<批名>-<日期>.md 一个需求单位的实施文档(roadmap 迭代行里的「卡①②③」是需求单位,需求卡片是它的展开):目标与完成定义/设计事实源/现状事实/契约/范围边界/任务卡/验收闸/代拍板白名单/待裁点 写卡段(req-card 技能)
提案-*/需求澄清-*/审计-*/评估-* 设计讨论段的过程稿:提案备选案与淘汰依据、需求澄清结论、调研与审计读数。被需求卡片或 GDD 当裁决源引用时在册;结论落进权威文档后即可删,删它不需要再裁(§11 吸收即死) 设计讨论段
iter<N>-实现报告-<日期>.md 各任务卡状态、实机目检总清单、遗留读数义务、实现决定记录(超白名单/超卡片明列范围事项的备案节,细则见 process-conventions §3 第 11 条) 迭代批
iter<N>-反哺点-<日期>.md 需要写进 design/ 权威文档的点,逐条列清"哪个文件哪一节、改成什么、依据是什么" 迭代批
iter<N>-验收审计-<日期>.md 独立验收审计结果:逐行对照表核对、撤销证明抽查、未过项与例外及依据 独立审计方(未参与实现)
iter<N>-<交付物名>-<日期>.md 需求卡片点名的其它交付物(例:iter27-探针迁移对照-2026-10-14.md=11 个探针的成员依赖面清单,已随迭代 27 收尾退役) 迭代批

不放什么

  • 不放设计结论。 本目录的文件是"待处理的申请单",不是事实源。反哺点由你在会话中讨论定稿后, 另开文档批写进 design/,写完即可删除本目录对应条目。
  • 不放图像载体。 png/jpg/svg 等图一律留 artwork/(2026-09-27 用户裁「审图只看一处」;熵增闸图像白名单不含本目录,放了判红)。.html/.json 这类报告渲染件允许作为报告的一种(2026-10-21 用户裁)。
  • 不放进度状态。 现在做什么看根 roadmap.md 顶部「当前位」节,待办与待裁看仓库根 待办清单.md(2026-10-18 用户裁:根目录会话状态文件已废除,本目录也不许兼做状态记录)。

生命周期

一个迭代号一组文件,所属迭代实现批合回 master 即死(判据权威=doc-conventions §11:需求卡片与迭代产出物的死期都是合回那一刻,roadmap 对应行改填「已退役(git 历史可考)」保留字):反哺点须先由 design/ 吸收落文,再连同卡片与本目录其余产出物一并删除,历史进 git commit log (与"历史决策记录只进 git log、不设决策文档"这条红线同口径)。退役执行=batch-closure 技能 (批后收尾与中间文档退役),删前先过 doc-conventions §11 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。