Commit Graph
16 Commits
Author SHA1 Message Date
DKChan 5858629719 docs(规约): 第二刀按真实范本密度压缩——CLAUDE.md 67行祈使句体+流程纪律独立成文(2026-10-15 用户令)
- 对照实测范本(anthropics/claude-code 40 行、openai/codex ≈250 行纯祈使句等七份)逐类清除叙事层:
- CLAUDE.md 140→67:三段开发流程/批次清单/分支纪律/两入口与MC细则/像素纪律全部降级出主文件;红线压成一行一条祈使句+指路;呈报六问压缩为单条索引行
- 新增 process-conventions.md(86 行):三段流程表格化+批次清单 14 条+两入口/MC 触发/分级周期/MC 档位/闸机轮次细则+像素结构件纪律——批次开工时加载
- 新增 code-conventions-cases.md(55 行):全部反面案例+缺陷对照表迁入(不常驻加载);code-conventions 148→92 行纯规则
- doc-conventions 149→120:总纲收一行、论证段压括注、骨架与生命周期条款表格全保
- 规则名全保(两入口铁规/文档同步闸/MC 触发细则等外部按名引用零断链,已全仓扫描核实)
- 机械闸:七文件≤150 ✓ IMPORTANT=0 ✓ 日期残留=0 ✓ 主文件叙事残留=0 ✓ 熵增闸 PASS ✓ doc 两闸零波及 ✓
- 行为验证:全新上下文子代理六问导航 6/6 正确(新增流程/像素面全命中)
2026-10-15 15:38:16 +08:00
DKChan 18e22f1b44 docs(规约): 规则文件审计与目录划分批——150行上限+领域拆分+日期注记清零(2026-10-15 用户令)
- CLAUDE.md 137→140:日期注记全清;文件头红线收敛为指针(全表唯一权威=code-conventions §1.4.1);测试两入口/闸机轮次/MC 档位超长红线拆子条目(MC 精度数字收敛为 sim-data/README 档位表指针);规范导航补 test-conventions/concept-conventions 两行
- code-conventions 210→148:§3 测试纪律拆出独立成文;缺陷对照表与版本历史表退役(历史归 git);反面案例去日期化;与 §1.5 重复的流程条目合并
- doc-conventions 210→149:概念封装/引用纪律/归档三节拆出 concept-conventions.md(原 §7–9 合并桩节标注);§10/§11 保号——active.md 与 tools 脚本存量引用零断链;数值纪律强制收口条款移出表格单元格
- 新增 test-conventions.md(49 行):探针标配/回归断言/提交前全量验证/验收清单落码规范
- 新增 concept-conventions.md(54 行):概念封装建模/跨文档引用纪律/归档与事实源
- 机械闸:五文件行数≤150 ✓ IMPORTANT=0 ✓ 日期残留=0 ✓ 熵增闸 PASS ✓ doc 三闸(gdd_lint/doc_link_audit/doc_term_audit)对改动文件零波及(存量 GDD 基线失败与本批无关)
- 行为验证:全新上下文只读子代理五问导航 5/5 正确(含两份新文档命中与 §10/§11 交叉印证)
2026-10-15 08:07:09 +08:00
DKChan ac19754374 docs(glossary): 退役词对照表全库强制清扫——正主→现行事实源130行+落籍→已入库79行(39文件194行,语境微调=权威文档/权威定义节/拼表制主选/入库注记等;对照性文本豁免保留)+五词终验零真残留+术语表v1.3+active 446(2026-10-11 用户令收尾) 2026-10-11 05:46:49 +08:00
DKChan 6951632d25 docs(glossary): 术语表建立+全库术语统一批——危险格/整图/专长凭证(2026-10-11 用户四裁)+秘宝.md v2.5 可读性审查批
- 新建 design/gdd/术语表.md v1.0(四节术语+退役词对照;02 清单登记;用户令查表阅读)
- 全库更名:雷格/惩罚格→危险格(113 处)、雷安→危险格与安全格(39)、板级→整图(29)、门票→专长凭证(88)、雷位→危险格位置(5);排雷玩法定义句换代+版本行
- 秘宝.md v2.5 可读性批:术语指路+黑话清扫(正主/落籍/P1甲死指针/charges/结构闸等)+承重契约白话化+验收分层白话化+两处过时事实修正(战斗道具窗口 2026-09-15 已下线/21 项义务死指针)+版本行序修复
2026-10-11 03:56:12 +08:00
DKChan 933e1a9421 docs(conventions): 用语纪律落正面总则「见名知意,所见即所得」(2026-10-10 用户立规)
正文三处:§4 标题补八字总则;开篇新增正面总则段(见名知意管名字、所见即所得管句子,注明管语义透明不与第 8 节指路存根冲突);版本历史 v16 行。随批:active.md 状态记录 437 号。
2026-10-10 18:33:48 +08:00
DKChan c848cefe9a docs(rules): 「工作日志」废止全仓改「状态记录」+会话状态清除新规+秘宝实装待办登记(2026-10-10 用户令)
- 五文件 105 处「工作日志」→「状态记录」(active.md 31/doc-conventions 13/CLAUDE.md 5/06 10/roadmap 46;残留 2 处系更名动作引述保留)
- doc-conventions §10 章程:定性补「状态记录,不是工作日志——旧叫法废止」+退役规则首句落新规「用户确认任务完成时清除当前会话写过的状态条目——状态清除即任务完成证明」
- 06 新条「秘宝体系实现重构落地批」(冻结待发令):新 15 件实装+旧数据行清理(deferred 清零)+27 专长行删除+空配置验收闸+池选型三案+效果引擎扩签核实+两疑似漏项 T0
2026-10-10 15:17:08 +08:00
DKChan fa430f2584 docs(rules): 三段开发流程立规+文档同步闸v2——设计/写卡/实现三段出入口(2026-10-10 用户令)
- CLAUDE.md 新增「三段开发流程」节:设计(用户点头心智模型一致才落文档+裁点清零才算完成)→写需求卡片(grilling 多轮复核零待裁+入库必登记 06)→实现(迭代号 U0+设计正主文档批内一律不更新);批次工作流清单引言同步改指
- CLAUDE.md 批次工作流第 12 条改 v2:机械面文档(roadmap 行/registry/active.md/README/工具注)合并前随批同步不变;GDD/art-bible 等设计正主改走迭代实现报告反哺制——收口出迭代级实现报告(design/qa/iter<N>-实现报告-<日期>.md,含各卡状态+代拍板追认单+GDD 反哺点节),反哺点收口时登记 06,用户逐点裁决后另批落文
- doc-conventions §11 新增「迭代实现报告」行+「证据只留最新」措辞换代+版本历史 v15:实现报告属中间文档,替代原每卡出口报告

背景:武器锻造取证确认「迭代」曾被当作一切批次容器(迭代18卡③设计提案混进迭代通道)致「迭代完成了但游戏里没有」口径错位;用户立规依据=文档与用户想法等同对等,文档修改必须经用户同意,只出报告、同意后再更新。纯文档批零代码零测试(两入口铁规)
2026-10-10 02:08:16 +08:00
DKChan bbc849eac5 docs(audit): 文档正确性审查·独立复核批(worktree docaudit-2026-10-09,基点 03c4b4c——18 文件语义级清漏,主区零触碰)
R1 状态与证据对齐(全部代码实证):
- 存档序列化 v2→v6 换代(save_manager.gd SAVE_FORMAT_VERSION=6 实证):数据模型 JSON+域清单补 v4 同调三域/v5 树域/v6 生涯两域逐行 owner、版本与迁移节五件迁移链、调参表常量 6;v3-v6 四次升版当时均未回写本文,本批一次清偿(v1.4)
- 数据配置表清单四处失同步:变异表六行→七行(variation.tres 实测 7 行含贫矿脉)/RewardConfigTable 行删除(reward_config.tres 与类名全仓零命中)/AuxItemTable→TreasureItemTable(treasure_items.tres)/MetaTable 四行族→五行族(+attune_refresh_upgrade)+HeroTable 补 armor_class(v0.6)
- node-reward 令牌池六种→七种(adventure_table.gd CURIO_KINDS 实测七类含 refresh,curio_quota_refresh_rare=2 在役;v2.5 修订漏登,v2.6)
- interaction-patterns #19 inventory_panel_view.gd『已实现』系失实登记(git 全史零记录,从未入库)→占位失效
- level-clear『加权洗牌掷 3』漏网旧口径→令牌池洗牌不放回(与冒险结构 v0.14 对齐)
- 奇物依赖表 relics.tres→feats.tres(表文件已换代)+§1.3 异质性账清单对齐凭证件表(AP 上限摘除)(v3.10)

R3/R4 退役残留清漏:
- 行动经济依赖表『挖/插/拔』拔旗残留(v0.4 批漏网,v0.11)
- 地图战斗资源依赖表『秘宝的背包』同调形态残留(v0.22)
- 冒险结构『秘宝件受同调位约束』替换交互无现役触发面补注+『06 在册』悬空指针清偿(v0.19)
- HUD框架秘宝义务行『库存条常读』→装配件与充能常读(v0.15)
- 教学引导/P0 闭环/战斗结算/level-clear 等六处『秘宝背包/关卡末清库』补机械惰性承载注(treasure_inventory 代码实证在役但投放渠道全退役恒空、拆线归实装批——battle.md『无关卡域清库面』表述精确化)

R2 里程碑/批次口径:
- level-map 四处 M-1/M-2 前缀删(迭代 2 框材组=git 9abf5ff 实证;迭代 4 三处)
- 07『难度修正批』全替『数值批(Beta 阶段,未排期)』(v0.4)
- 教学引导『里程碑定位 Alpha』两处→Beta 阶段(2026-10-04 用户拍板漏同步,v0.5)
- HUD框架 P1『秘宝内容重定批』过期批次名→node-reward v2.5 在役

指路断链:
- 06 archive 死链改写(不入库目录表述)+两条『用户令删除』死条目整条移除(git 留痕)
- 07 三处伪死链去链接语法
- 奇物 §1.6 两处 ../ux/→../../ux/(v2.7 旧债,doc_link 复验清零)+06 欠账条目同步清偿注

规范两份:
- doc-conventions §1『现行文档不跑 lint』与现实对齐(gdd_lint=机检三闸之一在役,v14)
- code-conventions active.md 旧路径迁根目录+版本表补建(v2)

doc 三闸终验:doc_link 死链 4→1(剩 1=版本历史行内历史引文按纪律保留);gdd_lint 5 不通过/doc_term 6 旗均与基线持平零新增
2026-10-09 21:25:40 +08:00
DKChan 03c4b4c933 docs: 文档正确性审查批+去毒+命名统一+天赋树成文等十一批落籍(2026-10-09 用户令)
一、里程碑语义立规:M3=Alpha 完整实现/M4=Beta 完整实现,未明令关闭 M3 前只排 M3 需求(roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注);迭代 20/21/22 规划冻结(roadmap 迭代 20 行注——先解决眼前问题,重启=用户直接发令)
二、文档正确性审查批三波:全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀(M-x+迭代N→迭代N,裸 M-4→Beta 阶段(未排期))/退役词退役件当现役清零/在役旧实现节加隔离横幅;重件=秘宝.md v1.7 老正文深层清算(横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正)+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份(battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map)
三、去毒批:奇物 v3.7(魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表)+秘宝 v1.6(速览旧目录退役标注/退役件示例换现役)
四、道具退役素材库新建(design/research/道具退役素材库.md,案乙已追认):秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行;魔法提灯(fog_lantern)裁退役(06 条目已裁+秘宝.md 注记换代+素材库迁表一;拆线归实装批)
五、B2/B3/B4 裁决落文:元进度.md 道具工坊行删旧写新(v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级);奇物.md P1「两项合成高阶项」注销(v3.9——用户定性脏信息);§3 刷新句按最新口径换代(刷新券替代、不进持有集)
六、天赋树独立成文(B1 裁决):新建 design/gdd/systems/跨局循环/天赋树.md v0.1(33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道)+元进度.md 定名节换代(v1.11)+02-系统清单跨局循环区加行(v1.17)
七、A 类卫生包:版本历史表理排四份(秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成,只调行序)+缺号注记三处(增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批)+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记(v0.27)+B5「现役 UI/文案两处自相冲突」登记 06 待办(battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修)
八、命名统一(用户令「任务书」全库改「需求卡片」):167 文件约 800 处(design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注);两文件改名(需求卡片-M4数值批/需求卡片-冒险前资源配比预设批);残留=自造短语全量清单(黑话证据文档故意跳过)
九、CLAUDE.md:批次工作流标准清单收口段新增第 12 条「文档同步闸」(需求卡片必列关联文档同步面、合并前同步完毕方算收口,原 12/13 顺延);呈报六问铁规适用范围补立(前序批随批落籍)
十、active.md 快照节+工作日志 414-421(并行会话 416 黑话清扫条目按共享工作日志惯例一并入库);06 中并行会话「active.md 定性与裁剪」条目未提交,按零吞并纪律留在工作区未入库

零测试(文档批两入口铁规);主区前序脏件(.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等)未带
2026-10-09 19:12:46 +08:00
DKChan 8e02dcf05b 清理: design/存量超期批——删86件(dev四组11+qa证据39=只留最新规首跑+research 34)+引用改写17处/15文件+doc-conventions §11新增证据只留最新(v13)+美术审计报告留置呈报(工作日志 413) 2026-10-09 03:58:50 +08:00
DKChan 442cd511a0 修复: design/结构批——diagrams 迁入 dev/architecture(案甲,熵增闸红灯清零)+旧档 GDD 引用全量摘除(31处/29文档+code/schema头注13文件+registry 5行)+doc双工具摘design/ux死路径(工作日志 412) 2026-10-09 03:29:09 +08:00
DKChan cc7952ce29 用语红线补强:自造词三形态禁令落文(2026-10-04用户令,黑话审计后——doc-conventions §4新增三种固定形态禁令表〔工作包代号/机制造词/流程造词,各带本仓反例与正确写法〕+通行检验标准+写后自查+v11版本历史;CLAUDE.md硬性红线新增用语红线一行) 2026-10-04 07:01:51 +08:00
DKChan 631b1dfe99 台账去压缩:废除active.md每条≤3行约束(2026-10-04用户立规「能看懂比字数少更重要」——doc-conventions §10改白话句子口径+第4节黑话禁令对台账同等生效+v10版本历史;CLAUDE.md会话进度记录行同步;起因=黑话审计证实≤3行压缩压力系自造缩略语繁殖地) 2026-10-04 06:56:08 +08:00
DKChan bd63a70754 docs: doc-conventions v9 新增§11文档生命周期吸收即死(2026-10-01用户立规)+CLAUDE.md硬性红线同款条目——中间文档寿命=迭代寿命/结论吸收进正主即删/未决先迁06与roadmap再死/永不入库/引用面口径/台账记结论/sim-data白名单/迭代出口清理项;顺手修文首与§10两处过期路径(docs/、production/);三闸=基线零新增(死链增量3处系gitignored目标在fresh worktree不存在的环境差,06清单本批零改动) 2026-10-02 05:20:48 +08:00
DKChan 12e934be01 rulings: 试玩反馈两题裁决落文+doc-conventions 两条款成文——题一拍案甲视野迷雾(暗淡记忆态/半径8格同圈/提灯灯甲+微光不随扩/收窄后置)HUD框架「视野迷雾」正主节+v0.13;题二拍「不动」各案不采用留档;doc-conventions v8 增落位五要素+无正主不下定义+口径携带纪律 2026-09-30 06:59:44 +08:00
DKChan 7f24b640ea refactor: production 解散+docs 并入 design+tests 归 game 三层收敛——active.md/roadmap/stage/review-mode 升根目录;qa 报告→design/qa(gate-checks/alpha 验收/任务书→research);docs/→design/dev+registry 并档+散提案→research;tests/→game/tests(空架子 README+示例,真测试在 game/smoke);game/tools→tools+样例输出→sim-data;qa-data→sim-data;design/ux→gdd/ux;删 loop-dashboard.html(可再生成)+route_overlay_preview(零引用);钩子三件+loop_dashboard/balance_verifier/render_sample_sheet 路径随迁;断链修复 12 文件,余 7 条全为搬前幽灵链 2026-09-27 04:56:27 +08:00