feat: land superpaper v1 notes scaffold

Add the ledger schema, class router, lint codes, ingest/build
pipeline, and three work-tree examples: align derivation,
superfig delegation, and supertensor delegation.
This commit is contained in:
dela
2026-08-17 10:01:30 +08:00
parent c2bec6f55a
commit 3a322aa8dc
89 changed files with 3522 additions and 11 deletions
+11 -8
View File
@@ -17,8 +17,8 @@ description: >-
`ledger.yaml` + 结构化中文笔记。图一律委派给子仓库,不要在笔记里
`\usepackage{superfig}` / `supertensor`。
本目录是家族母仓库。子仓库在 `superfig/` 与 `supertensor/`(git submodule)。
完整合同见 `DESIGN.md`。笔记脚手架(`scripts/`、模板、schema)按 DESIGN 的 PR 1 落地;在此之前按下面路由手工委派。
本目录是家族母仓库。子仓库在 `superfig/` 与 `supertensor/`。
契约细节按需加载 `references/`;schema 在 `assets/ledger.schema.yaml`。
## When to use
@@ -43,12 +43,15 @@ video.
## Workflow
1. 读 `DESIGN.md` 的输入契约与 ledger schema。
2. 先写 `ledger.yaml`(claims / symbols / derivations / figure plan),再写笔记。
3. 公式三拍:中文动机 → `\[` / `align` → 扁平符号表。
4. 每张计划图写一份自包含 `F*.request.md`,开一个 figure agent,**只**把对应子仓库的 `SKILL.md` 给它。
5. 笔记用 PDF `\includegraphics` 嵌入子仓库产物。禁止 `\input` standalone 源。
6. 改术语或改图:先改 ledger,再改那一处。
1. `./scripts/preflight.sh`。0 = 全路径,1 = 降级(说出口),2 = 无 LaTeX。
2. `./scripts/ingest.sh --work <dir> …`(`references/input.md`)。
3. 从 `assets/ledger.example.yaml` 写 `ledger.yaml`,再写 `outline.md`,再写正文。
4. 公式三拍:中文动机 → `\[` / `align` → 扁平符号表(`references/pedagogy.md`)。
5. 按 `references/router.md` 填 figure plan。每张重绘图一份 `F*.request.md`,figure agent 只读它和对应子仓库 `SKILL.md`。
6. `./scripts/lint.py --work <dir>` 然后 `./scripts/build.sh --work <dir>`。
7. 改术语或改图:先改 ledger,再改那一处。
Worked trees: `examples/excerpt-toy/`(`align` 推导)、`examples/pipeline-delegate/`、`examples/tensor-delegate/`。
## Spawn recipe