28 Commits
Author SHA1 Message Date
DKChan b86e0b803a 文档(复核纪律批): 三处规约同步——process-conventions §2 段三补复核发现四类去向与成立凭据·段四编排四查换代为五查(新④复核记录在位·生效=卡片文件名日期 ≥2026-11-06·旧卡不回头改)·§3 第1条先检索后提问扩为全段通用并禁把权威文档已答的当问题呈报·第2条给待拍板点下边界;doc-conventions §12.1「已写卡」证据项加复核报告路径+编排四查两处随动;AGENTS.md 五段流水线铁律补「卡内复核记录在位」。件核凭据 python tools/pipeline_gate.py exit=0(PASS:待办条目 26·总表数据行 52·卡片口径 3 张全过)+grep 编排四查 零残留(唯一余处在本批待办条目实况内,指改前形态) 2026-11-05 07:01:26 +08:00
DKChan 66b2ed20f3 规约(概念/实现分界·用户立2026-11-05): doc-conventions 数值纪律换代——GDD 概念文档只定概念/机制/规则,数量面与呈现实现细节不进概念正文;分工三处定案(取值域与字段契约=game/data/schemas/*.gd 域校验执法·现行值=data/tables/*.tres·呈现实现规格=design/gdd/ux/ 呈现实现设计规格层豁免概念纯度);禁实现内容行数据索引例外扩及 data/schemas;收口条款 1/2/5 随动(GDD 表格正文→概念规则句·调参表锁数删列→概念文档不存现行值·压缩批 GDD 表格→参数契约节);§6 骨架调参表节改参数契约(概念面+指路 schema);AGENTS 术语行同步(规则=owner 概念面·取值域=schemas);存量旧调参表节清扫归独立批、消化期不作机检对象(闸无此项判据);本步凭据: 文档域闸 8 道全 exit=0,回执 all_green=true 基线 937d14a1,判定=闸况与基线一致无新增红 2026-11-05 05:31:11 +08:00
DKChan 7639ec5b3a 工程改动(验证整改阶段3+4·用户令): 验收档三档申报落test-conventions §8.3(判据=失败代价单维,卡头申报U0确认改判,2026-11-05生效,未申报旧卡按高档全量审计)+审计深度分级落§8.7(高档=现行四件事全量,中档=逐行保留复跑省略以CI回执代证,低档=对照表抽查≥1/3且新增改判行必抽,削弱检查与例外核对三档全保留,档位存疑按高档)+doc-conventions §12.1条目正文限长双判据(≤12行且≤700字去空白,过程叙事归git提交信息)+pipeline_gate机检两件(条目超长行/字双判据+卡片验收档申报C4)+req-card/iter两技能随动(必备结构第16节/审计深度分级口径)+待办清单9条存量压缩(过程叙事归git与过程件指针)+ci_watch中间态误写终局红回执缺陷登记(run 37实证:回执16:59记红,run 17:03才succeeded,现查API全绿)+整改条目整条删除(四方向全完成,测试有效性度量用户裁暂不处理)+盘点报告退役(吸收即死,design零引用)+批报告; 负证三件(字数829红/行数18红/验收档缺申报红-申报后消红); pipeline_gate PASS 28条目; --docs全绿 2026-11-04 01:37:27 +08:00
DKChan f2ea8adabe 规则(用语强标准对齐·用户令): 两处弱标准「首现处附一句白话定义」对齐 §4:57 强标准「展开成完整白话句」——doc-conventions §4:46(加「同通行检验标准」指针, 术语表登记保留)与 00-游戏概念:44(词句直换); 同一输入两标准违反 spec-AC 红线(AGENTS.md:114), 弱说法全仓清零(grep 核过现行文件仅此两处); 禁用词表与冻结机制不动, .qoder STC 副本经用户确认在用保留 2026-11-03 02:52:36 +08:00
DKChan f17f2614f5 规则(回答风格换代·用户令): AGENTS.md 回答风格重构——三条核心原则扩为四条(用词封闭:先完整描述后短说法/删已立名豁免/同物同名; 判断挂依据:三种合法依据+结论行后必须跟依据清单+无据标推测), 新增交出前自检清单与重讲改写工具节(接线 eli5 与 simplified-technical-chinese); doc-conventions §4 沟通面收敛为书面件、对话面指向 AGENTS.md; 依据=本场对话病历(结论无链/现造词替代描述/规则零自检)+ASD-STE100 与核查链调研 2026-11-03 02:16:33 +08:00
DKChan 78c8f83419 文档(载体默认换代批·用户裁): 图优先载体默认 HTML+SVG——AGENTS.md 载体句换代(默认 visualize 技能 HTML/SVG 内联渲染·流程结构图与空间对比像素示意同一通道·无内联渲染退 Mermaid·再退字符画)+doc-conventions §3 流程行换代(默认文档内嵌 HTML/SVG 表现力优先·图体行数计入节点篇幅·过滤型网页端改 Mermaid·无渲染环境字符画)+节点内顺序句随改;2026-10-31 用户裁,理由=表现效果更好,接受网页端过滤内嵌 SVG 与 git diff 可读性代价 2026-10-31 06:15:08 +08:00
DKChan e34dceb1a9 文档(图优先表达批): AGENTS.md 回答风格规则加图优先小节+格式优先级换代——判据=多实体明确关系(顺序/包含/依赖/状态转移/布局对比)内容直接画图不写长段,单点事实与纯数据不画;载体=节点连边图默认Mermaid代码块·空间对比与像素级示意走visualize技能HTML/SVG·无渲染查看端退回字符画;边界=硬数值与前提留文字·图不承载唯一数值依据·图文禁重复;doc-conventions 表达分工同步扩(§3流程行扩「字符画或Mermaid」收编结构关系类,复杂结构图优先Mermaid源码即文本,§2箭头链句与节点内顺序句随改);依据=cnoe-io/LMCache/vercel-labs三份AGENTS.md在案条款+Anthropic系统提示词artifacts图示必须可视化规则,2026-10-31 用户裁 2026-10-31 06:04:46 +08:00
DKChan 39907d82f6 工程(闸机提速批·随动件入库): ①run_all_gates.sh 文档域增量档本体已由并行会话 a7c63850 先行入库(同内容零冲突),本笔补齐其随动四件——ci_runner.sh 回执采信修正(回执 commit 与在跑尖端对齐才采信红项,不对齐写 note 标记:闸起手自检即中止时不写新回执,盘上旧回执当本次红项会撒谎——2026-10-31 实跑缺陷修正)+规约三份随动: AGENTS 改动四类与五段铁律的直改通道句收敛(『登记在案后由用户发令』→『由用户发令』),process-conventions §2 同句与写卡段配套维护句同步,doc-conventions §12.1 直改序列去登记段+条目定位句换代(『现在不做、以后才做的事』登记一条;条目记录走到哪一段,不是各段的开工前置) 2026-10-31 05:03:38 +08:00
DKChan 6690c2a75b 文档(实现指证清理): GDD 全树纯代码指证换代中文设计表述+纯度闸新增反引号调用形态判红——六类清算(方法/信号/类/常量/探针/调试与遥测入口名/提交号与运行时文件路径),保留面=数据索引(.tres 表路径与表名、表字段、表内枚值、存档键、封闭词表标签)并在 doc-conventions §5 明文写死;能力审计闸加 CALL_FORM_RE 窄规则兜底;顺修 §5 表两行误合并 2026-10-29 03:58:14 +08:00
DKChan 915222fa0a 工程(能力审计闸上电): tools/capability_audit.py 接入文档域 08e——GDD 纯度+能力清单与覆盖域表结构由机检兜底;baseline 加 08e 绿记录、07/08d 条目随批 5 文档清理实测归绿;test-conventions §8.9 与 doc-conventions §5 补闸件指路句(闸件清单唯一出处=run_all_gates.sh 头部) 2026-10-29 02:55:06 +08:00
DKChan 032d923c7e 文档(验证与清单体系·阶段1): 三层模型入法——验收意图/覆盖索引/执行证据分层,四法则与写卡段维护时序落三份规约+AGENTS.md 红线
test-conventions 新增 §8.9(三层表+四法则=每格非空/每条断言有归属/数量不守恒覆盖守恒/无全局对账总账,含维护时序与文档纯度);§8.3 能力清单维护锚改写为写卡段维护、实现批禁写。doc-conventions §5 增「禁实现内容」行(代码路径/测试文件名/断言名全文禁写,例外=配置文件索引),§6 骨架验收标准口径同步。process-conventions §3 第 11 条与 AGENTS.md 改动四类红线补 `game/tests/README.md` 禁写面。待办条目 5 实况记 2026-10-29 用户三裁与五批落地计划,状态维持文档设计已闭合。pipeline_gate 绿(42 条目/41 行/7 卡)。
2026-10-29 01:48:40 +08:00
DKChan dd99884e12 文档(代拍板追认单退役): 取消批后追认环节——独立产出物 iter<N>-代拍板-<日期>.md 废止,超白名单/超卡片明列范围事项改记实现报告「实现决定记录」节(逐条记决了什么/为什么/代价/撤销方式,全按卡执行只写一行零拍板)——2026-10-28 用户裁:追认环节自设立起未被逐条行使、实现面全权委托,备案记录并档实现报告;三道前置闸不动(卡片代拍板白名单预授权/实现段零裁断/验收有效性事件当场停机呈报);修订面=process-conventions(五段表完成人闸+§2零裁断段+§3第11条产出物)+doc-conventions §11载体表+AGENTS.md reports行+reports/README产出物表+repo_structure_audit头注,iter/req-card/batch-closure三技能随批直写(.zcode不入git);登记与完成同会话坍缩故条目免落(待办清单正被iter40收尾会话编辑,避抢写;现存两份代拍板单已由该会话按退役判据暂存删除,不追溯) 2026-10-28 05:31:04 +08:00
DKChan b6f11c1f8a docs(架构文档·知识沉淀批): 三件补文——通信形态选型理由(数据流§2:同步直连=可回放红线,Godot信号=同步派发,无事件循环)+效果引擎「全同步解释器不是事件总线」定位(基础层表,删T3扩签冻结计数括注)+架构原则9「停点权威在核心层」(两层阻塞机制);十处删改——未决问题表已落定三行(QQ-01/02/03,gdUnit4决定迁测试与质量域)+引擎知识缺口节压缩为engine-reference指针+覆盖GDD行八计数普查改根索引指针+层项「18项」两处冻结计数+RngService流词表枚举改PURPOSE_TAGS指针(实测缺九流)+存档路径节「MVP无存档」过时陈述与旧契约句修正(意图序列/窗口选择序列已非现行)+MVP关键路径行+数据流节重号4→5;doc-conventions §5新增「活体清单不冻结计数」(三实例评估);architecture v1.14→v1.15;待办清单登记直改批 2026-10-26 04:54:43 +08:00
DKChan c36f97d778 docs(规则修订): 规范导航触发前移——读规则从「写X前」提前到「定X方案前」:AGENTS.md 文首指针与导航表头改「定方案前先查(确认写什么内容之前读规则,不是动手前才读)」+代码/测试/文档三行时机格各前置「定X方案」段,doc-conventions 文首标题「写文档前必读」改「定文档方案前必读」(2026-10-25 用户裁;起因=架构对齐会话讨论期未读规约拼方案、补读后两处违例撤回——旧触发词只管写、没管住定方案) 2026-10-25 19:11:04 +08:00
DKChan becd300391 fix(格式换代): 换行符归一清偿合并脚本双重转换(三文件曾成 CR CR LF)+§12.1 一处旧措辞改齐(无设计线段的条目须在实况指认证据) 2026-10-25 07:50:49 +08:00
DKChan c550654896 merge master(改动四类与两层模型)+手工合四文件:格式换代与新状态词并轨 2026-10-25 07:44:25 +08:00
DKChan 4e8ff1f0fa docs(格式换代·第一遍): 改动面档序规则成文(按四档表次序)+一处并列倒序改正 2026-10-25 07:32:18 +08:00
DKChan 9093ba0044 wip(格式换代·待 rebase): 待办清单条目格式换代第一遍——删设计面与归属、现状改实况、加改动面四档与可选优先级;闸判据七项+撤销证明十项全红过绿;69 条全面重写 2026-10-25 06:59:02 +08:00
DKChan 9fdacdebeb docs(规则修订): 改动四类+卡片/迭代两层模型落规约(2026-10-25 用户裁定 12 项全执行)——AGENTS「两类批」改「改动四类」(需求改动=唯一走写卡+迭代;工程/文档设计/美术素材=无卡无迭代直改)+五段铁律限定需求改动并补两层口径;process-conventions §2 首句改造+两层口径+工程直入拆分+「低于5不得编」改「任何卡可编入、<5=冻结待凑批」;doc-conventions §12 状态机补待执行与直改类序列、通道表拆需求性/工程性、§12.2 补冻结待凑批与周期新规;test-conventions 头注补测试归属句;术语表术语替换;pipeline_gate 状态词表/状态五形态/周期校验同步(<5 未处冻结态才红);三张违形卡(S9/S13/节点图换代收尾批)删除、结论回写条目、五条目状态改待执行;退役词四处顺带换代。全量域闸绿(回执 full 档,07 doc_link 较基线改善);子代理审计过(四小修已落)。.zcode/.qoder 六技能(iter/iter-plan/req-card/batch-closure/doc-design/asset-ingest)同批换代,不入 git 2026-10-25 06:57:29 +08:00
DKChan c61d00b41a docs(迭代周期规则批): 迭代周期三条线定型——中值精确值不取整/5–10 日常规/超 10 须带日期特批/硬下限 5、硬上限 20(特批不放行)
2026-10-21 用户裁定落地四件:
- process-conventions 四查③改「总估时三条线」(<5 不得编/5–10 直接编/超 10 呈报整批/拆批两案等裁、确认后带日期标记/>20 不得编、确认也不放行)
- doc-conventions §12.2 预计周期列改「≈N 个工作日」中值精确值形态(退役 0.5 步进周形态,1 周=5 工作日)
- roadmap 粒度句换代;迭代 31–35 五行按中值精确值改写(31≈7.5/32≈8.75/33≈13.25/34≈11 归特批/35≈15.25 个工作日)
- pipeline_gate:WEEKS_RE→PERIOD_RE;周期判据改三条线(<5 与 >20 判红、10<x≤20 须带日期特批标记、「—」历史行豁免)

变异验证 8 例(worktree 备份→sed 变异→恢复):25 带标记红(硬上限拦)/4 红(硬下限拦)/15 无标记红/15 带标记绿/20 带标记绿(边界放行)/10 无标记绿(边界不触批)/旧周形态红/标记缺日期红;恢复后全绿
2026-10-21 23:33:27 +08:00
DKChan f958a03f51 docs(research/退役批): design/research 全目录退役落地——中间文档唯一暂存地收敛为 reports/(用户 2026-10-20 令「design/ 只放持久化设计文档,过程件一律出 design/」的执行补完,2026-10-21 会话复述确认)
八件受版文件 git mv 进 reports/(一律先迁不删,删除归后续批或用户点名):提案三件(冒险前资源配比预设/效果引擎无状态化/武器锻造系统)、审计两件(代码术语审计/单测与验收门禁标准测试审计)、美术审计两件(cursor 会话存档 md + canvas 转 HTML 渲染件)、需求澄清-营地交互重做;未入库的 UI预览demo 三路对照件只搬盘不入库。

GDD 落文:锻造工坊.md「满级特效扩展位」节收下七条候选池(长剑破甲/长剑暴击面扩大/长枪先手连击/法杖开局魔法矢/轻甲灵巧/重甲反震/魔法护甲护盾),按现役 EFFECT_KINDS 与 settlement.tres:51/52 逐条复核实现代价分档,效果类型闭集口径取正文现行 31 种、不抄过程稿旧记 24 种;候选池定性为备用清单非承诺清单。

引用面换代 08(playnote 之外两处 ../research/ 改 ../../reports/)、待办清单四处、reports 八张卡片(跨目录前缀改同目录)、art-assets-checklist 与 sim-data/README 两处既存死指改「沿革查 git 提交史」、content-archive 出处句标注该目录已退役。迁入件内部相对链接随迁移重基准(../gdd/ → ../design/gdd/,playnote 与待办清单改回仓库根),并订正上一批遗留错误:两张迭代 30 卡片的 playnote 链接原写 ../../playnote.md(从 reports/ 出发指到仓库外),现改 ../playnote.md。

规则与机检:doc-conventions §11「暂存地非档案库」行改为单暂存地+禁在 design/ 下设过程件目录+图像载体与报告渲染件口径分列(禁图留 artwork/ 沿用 2026-09-27 用户裁;.html/.json 允许作为报告的一种=2026-10-21 用户裁,原「只放 .md」句系 10-17 建目录时顺带照搬、无单独点头记录);AGENTS Project Layout 两行同步;reports/README 补「设计讨论段过程稿」命名行。repo_structure_audit:DESIGN_SUBDIRS 去 research、RETIRED 加 design/research;doc_ref_audit 排除面清空(design 全树入扫描面);doc_term/doc_link 扫描域注释换代;三件样张脚本 OUT_REPORT 改落 reports/ 并补 os.makedirs(改前只对 OUT_PNG 建目录,目录缺失即 FileNotFoundError)。

变异验证:重建 design/research 并放文件 → 结构闸退出码 1、同时报「退役路径再现」与「子目录越界」两条;design/ 内放两条指向不存在文件的引用 → 引用可核机检报「路径不存在」红项 2(该闸暂未注册进闸壳,无基线记录必判变化);清场后结构闸 PASS。
2026-10-21 15:27:16 +08:00
DKChan 224a947559 merge: 分支并入 master(推进 84 提交,2026-10-21)——research/ 治理批按现master重取四处冲突
解冲突取法=master 现文为准、本批新增语义打上去,不照抄分支旧文本:
- doc-conventions §11:活文档清单与「暂存地非档案库」行取本批新增全文(content-archive 退役内容留底/research/ 无常驻例外/跨会话交接文件禁入库/根 playnote 定性),清单称呼按 docmove 批现文写作「待办清单」,「落档必写接收方」「迭代实现报告」两行照收 master 版(旧日期注记不复活)。
- 08-Alpha版本标准:Alpha 出口裁决与营地五卡入 Alpha 的全部现行行照收 master,仅把 playnote 链接按新位置改指 ../../playnote.md。
- tools/repo_structure_audit.py:ROOT_FILES 取 master 全集(含待办清单/体验验证清单两件根文件)后追加 playnote.md。
- design/research/Alpha未完成事项梳理-2026-10-13.md:modify/delete 冲突按删除解——master 侧自分叉只改过两处指路句(f100e192/281d471e),其结论已由 08 v1.11-v1.12 与待办清单承载,吸收判据今日重核成立。

随批补两处 master 前进后暴露的同步面:AGENTS.md Project Layout 根目录段补 playnote.md 一行(白名单收了新根文件而目录说明未跟上);技能层 batch-closure 两份副本(.zcode 原件→整文件覆盖 .qoder)补「research/ 无常驻例外」的候选呈报口径与 playnote 不入退役候选。
2026-10-21 07:18:31 +08:00
DKChan 7aee5eb71a docs(流程文档迁出GDD批): 待办清单与体验验证清单移到仓库根并去掉编号前缀
两文件是流水线流程件而非游戏描述件,此前住在 design/gdd/ 造成三处不适配:
gdd_lint 必须为它们逐条关掉体裁规则、格式权威却写在 doc-conventions §12、
与同族的 roadmap(在仓库根)分居两处。迁到根后按 roadmap.md 的无编号风格改名。

- 迁出:design/gdd/06-待办清单.md → 待办清单.md;07-体验验证清单.md → 体验验证清单.md
- 指向改写 53 个文件:GDD 各系统文档指路存根、四份规约、02 根索引、README/roadmap/AGENTS
- 两份清单自身 74 处出站链接按新基址重指(../art → design/art、systems → design/gdd/systems)
- gdd_lint:待办/体验验证两文件的 R1/R3/R5/R7 豁免行随迁删除(已脱离扫描面),后门表清零
- pipeline_gate 默认路径、log_analysis/render_gate 称谓、repo_structure_audit 根文件白名单同步
- 保护面补写:两份清单列入实现批禁写清单(AGENTS 两类批条 / process-conventions §12 / 架构文档域表),
  条目状态只由流水线各段推进
- 范围外未动(用户令「全不碰」):reports/ 与 design/research/ 的 22 处历史指向、game/ 两处注释
2026-10-21 00:09:40 +08:00
DKChan 811f988032 rules(规则审阅落地批): 十条评审意见落地——呈报四问/文件头缩窄/禁词表冻结/lean死条文退役/日期批注清除/AGENTS瘦身/分域闸口径/状态栏纯化
- AGENTS.md: 呈报六问改读后自检四问;文件头红线删行数上限与白名单;日期批注清除;回执五况细则挪 process-conventions §3.10;流水线闸过时状态句改事实句
- process-conventions: §1.2 非迭代批改按改动域跑闸;§3.10 承接五况;两处日期批注清除;§2 表格凭据落点改现状清单
- code-conventions: §1.4.1 重写(删 8 行上限/两类白名单/90 文件清偿义务);§2.1 联动;两处日期批注清除
- test-conventions: 三处日期批注清除(三处实证日期属证据保留)
- doc-conventions: §1 lean 死条文删除;§4 词表冻结条款;§12.1 重写(状态行只写状态词;现状=关联文档清单;删括号凭据全部条款);三处日期批注清除;§5 重复词修复
- 术语表: 用语规范节加词表冻结句
- 06-待办清单: 11 条带括号状态行迁移(括号证据移入现状关联文档清单;待裁决说明并入现状;每条状态行只留状态词)
- tools/audit_file_headers.py: 删 R1 行数上限(R0 载体/R2 日期/R3 变更叙事保留)
- tools/gdd_lint.py: R2 表格占比判据与 R2_EXEMPT 整体退役(lean 解读对象已亡,只产存量噪音)
- tools/doc_term_audit.py: 词表冻结注释
- tools/pipeline_gate.py: 状态栏括号凭据核对废止,新增状态行禁括号判据(点名病因短路);闭合证据改现状正文核对(卡片路径磁盘存在性+交叉核、文档路径+版本、art-bible+版本)
- game/tests/static_scan.sh: S10 注释同步

变异验证(test-conventions §6):pipeline_gate 注入括号→状态行含括号内容红 exit1;删正文卡片路径→正文缺卡片路径+交叉核红 exit1;audit_file_headers 注入变更叙事→R2/R3 红 exit1、头注 12 行纯说明→0 红(上限停用实证)。坑册新增:未提交工作区禁 git checkout 变异还原(会连带回滚在途改动),须备份文件法。

全批净变化 +155/−146(12 文件)。
2026-10-20 23:15:05 +08:00
DKChan 31fe87d122 docs(research/治理批): 暂存地职责收口——§11 立「research/ 无常驻例外」+卡片死期=实现批合回 master+跨会话交接文件禁入库+根 playnote 定性用户随手记;道具退役素材库迁 design/content-archive/ 转正活文档(3 处 GDD 引用同步);playnote.md 挪仓库根(引用面 6 处+ROOT_FILES 白名单);research/ 清 6 件(会话交接四件+读数 dump+Alpha梳理已吸收件,H11 指路改结论内联);熵增闸 DESIGN_SUBDIRS/ROOT_FILES 白名单同批改;技能层旧卡片路径 7 处在主区就地修(harness 配置不入 git) 2026-10-20 07:34:46 +08:00
DKChan 8a68c9ea11 merge: 同步 master e92a18e1(卡片落位 reports/+dev→engineering 改名批)——四处版本历史节冲突取本批删除侧,reports 卡片重放禁写变更记录清理,06b 闸扫描面扩 reports/ 2026-10-20 05:46:28 +08:00
DKChan f19d893a08 merge: 同步 master 71b88e3b(卡片落位迁 reports/ 批)——AGENTS.md Project Layout 冲突取双方意图(engineering 行+卡片批新版 research 行),顺带修除 master AGENTS.md 误入库存的未解决冲突标记(上批闸不扫 AGENTS.md 致漏网) 2026-10-20 05:37:36 +08:00
DKChan f406002766 docs(dev目录正名·engineering): design/dev 更名 design/engineering——名实对齐(目录实存=架构+五规约+引擎参考的工程知识域)
- git mv 15 件本体;13 个引用文件 34 处路径同步+熵增闸 DESIGN_SUBDIRS 白名单同批改判
- 白名单漏改时熵增闸当场真红(子目录越界拦截能力实录验证),同步后全绿
- game/tests 三件套注释按用户特别授权批后主区直改(不入本批);reports/research 暂存档按吸收即死原则不改
- 文档域闸全绿:gdd_lint/doc_link/doc_term/流水线闸/熵增闸
2026-10-20 05:33:34 +08:00