HowToLiveBetter

• 7 字段固定 schema：成本 / 说人话 / 收益 / 证据等级 / 来源 / 备注，全部 markdown 一等公民
• 「说人话」层：把 HR/RR/OR 机械翻译成日常语言，不许引入收益栏没有的数字——机器可查（CI 有专门 job）
• 隐藏成本标签：标题下嵌 HTML 注释 <!-- 钱=少 时间=少 毅力=否 收益=中 口径=死亡率 -->，GitHub 渲染不可见，检索页按它筛选
• 备注以「争议」开头是硬约定：统计脚本按行首计数，有反方证据的条目必须把反方写出来

左例为 README 公开示例原文。这种「数据即正文、正文即数据」的双层设计，是全书所有工具的地基。

// 取自仓库 index.html，检索页实时执行
const COST_W = { money:{'0':0,'少':1,'多':2},
                 time:{'少':0,'中':1,'多':2},
                 will:{'否':0,'些':1,'是':2} };
e.cs = COST_W.money[e.money] + COST_W.time[e.time] + COST_W.will[e.will];
e.ratio = e.level === '大' ? (e.cs === 0 ? ''极高'' : (e.cs <= 2 ? ''高'' : ''一般''))
        : e.level === '中' ? (e.cs === 0 ? ''高'' : ''一般'') : ''一般'';

收益量级按阈值机械套（死亡率降 ≥20% 为大 / 万元级为大 / 避刑责为大），不凭感觉；档位不写进正文，检索页按标签实时合成。

• 两把正交的尺子：证据等级回答「数字可不可信」，性价比回答「值不值得做」——A 级也可能性价比「一般」（带状疱疹疫苗：效力 97.2% 的三期 RCT，但两针三四千、很少致命），C 级也可能「极高」（出境前把行程发给家人：零成本防人身风险）
• 四种口径互不折算：「总死亡率降 12%」和「每年省 500 元」不在一把尺子上，各排各的
• 收益落在谁身上分四档：自己 → 配偶直系 → 朋友同事 → 陌生人，不同档不合并计算，帮陌生人要把被讹风险一起写

作者明说：性价比档是自己的判断，按书自己的标准只算 C 级。「一般」不等于不该做，只是花销得你自己掂量。

全书 533 处「见第 8 节第 17 条」只记条号不记内容。中间插一条，后面条号集体顺延，引用却留在原地——而顺延后的条号通常仍在范围内，越界检查抓不到。第 7 节曾有 6 处指错：医疗救助指到低保、救助站指错条。

• 防线一：锚点强制——每处引用必须带和目标标题对得上的词（连续 3 汉字或分句内 2 汉字），裸条号、相对指路（「见下一条」）一律 CI 失败。实测把引用整体顺延一条能当场拦下约七成
• 防线二：引用对照表——check-refs 把每处引用实际指向的条目标题写进 docs/引用对照.md 入库；判据一句话：条号没变而「指向的条目」那列变了，就是被撞歪的引用
• 战果：裸条号 75 → 0，还顺带揪出 4 处早就指错的引用（HPV 疫苗条指到乳腺癌筛查、两条互指的运动条）

这个设计哲学贯穿全书工程：不追求一次写对，追求错了一定向你报警。单靠人眼盯 669 条 × 533 处引用，可靠性是幻觉；把「错的形状」定义出来交给机器，才是可维护的。

• 分工明确：AI 查文献、逐条核对数字与原文一致、维护交叉引用和构建脚本；选题、取舍、最终审定归作者。README 徽章明示「Claude Code 协助编写」
• CLAUDE.md 是活文档：50KB 规则，每条都带日期、起因、判据——「备注链接 ≤1 个」「法条与条目引用的判据是紧挨着有没有引文标记」，全是踩坑后定下的负空间
• 可读性指标化：为照顾逐字阅读的老年读者，全书一遍改写——句子平均长度 66 → 29 字，超 70 字的句子 1385 → 64 句（剩的全是法条引文）

仓库自带一个双平台 skill（Claude Code / Codex 共用同一份 SKILL.md）。装上后问「朋友让我替他担保，签不签」，AI 会先从 book/ 把相关条目整条捞出来，按书的性价比+证据等级排序回答，每条注明第几节第几条。查不到就说查不到，不许凭记忆编数字、补 DOI、补条款号。

• 第 0 步急症拦截：检测到心脏骤停/自杀念头/正在进行的法律程序，先给 120/12356/指律师，再谈性价比——安全设计先于功能
• 规则不复制，当场读源：SKILL.md 里不留会跟着正文漂的清单；节目录去读 README，性价比算法要 grep index.html 抠出 COST_W 和 e.ratio 当场照算——单一数据源原则贯彻到 AI 消费侧
• 取数降级路径：本地仓库 → 浅克隆（1.3MB 几秒）→ 按文件 curl，全失败就如实说取不到

# 装到任何目录（Claude Code）
mkdir -p ~/.claude/skills/life-decision-guide
curl -fsSL -o ~/.claude/skills/life-decision-guide/SKILL.md \
  https://raw.githubusercontent.com/eternity4719/\
HowToLiveBetter/main/skills/life-decision-guide/SKILL.md

# 回答结构（SKILL.md 第 5 步规定）
1. 一句话结论
2. 先做这几条（3-7 条，按性价比排序）
   # 每条：动作 + 花掉什么 + 换回什么
   # + 证据等级 +「第 8 节第 17 条（借条和担保）」
3. 别做 / 不用做的
4. 书里没写的（如实说）

AGENTS.md 双入口：改书的人读 CLAUDE.md，用书回答的人走 SKILL.md——仓库根目录第一屏就把这两条路分开。