docs(conventions): 用语纪律落正面总则「见名知意,所见即所得」(2026-10-10 用户立规)
正文三处:§4 标题补八字总则;开篇新增正面总则段(见名知意管名字、所见即所得管句子,注明管语义透明不与第 8 节指路存根冲突);版本历史 v16 行。随批:active.md 状态记录 437 号。
This commit is contained in:
1 parent
c50eef7053
commit
933e1a9421
2 files changed
+5
-1
No files matched your search
@@ -73,3 +73,4 @@
|
||||
434. **秘宝文档 grilling 审查轮——八问八答全落文(2026-10-10,用户令「审查核验清除灰色地带+不合理设计呈报」;一轮八问+二轮七问,主会话直执;master 67b36de)**:①发现并落裁九项=同调位上限矛盾(基础 3+第四只手突破至 4)/槽位判定源三源冲突(裁归天赋树同调位节点 1/2/3=普通/优秀/稀有格递增——用户澄清其心智=树管槽位,与现役谓词表实装走偏即已建未接面本质)/解锁方式换代混合制(基础件钥石购买+特定件条件解锁〔游玩里程碑/行为谓词〕,旧档位谓词分级作废——用户裁原解锁条件不符预想)/换装券与「中途不可自主换装」冲突(用户澄清语义=自主换装禁止、效果类更换不受限→换装券=自主换装唯一渠道显式例外)/刷新两账语义定案(用户复述:一持久一呈现重置先扣临时;X/Y 字母仅字段名,对表归实装批 T0——06 倒置条随裁)/分界尺精确化(属性值=角色战斗属性值不含经济属性,用户澄清;操作包络正向列举落头部+01 分界节 01 v1.5)/中立移除去待定标注(自作聪明提「重生」被斥,素材库件同规)/速览旧目录三段退役清理(历次批「只加标注不清内容」保守策略被纠正——被覆盖的旧内容该删)/解锁条件表=同调增长表改造。②fact 纠正=「谓词表」解释给用户(条件→发放对照表非新造词)/「五维度框架」解释(2026-10-09 用户拍板在册非自造,用途=内容自查防盲区)。③剩余前沿=五维度标签对 15 件的适用(推荐保留自查+info 豁免解除待用户一句)+Q12 逐件分配(钥石/条件哪件哪样——归实装批需求卡片不阻塞)。
|
||||
435. **秘宝.md 系统目录归位批——自排雷循环迁入跨局循环(2026-10-10,用户发现工程结构问题三连问「放哪/该放哪/生命周期在哪」;master be1cf39)**:①**问题定性与成因**:秘宝.md 原置 systems/排雷循环/系历史遗留——前身「辅助道具」为切片期掉落消耗品(纯局内)故旧置排雷循环,2026-10-03 同调换代(局外同调件)只换内容未搬位置;生命周期裁定=解锁(秘宝匣柜台+解锁条件表)/装配(营地)/存档持久全在跨局侧,排雷循环仅生效现场——归位 systems/跨局循环/(与元进度/天赋树/生涯/武器锻造同区)。②**执行**:git mv(rename 96%)+文内同目录四引用改跨目录路径+全仓反向引用 33 处同步(版本历史表行/registry 注记行内历史路径按纪律保留 3 处)+02-系统清单 v1.19(文档树两区换行/总表 AUXILIARY_ITEMS 行移区/命名对照表不动)+秘宝.md v2.1 移动注记。③背景:本批系 grilling 审查轮延续——用户以结构问题打断,落位后回到剩余前沿 Q13 五维度标签(推荐保留自查+info 豁免解除,待用户一句)。
|
||||
436. **秘宝.md 正文换代批(方案甲)+损坏提交修复(2026-10-10,用户裁方案甲「旧的删、误标改」回应「新旧并存=讨论白费」质询;master 04c9423)**:①**方案甲落地**:定位与形态节压缩(沿革一句话,删过渡形态长段/中立移除规格段〔规格迁素材库 blast_kit 行〕/衔接纪律/事故留痕);五维度框架去「在役旧实现」错标改写(信息=线香/天眼/巢穴预告、风险=线香/天眼、行动=晨操令/双管装填/试炼镐,规划/反制豁免维持——此为事实陈述,逐件标注与 Q13 标签裁定的正式化随实装批);使用编排/叠加层/边缘零信息三节去⚠(机制为新目录沿用+诚实句「新目录实装批落地前现役代码按同框架运行」)+举例换新件;调参表清理(删旧六行句/投放态注记/预读预警行;订阅行段去件名举例——效果引擎机制在役沿用);验收护栏/覆盖检查两条换代;旧目录处置小节删。**秘宝.md 现 250 行纯新理念文档**(此前旧内容约占 25% 真旧+25% 误标通用机制)。②**事故与修复在案**:中间提交 deb1a80 系 python 行切片脚本写坏的损坏版(1711 行碎裂,脚本在 CRLF 文件上用 split/nl 混合操作致区间错位)——发现于 diff 行数异常(1709 插入);修复=git checkout be1cf39 恢复完好版+改用 Write 全文重写(不再用切片脚本)→04c9423;教训=大段节级替换禁用行切片脚本,一律全文重写。③**待办延续**:奇物.md 同法换代批待执行(用户方案甲含「奇物.md 同法随批」——老 27 件框架与新 18 件框架并存同构问题);Q13 五维度标签实质裁定(标签保留=重写版已按事实陈述写承载件,正式逐件标注随实装批,用户一句确认即可闭树)。
|
||||
437. **用语纪律正面总则落文批——「见名知意,所见即所得」(2026-10-10,用户令「作为文档编写规范加进用词纪律,先查冲突、可行即改」;worktree docnorm-creed,主会话直执,纯文档零测试)**:①**冲突检查=零冲突,且系现行做法成文化**:§4 用语纪律既有条目全是否定面(禁自造黑话/三形态禁令/通行检验标准),八字总则是其正面表述;§6 目录命名早有「见名知意」,本批升为全节总则;并行会话 c50eef7「谓词」清除批的提交信息就以「见名知意」为裁决理由,证明这是用户在役的裁词尺。②**落文三处(doc-conventions.md v16)**:§4 标题补八字(见名知意 · 所见即所得 · 禁自造黑话,全仓无旧标题「禁自造黑话」字样引用,改题安全)+开篇新增正面总则段(见名知意管名字——概念名/术语/文档与目录名本身说清所指,起不出这样的名字多半是概念没想清;所见即所得管句子——读到的字面意思就是规则的完整意思,有隐含前提就写进句子;并注明两句管语义透明、不是要求信息全内联,该指路仍按第 8 节指路,防误读)+版本历史 v16 行。③**范围边界**:CLAUDE.md「用语红线」行已指向 §4 无需改;本尺向后生效,不追溯既有已裁名称(如 X/Y 仅字段名系用户明裁)。④流程=worktree docnorm-creed 基点 c50eef7 自治提交合入;期间并行会话活跃(master 4ce5f0f→c50eef7),合入前重验 master。
|
||||
@@ -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「谓词」清除批自述「见名知意」),本批把现行做法成文 |
|
||||
Reference in new issue
Block a user