grimoirelisted

# Grimoire · 魔典 — Document → Notes + Skill Pack > One source, parsed once, woven into typed reading notes (→ Obsidian) and a > per-source skill pack. Primary entry point: `scripts/grimoire.sh`. > Full product overview and bilingual docs: see [README.md](README.md). > > The sections below are the underlying MinerU parsing API reference that the > `grimoire` toolchain is built on. ### Flow: Markdown first, the grimoire is opt-in · 先转 MD,魔典是可选续跑 The pipeline is **gated**, not automatic: 1. **Always first → Markdown.** A source becomes Markdown via `pdf2md` / `mineru-local` (or any MinerU parse). For many requests this is the whole job — **stop here**. Do not auto-run notes/skill mining. 2. **Opt-in → the grimoire.** Only when the user actually wants reading notes and/or a packaged skill, continue **from that Markdown** with `grimoire.sh --from-markdown <md>`. Nothing is re-uploaded; the parse is skipped. `--only notes|skills|both` is the second opt-in: notes only, the skill (engineering-prompt) packaging only, or both. 3. **`--only both` is two-stage, not parallel.** Stage 1 writes the type-specific notes from the source. Stage 2 is a deliberate **re-learning pass (重复学习)**: the agent re-reads the notes it just wrote and mines the skill pack **from those notes' knowledge points**, not the raw source (`source-markdown/` is then only for evidence anchors). `--only skills` (no notes) keeps mining from the source. > 默认只到 MD;笔记 / 把内容封装成 skill 工程提示