From 631b1dfe99cd983548a5207f3c00ff6039b51610 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 4 Oct 2026 06:56:08 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=B0=E8=B4=A6=E5=8E=BB=E5=8E=8B=E7=BC=A9?= =?UTF-8?q?=EF=BC=9A=E5=BA=9F=E9=99=A4active.md=E6=AF=8F=E6=9D=A1=E2=89=A4?= =?UTF-8?q?3=E8=A1=8C=E7=BA=A6=E6=9D=9F=EF=BC=882026-10-04=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E7=AB=8B=E8=A7=84=E3=80=8C=E8=83=BD=E7=9C=8B=E6=87=82?= =?UTF-8?q?=E6=AF=94=E5=AD=97=E6=95=B0=E5=B0=91=E6=9B=B4=E9=87=8D=E8=A6=81?= =?UTF-8?q?=E3=80=8D=E2=80=94=E2=80=94doc-conventions=20=C2=A710=E6=94=B9?= =?UTF-8?q?=E7=99=BD=E8=AF=9D=E5=8F=A5=E5=AD=90=E5=8F=A3=E5=BE=84+?= =?UTF-8?q?=E7=AC=AC4=E8=8A=82=E9=BB=91=E8=AF=9D=E7=A6=81=E4=BB=A4?= =?UTF-8?q?=E5=AF=B9=E5=8F=B0=E8=B4=A6=E5=90=8C=E7=AD=89=E7=94=9F=E6=95=88?= =?UTF-8?q?+v10=E7=89=88=E6=9C=AC=E5=8E=86=E5=8F=B2=EF=BC=9BCLAUDE.md?= =?UTF-8?q?=E4=BC=9A=E8=AF=9D=E8=BF=9B=E5=BA=A6=E8=AE=B0=E5=BD=95=E8=A1=8C?= =?UTF-8?q?=E5=90=8C=E6=AD=A5=EF=BC=9B=E8=B5=B7=E5=9B=A0=3D=E9=BB=91?= =?UTF-8?q?=E8=AF=9D=E5=AE=A1=E8=AE=A1=E8=AF=81=E5=AE=9E=E2=89=A43?= =?UTF-8?q?=E8=A1=8C=E5=8E=8B=E7=BC=A9=E5=8E=8B=E5=8A=9B=E7=B3=BB=E8=87=AA?= =?UTF-8?q?=E9=80=A0=E7=BC=A9=E7=95=A5=E8=AF=AD=E7=B9=81=E6=AE=96=E5=9C=B0?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 2 +- design/dev/doc-conventions.md | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 197fe073..1b7e60e7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -52,7 +52,7 @@ | 架构与决策记录 | `design/dev/architecture/architecture.md` + 同目录 `adr-*.md` | | 引擎版本与参考 | `design/dev/engine-reference/godot/`(版本表已在上方 @ 引入) | | 术语、已锁数值 | `design/registry/entities.yaml`——仅 owner 文档可修订,冲突须显式提出 | -| 会话进度记录 | 根目录 `active.md`——顶部「当前状态快照」节 + 批次台账;收口先改快照再记账,每条 ≤3 行,详情外链 | +| 会话进度记录 | 根目录 `active.md`——顶部「当前状态快照」节 + 批次台账;收口先改快照再记账;条目用完整白话句子写清结论,能看懂比短重要(2026-10-04 用户立规),详情归正主文档 | | 工程路线图 | 根目录 `roadmap.md`——里程碑时间线与下一步顺序(批级视图;实时状态看快照节) | ## 分支纪律(worktree 铁律,2026-09-19 用户立规) diff --git a/design/dev/doc-conventions.md b/design/dev/doc-conventions.md index 13edc98d..03478ac2 100644 --- a/design/dev/doc-conventions.md +++ b/design/dev/doc-conventions.md @@ -150,7 +150,7 @@ ## 10. 会话记录纪律 -根目录 `active.md`(会话快照+批次台账)每条进度 ≤3 行(粗体键 + 短句);详情一律外链到对应文档或报告,禁止把定稿摘要、义务清单整段塞进条目。台账条目记裁决结论本身,不记中间文档文件指针(见第 11 节)。 +根目录 `active.md`(会话快照+批次台账)每条进度用完整的白话句子写清结论本身;条目写多长以读者能看懂为准,不设行数上限(2026-10-04 用户立规:能看懂比字数少更重要,原「每条 ≤3 行」约束废除——该约束曾迫使台账压缩成只有作者自己懂的自造缩略语,是文档黑话的繁殖地)。仍然禁止的只有两件:把定稿摘要、义务清单整段搬进条目(详情归各正主文档,台账只记结论);以及自造黑话——第 4 节用语纪律对台账同等生效。台账条目记裁决结论本身,不记中间文档文件指针(见第 11 节)。 ## 11. 文档生命周期:吸收即死(2026-10-01 用户立规) @@ -184,3 +184,4 @@ | v7 | 2026-09-16 | 06 清单改版(用户拍板):「待拍板」术语全仓改「待办」,清单更名 `design/gdd/06-待办清单.md`;清单内格式由四列表格改为「循环 → 系统 → 条目(四级标题)+ 粗体属性段(现状 / 归属 / 状态)」,条目解决后状态改"已解决(日期)"留痕;第 6 节顶层文档表与骨架表、第 8 节「待办单点登记」同步改指 | | v8 | 2026-09-30 | **概念落位与口径携带条款(微光口径事故后补成,用户拍板)**:第 7 节概念封装纪律增「落位五要素」行(定义/作用对象与范围/生命周期/关联/状态缺一不立)与「无正主,不下定义」段(概念未落正主前,任何文档不得替它下定义,只许 06 登记「待落位」);第 8 节「引用不转述」行扩口径携带纪律(作用对象/范围/生命周期随句写全或显式指路,禁裸形容词复述) | | v9 | 2026-10-02 | **文档生命周期条款(2026-10-01 用户立规「吸收即死」落文)**:新增第 11 节——中间文档寿命=迭代寿命,结论吸收进正主即删、未决先迁再死、永不入库、引用面口径、台账记结论不记指针、sim-data 白名单、迭代出口清理项、design/research 与 design/qa 为暂存地非档案库;第 10 节补台账记结论口径;文首地位/适用范围两处过期路径修正(`docs/`→`design/dev/`、`production/` 会话记录→根 `active.md`) | +| v10 | 2026-10-04 | **台账去压缩条款(用户立规)**:第 10 节废除「每条 ≤3 行」——能看懂比字数少更重要;条目改用完整白话句子写结论,长度服从可读性;第 4 节黑话禁令对台账同等生效。起因:2026-10-04 黑话审计证实 ≤3 行压缩压力迫使台账条目使用自造缩略语(收口/落籍/在飞等约 15 个流程动词、530 条自造短语),并渗入正式文档;CLAUDE.md 规范导航表「会话进度记录」行同步改写 |