docs(conventions): 用语纪律落正面总则「见名知意,所见即所得」(2026-10-10 用户立规)

正文三处:§4 标题补八字总则;开篇新增正面总则段(见名知意管名字、所见即所得管句子,注明管语义透明不与第 8 节指路存根冲突);版本历史 v16 行。随批:active.md 状态记录 437 号。
This commit is contained in:
DKChan committed 2026-10-10 18:33:48 +08:00
1 parent c50eef7053
commit 933e1a9421
2 files changed
+5 -1

No files matched your search

+4 -1
View File
@@ -47,7 +47,9 @@
**规则两段式**:核心规则先写"人话阶段"(作用于哪个系统、什么情况下、谁触发、触发后发生什么),再写"举证阶段"(逐效果给出计算方法或公式;纯流程规则明写"无计算")。规则名禁止纯名词短语(反面例:"获取路由")。
## 4. 用语纪律(禁自造黑话)
## 4. 用语纪律(见名知意 · 所见即所得 · 禁自造黑话)
**正面总则(2026-10-10 用户立规):见名知意,所见即所得。** 见名知意——用到的每个名字(概念名、术语、文档与目录名)本身就说清它指什么,读者看到名字、不用等解释就知道大概;起不出这样的名字,多半是概念还没想清,先想清再落笔。所见即所得——读者读到的字面意思就是规则的完整意思,不需要追问作者、翻查项目历史或脑补隐含前提才能还原真实含义;有隐含前提就写进句子,有言外之意就写成正文。这两句管的是把话说明白,不是要求把所有信息都塞进本文——该指路的地方仍按第 8 节指路。本节其余禁令说哪些写法不行,这两句说行的是什么。
文档、评审输出、日志与一切沟通中**禁止自造黑话**——比喻性生造词、只有作者自己懂的缩略语(历史反例:"非雾腿""双闸")。
@@ -205,3 +207,4 @@
| v13 | 2026-10-09 | §11 新增「证据只留最新」行(2026-10-09 用户立规——qa 存量清理批随批落文):测试证据只保留最新迭代/最新一轮审计版本,新证据落位即删上一份;待人清单过闸后同规退役 |
| v14 | 2026-10-09 | §1「与旧体系门禁的关系」段与现实对齐(文档正确性审查批·独立复核)——原文「gdd_lint 门禁已停用、现行文档不跑 lint」与现状矛盾:gdd_lint 现为机检三闸之一(与 doc_link_audit/doc_term_audit 并列,分级周期口径见 CLAUDE.md,2026-10-03 起分域批在役);lean 六条硬规则本身维持停用仅用于解读旧档;「可读性是第一内容质量门」定位不变,lint 定性为格式机检面 |
| v15 | 2026-10-10 | **迭代实现报告条款(2026-10-10 用户立规三段开发流程随批)**:§11 新增「迭代实现报告」行——实现批收口出迭代级一份实现报告(各卡状态/代拍板追认单/GDD 反哺点节),属中间文档,反哺点未决先迁 06、裁决落文后按「证据只留最新」退役,替代原每卡出口报告;「证据只留最新」行措辞同步换代。配套:GDD/art-bible 等设计正主文档实现批内一律不更新(文档更新必须经用户同意),反哺点经用户裁决另批落文——总规见 CLAUDE.md「三段开发流程」节与批次工作流第 12 条 v2 |
| v16 | 2026-10-10 | **用语纪律正面总则(2026-10-10 用户立规)**:§4 落「见名知意,所见即所得」——见名知意管名字(概念名/术语/文档与目录名本身说清所指,读者看到名字不用等解释就知道大概),所见即所得管句子(字面意思=规则的完整意思,有隐含前提就写进句子),并注明两句管语义透明、不与第 8 节指路存根冲突;§4 标题同步补八字总则。背景:用户已在用此尺裁用词(c50eef7「谓词」清除批自述「见名知意」),本批把现行做法成文 |