Files
superpaper/README.md
T
dela 3a322aa8dc 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.
2026-08-17 10:01:30 +08:00

1.9 KiB

SuperPaper

母仓库:把一篇论文编成带 ledger 的中文讲义,并把图路由到独立的子仓库。

子仓库各自保有自己的 git 历史、lint 和不变量。母仓库只编排,不往任何一个 .sty 里塞笔记宏。

superpaper/                 this repo (orchestration)
├── DESIGN.md               family spec
├── SKILL.md                document-layer skill
├── superfig/               submodule — architecture / pipeline / flow
├── supertensor/            submodule — tensor faces / axes / shards
└── superderive/            later — stepwise rewrite figures
子仓库 画什么 远程
superfig 节点、边、分组、机制框图 carrydela/SuperFig
supertensor 形状对齐的张量公式图 carrydela/SuperTensor
superderive 逐步代数改写图 尚未建

Clone

git clone --recurse-submodules \
  ssh://git@ssh.gitea.mygoband.com:2222/carrydela/SuperPaper.git
# 已有工作副本:
git submodule update --init --recursive

Each child is also a standalone skill. Point an agent at superfig/ or supertensor/ when you only need that figure grammar. Point at this directory when the job is 读论文 / 脉络 / 推导 / 出图路由.

Layout on disk

Under /home/carry/myprj/tools/skills/ the old sibling paths are symlinks into this repo:

skills/superpaper/           SuperPaper
skills/superfig           -> superpaper/superfig
skills/supertensor        -> superpaper/supertensor

Status

v1 notes scaffold is in this repo: ledger schema, router, lint, ingest, and three --work examples (excerpt-toy, pipeline-delegate, tensor-delegate). superderive is still phase 2.

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
./scripts/preflight.sh
./scripts/test.sh
./scripts/build.sh --work examples/excerpt-toy