---
name: x-made-easy-skill
description: 仿 Silvanus Thompson《Calculus Made Easy》(1910) 的教学精神，写作或修订一本"轻松学"小书：先除恐，再用白话、贴身例子和渐进练习教会读者。也用于把外部教材融入已有小书，并校对正文和插图文字。产出分章 Markdown（00 目录＋分章＋99 结语附录），附自检脚本，可合成 PDF。当用户说"轻松学""Made Easy 风格""仿《微积分入门》/《Calculus Made Easy》写本书""用这种风格教我 X""把 X 写成一本入门小书""x-made-easy"，或用英文说 "X Made Easy" 时使用。不要用于普通问答、单篇文章或非教学性写作。
---

# X Made Easy（"轻松学"系列书写作技能）

把用户指定的任意主题（奥数、某软件、某理论、某门手艺……）写成一本仿汤普森《Calculus Made Easy》风格的教学书：完整骨架、分章 Markdown、可合成 PDF。适合把一门看似吓人的知识，整理成一本可逐章推进的"轻松学"小书。

## 铁律（最重要，先读这三条）

1. **是"驱除恐惧"，不是写教科书。** 全书第一目的是把读者从对术语、符号、"我没天赋"的恐惧里解救出来。先除恐，再讲规矩。
2. **事实核查，绝不捏造。** 例题与事实必须真实、正确，凡数值都要验算；真实经典内容标"经典/民间/经典题型"，自己编的标"自编"——**绝不给例题安假的"某年某竞赛/某文献"出处**。有参考资料时忠实转述其事实，不替它编数字或日期。核不了的，标【待核】，不猜。**简化可以，说错不行**：抄了近路就记账，账在附录里结（见 `references/style-guide.md` 第六节）。
3. **守用户级写作约束。** 中文；不堆排比；不用感叹号；不说"总的来说"；不说"显然""易知""不难看出"——这是汤普森骂的那种书的口头禅；不用官方陈词滥调与模糊措辞；用比喻要新鲜；浅白易明。用户用别的语言提问时，跟着用户的语言写，规矩照旧。

## 工作流

- **第 1 步　摸清读者怕什么。** 动笔前弄清三件事：读者是谁（现在会什么）；读者怕什么（列出 5–10 个最吓人的术语、符号或场面，这张"恐惧清单"就是第 1 章的原料）；学完能亲手做成哪件事（贯穿例子的终点）。用户没说的，先合理假设，写进 `00` 的"关于这本书"，供用户核对。用户给了参考资料（PDF/网页/书），先读懂，以它为事实来源，不臆造。
- **第 2 步　先出骨架。** 新书先写 `00-目录与体例.md`：书名（仿 "X Made Easy" → "X轻松学"）、四部式结构、每章一个"除恐"主旨、难度标注约定、出处标注规矩。篇幅按主题定：小册子 6–9 章，标准本 12–20 章，别为凑数加章。可用样章及早检验风格和深浅；用户已要求完整成书时，继续完成已授权的写作，不为等待中途确认而停下。
- **第 3 步　逐章写或修订。** 新章按下面的"五段式"讲清一个概念，讲完就用，用熟再走下一章。修订已有书稿时沿用原书骨架，不因外部教材另起一套目录。每写完或改完一章，跑一次自检：`python3 scripts/check_book.py 书文件夹`（路径相对本 skill 目录）。报"错"的改掉再往下写；报"提醒"的逐条看，有理由就留着。
- **第 4 步　写 `99-结语与附录.md`。** 包含：练法/用法、术语小词典、一页纸速查、各章工具速查、练习答案、"我们抄过的近路"（每处简化说清：省了什么、严格版在哪）、出处与难度说明（落实铁律 2）。可加一节"给行家的话"，学汤普森的尾声：先认下行家会嫌它不严谨，再说为什么这样写。
- **第 5 步　逐字校对并核对交付版本。** 自检脚本只查部分体例和禁词，查不出病句、动作矛盾或图文不符。通读正文、练习和答案；有图时连同图中文字、图注及替代文字一起核对。若有纯文字版、网页或下载文件，确认各版内容一致。细则见 [外部教材融合与校对](references/source-integration-and-copyedit.md)。
- **第 6 步（可选）合成 PDF。** 一条命令：`scripts/build_pdf.sh 书文件夹 书名`（网页路线，要 pandoc 和 Chrome/Chromium/Edge）。要 LaTeX 精排，或者脚本出了问题，看 `references/pdf-build.md`，那里有两条路线的完整命令和踩过的坑。

## 修订已有小书时

用户给了教材、截图或论文，要求补进已有书稿时，先读 [外部教材融合与校对](references/source-integration-and-copyedit.md)。提取能帮助读者跨过具体难处的知识、练习和图意，放进原书合适的章节；不要按资料页序拼贴，也不要把易学的练习压缩成一句口令。保留原书的读者定位、章节骨架和用户要求的交付形式。

## 每章五段式（雷打不动）

1. **开篇除恐**：先点破这一章让人怕的东西，承诺这一章替读者卸掉它。第 1 章可以直说"让你怕的不是难，是它穿的那身西装"；之后每章换一个切口。别拿序号开篇（"第三件工具是……"），那是在报目录，不是在除恐。
2. **白话化**：每个术语先给一个脑子里能看见的画面（比喻/日常类比），再讲规矩。
3. **直觉先行**：先用小孩也懂的办法或小情形切入，再上严格证明/定义。说清此刻哪些细节可以先不管，什么时候才要管。
4. **例子贴身**：两个以上，标难度（☼ 热身 / ☼☼ 正经 / ☼☼☼ 硬骨头）；真题标出处，自编标"自编"；教"怎么想到的"，不只给答案。章末留 2–4 道练习，答案统一放附录，汤普森原书就是这样。
5. **收尾**：列"**这一章要带走的东西**"要点，最后单独一句"**就这样。**"

## 风格 DNA 与目录模板

汤普森原书的几句原话（据 1914 年第二版逐字核对）、开篇句式、"可以不管"的写法、比喻纪律、抄近路记账、章名写法、难度符号、四部式目录模板，详见 `references/style-guide.md`。写每一章前先扫一眼它。

## 产物落地

- 每本书一个独立文件夹（如 `~/X轻松学/`）。
- 文件命名：`00-目录与体例.md`、`01-章名.md` … `99-结语与附录.md`；**两位数字前缀保证排序正确**（10–16 排在 01–09 之后、99 之前）。自检和合成 PDF 都只认这种文件名，别的 `.md` 会被跳过。
- 贯穿全书用一个真实、贴近读者的例子，跨数章逐步搭起来（如奥数书的"七件工具"逐件登场；Git 书把一个真实小项目从第一次提交带到第一次合并）。

## 例子

用户说："用《Calculus Made Easy》这种风格写一本教我做 X 的书。"
你应当：弄清读者、恐惧清单和学完要做成的事（必要的假设写明）→ 读懂 X 的素材 → 写 `00-目录与体例` → 逐章按五段式写，每章跑自检 → 写结语附录（含练习答案、近路账、出处说明）→ 逐字校对 → 按用户要求交付，需要时合成 PDF。
结果：一本结构完整、风格统一、事实可靠、可出 PDF 的"X轻松学"。