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
8 lines
347 B
TeX
8 lines
347 B
TeX
% teach:
|
|
% gap: 见过 $1/\sqrt{d_k}$,但不知道它是装饰性常数还是一次必须看见的改写
|
|
% takeaway: 这一节要判断的是「这步改写值不值得画出来」
|
|
% jump: none
|
|
% omit: 摘录之外的全文结构
|
|
\section{这篇论文在问什么}
|
|
注意力里的 $1/\sqrt{d_k}$ 是装饰,还是一次必须看见的改写?
|