mirror of
https://github.com/eternity4719/HowToLiveBetter.git
synced 2026-11-20 08:40:44 +08:00
CLAUDE.md 写明去 AI 腔的六种写法和保真改法(issue #42,规则取自 shuorenhua)
This commit is contained in:
@@ -49,6 +49,21 @@
|
||||
- **每句话要能单独读懂**:交叉引用前面那句必须把意思说完,引用只是「想细看去哪」。
|
||||
- **说人话 2 到 4 句、120 字以内**,只留方向和量级,其余留在收益栏。不写样本量、分组和研究设计(「257 例」「那组」「随机」),不写「另一头」「产出」这类要读者自己翻译的比喻。`node tools/check-plain.mjs` 机器查这三样,CI 里是「说人话检查」job,sync-stats.ps1 末尾也会跑(2026-09-28 issue #42 读者嫌 AI 味重,当天查出 173 条不合格,全部改掉)。它查不出的是电报体:句句十来个字、一句一个句号,读着像念提纲。有因果、转折的两句可以用「因为」「所以」「但」连成一句,结尾别加总结升华句。
|
||||
- **备注里有争议的仍必须以「争议」开头**:sync-stats.ps1 按「备注行以争议开头」计数,把争议挪到备注中段,README 的争议条数就会掉(2026-09-21 通俗化时有 9 条这么掉过,已改回)。
|
||||
- **别写出 AI 腔**(2026-09-28 issue #42:读者说全书「AI 味太重」「读起来蛋疼」,当天改了全书成本、收益、备注、节首引言和长文)。下面几种是本书实际出现过的:
|
||||
- **元叙述**:「这条只解决一件事」「这条不劝你去或不去」「这条算的是……不是钱」。
|
||||
- **段尾升华句**:「从报名那一刻起,这个决定就反悔不了了」「免签不等于免责」。
|
||||
- **连用「也就是」**:一段里连着用好几次。改写前全书有 306 处。
|
||||
- **要读者自己翻译的比喻**:「那一侧」「另一头」「产出」「换了张皮」「挡箭牌」。
|
||||
- **电报体**:一个列举拆成一串碎句,一句一个句号。
|
||||
- **空转加强词**:「值得注意的是」「本质上」。
|
||||
- **改法以保真为先**,规则取自读者推荐的 skill shuorenhua(github.com/MrGeDiao/shuorenhua,SKILL.md 和 references/editing-guide.md):
|
||||
- **否定、范围、条件、立场、主次判断都是内容,不是包装**。「这条不是禁止划线」「不主张谁都该离开夜班岗位」这类句子,只去掉「这条」「本条」的自指,限定本身必须留下。当天第一轮把这类句子当元叙述删了,事后逐句核对 199 句,放回了 23 句。
|
||||
- **段尾句在下结论、定主次、说该怎么做的,留下意思,只删修辞**。只有和前文完整重复的才删。
|
||||
- **法条原文后面紧跟的白话翻译要保留**,读者靠它看懂法条。
|
||||
- **别拿公文腔去换 AI 腔**:不写「一是……二是……」「即」「意思是」「具体而言」。能删的「也就是」直接删,删不掉的换成「比如」或十字以内的括号短注。
|
||||
- **不许把意思说得更具体或更绝对**,拿不准就保留原句。
|
||||
- **句式本身不是错**,不按命中次数替换。「不是 X,而是 Y」在排除一种误读时就是内容。
|
||||
- **有因果、转折关系的相邻短句用「因为」「所以」「但」连起来**,单句仍不超过 50 字。
|
||||
- 收益与口径是后加的两个字段,用来回答「值不值得做」(证据等级只回答「数字可不可信」,两者正交)。口径按这条主要换回什么定:死亡率(含健康终点、存活率)、金钱(含保障待遇)、时间(含精力)、自由(含法律责任、个人信息)。**不同口径之间不做比较**。
|
||||
- 收益量级尽量按阈值从条目自己的「收益」栏机械套,不凭感觉:死亡率口径看相对降幅(≥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