mirror of
https://github.com/eternity4719/HowToLiveBetter.git
synced 2026-11-20 08:40:44 +08:00
写作规则补上句子层面的硬标准:一句一件事、30 字上下、说人话 120 字内、备注有争议仍要以「争议」开头
This commit is contained in:
@@ -41,6 +41,13 @@
|
||||
- 标题行下紧跟一行 HTML 注释 `<!-- 成本标签: 钱=0|少|多 时间=少|中|多 毅力=否|些|是 收益=大|中|小 口径=死亡率|金钱|时间|自由 -->`,GitHub 渲染不可见,供 index.html 在线检索按成本维度筛选;新增或改动条目时同步维护。含义:钱 0=不花钱或省钱、少=几十到几百元或每月几十元内、多=上千元或长期显著支出;时间 少=一次几分钟内或顺手、中=一次性数小时或每周小时级、多=每天持续占用;毅力 否=做一次就完、些=改一个习惯或忍一点不适、是=长期对抗惯性
|
||||
- 「说人话」是把「收益」栏的统计量翻成日常说法的一到两句:HR/RR/OR 一律换算成「高约几成 / 低约百分之几」,人群和研究设计不写,只留读者关心的方向和量级;不许出现 HR、RR、OR、CI、队列、荟萃这些词,也不许出现「收益」栏里没有的数字。**不能新增的不只是数字**:收益栏没写的症状、事实断言、机制解读一样不许加(2026-09-19 用户抓出两处——献血条写「『脸色差、怕冷』不是瞎编」,可「脸色差」全条目没有任何来源提过;冷水澡条把「病假次数少了但总天数没变」解读成「病了也照样去上班」,原研究没这么说。两处都已改)。**说人话还必须自足**:读者多半只看这一行,不看来源也不看核实记录,所以不能引一句他没见过的说法再去评价它——「『XX』不是瞎编」「『XX』是真的」这类写法直接禁掉,要么把那个说法连同出处在这一行里交代清楚,要么改成正面陈述(献血那句最后改成「反过来,献得太勤确实会让人没力气、怕冷,机制是铁」)。写「说人话」时不要顺手去改「收益」栏。金钱与自由口径的条目同样写,翻成「能拿回多少钱 / 会摊上什么后果」。检索页把它渲染成卡片里最显眼的一段,缺这一行就不显示,可以逐节补。
|
||||
- **全书一律写成没受过专业训练的成年人能一遍读懂的中文**(2026-09-20 用户定:「我有点看不懂,通俗点」「不然门槛太高了」)。覆盖条目标题、成本、说人话、收益、备注,以及 docs/ 下的长文;**来源栏除外**,文献题录和条款号照原样留着才能核对。做法:专业名词当场用日常话解释一句、名词本身保留(「辅料,也就是有效成分之外的填充和包衣」);研究行话翻成动作(「观察性队列」→「只是跟踪记录、没有分组对照」);法言法语落到「会摊上什么后果、该怎么做」。**收益栏的数字、置信区间、人群与年份说明一个都不许删改**,HR/RR/OR 在旁边就地补「低约 28%」这类换算并保留原值——这一栏是全书可核对性的底座,只加译文、不动原值。**条目标题只许加字解释,不许删字换词**:别节的引用靠标题里的词做锚点匹配(tools/check-refs.mjs 取任意两个连续汉字比对),删一个词就可能让那处引用从「带锚点」退化成裸条号。
|
||||
- **句子层面的硬标准**(2026-09-21 用户定:「有些人说是 AI 生成的垃圾看不懂」「改成尽量通俗、简单,单看一整句不需要看其他地方引用、不需要任何额外思考就能明白」,并点名要照顾读得慢、逐字逐句看的老年人和残障读者)。当天按这套标准把全书 552 条和四篇长文逐条改了一遍,句子平均长度从 66 字降到 29 字,超过 70 字的句子从 1385 句降到 64 句(剩下的全是不可拆的法条引文和英文文献题录)。以后新增和修改条目照这个标准写:
|
||||
- **一句话只说一件事**,句子控制在 30 字上下,最长不超过 50 字。原来用分号并列的一律改成一句一个句号,破折号尽量不用。
|
||||
- **每句有明确主语**(你、医生、警察、公司、法院),少用被动句和「其」「该」「之」「予以」「系」。书面语换口语:及→和,若→如果,应当→要(来源栏不动),自……之日起→从……那天算起。
|
||||
- **括号套括号一律拆开**,括号里超过十个字的补充拿出来单独成句;术语解释要短,写「95% CI 0.50–0.63(可信范围)」而不是整句解释,同一条里同一个术语只解释一次。
|
||||
- **每句话要能单独读懂**:交叉引用前面那句必须把意思说完,引用只是「想细看去哪」。
|
||||
- **说人话 2 到 4 句、120 字以内**,只留方向和量级,其余留在收益栏。
|
||||
- **备注里有争议的仍必须以「争议」开头**:sync-stats.ps1 按「备注行以争议开头」计数,把争议挪到备注中段,README 的争议条数就会掉(2026-09-21 通俗化时有 9 条这么掉过,已改回)。
|
||||
- 收益与口径是后加的两个字段,用来回答「值不值得做」(证据等级只回答「数字可不可信」,两者正交)。口径按这条主要换回什么定:死亡率(含健康终点、存活率)、金钱(含保障待遇)、时间(含精力)、自由(含法律责任、个人信息)。**不同口径之间不做比较**。
|
||||
- 收益量级尽量按阈值从条目自己的「收益」栏机械套,不凭感觉:死亡率口径看相对降幅(≥20% 大 / 10–20% 中 / <10% 或只有替代终点 小);金钱看金额(万元级 大 / 数百到数千 中 / 几十元 小);自由看后果(避免刑责 大 / 避免拘留或行政处罚 中 / 避免民事纠纷 小);时间看节省量(每天小时级 大 / 每周小时级 中 / 一次性 小)。数字不足以判定时才用判断,并在核实记录里写明凭什么定的。
|
||||
- 条目数、A 级条数变了要同步四处:README(正文数字与两个徽章)、index.html(五处描述、numberOfPages、页头条目数)、CLAUDE.md 的目录简介,以及 **tools/og.html + 重新截图 og.png**(命令写在 og.html 文件头注释里,链接数的口径是 book/ 下所有「- 来源:」和「- 备注:」行里的 http(s) 总数)。跑 `powershell -ExecutionPolicy Bypass -File tools\sync-stats.ps1` 一键完成:它重算条目数、A/B/C 数、争议数、TODO 数、链接数和性价比三档,回写 README 的八处、index.html 的三类位置、tools/og.html 的三个数字,再用全新的 user-data-dir 重出 og.png(`-NoScreenshot` 可只改数字)。**CLAUDE.md 的目录简介脚本不碰,仍要手工改。**性价比档的规则和 index.html 的 COST_W、e.ratio 两行绑定,那两行改了脚本会直接报错要求同步。**每次改完条目就跑一次,和正文改动一起提交**(2026-09-18 用户定;当天早些时候的「等我说改完了再改」已作废——脚本把一次同步的开销压到几百 token,不必再攒着)。跑完不用打开 og.png:脚本自己校验图是本次写入、大小在 120KB 到 400KB,只有改过 tools/og.html 版式时才值得看一眼。汇报里也不必再写「待同步」,直接给同步后的数字。
|
||||
|
||||
Reference in New Issue
Block a user