feat: gate writer sections on a % teach: block (SP025)

Rewrite references/pedagogy.md around recite-vs-teach: reader model,
coverage density (sections_in is cite permission, not a to-do list),
intuition-before-formula three-beat, and paper-jump filling.

Every notes/sections/sec-*.tex must now answer gap / takeaway / jump /
omit above the first \section. lint.py checks presence only (it cannot
judge honesty); files opening with "% generated by" are exempt.

- scripts/lint.py: SP025 + is_writer_section / teach_gaps helpers
- tests/no-teach-block/: fixture with takeaway only, wired into test.sh
- examples/*: all 14 writer sections get real teach blocks
- SKILL.md, references/{agents,antipatterns,checklist}.md, DESIGN.md,
  assets/notes-template.tex: route writers and consistency agent
  through pedagogy.md
This commit is contained in:
dela
2026-09-17 10:06:54 +08:00
parent 49842c5153
commit 5170111823
26 changed files with 373 additions and 16 deletions
@@ -1,2 +1,7 @@
% teach:
% gap: 见过 $1/\sqrt{d_k}$,但不知道它是装饰性常数还是一次必须看见的改写
% takeaway: 这一节要判断的是「这步改写值不值得画出来」
% jump: none
% omit: 摘录之外的全文结构
\section{这篇论文在问什么}
注意力里的 $1/\sqrt{d_k}$ 是装饰,还是一次必须看见的改写?
@@ -1,3 +1,8 @@
% teach:
% gap: 知道要除 $\sqrt{d_k}$,但看不见方差是从哪一步冒出来的
% takeaway: 缩放来自点积方差随 $d_k$ 增长,是改写不是新算子
% jump: fixture 直接给出结论,没展开方差那一步
% omit: 其他归一化方案的对比
\section{主张与贡献}
\splabel{C1}
点积方差随 $d_k$ 涨。除掉 $\sqrt{d_k}$ 是改写,不是新算子。
@@ -1,2 +1,7 @@
% teach:
% gap: 不知道什么时候该出 superderive 图、什么时候 align 就够
% takeaway: $\le 4$ 步且没有消项或代入要看见时,留在 align
% jump: none
% omit: superderive 的完整语法(见子仓库 SKILL.md)
\section{总结与延伸}
四步以内、没有消项或代入要画出来时,仍然用 \texttt{align}。