帮我读这个 PDF，写读书笔记并提炼 skill
把这本书炼成魔典
解析这篇论文，落进 Obsidian
这个文档帮我写笔记
从这本书里提炼 skill

高分差（score ≥ 5, margin ≥ 3）  →  confidence: high   → 直接推进
中分差（score ≥ 3, margin ≥ 2）  →  confidence: medium  → 直接推进
低分差                           →  confidence: low    → 生成 AI_CLASSIFY.md

./grimoires/<slug>/
│
├── GRIMOIRE.md              # 统一状态面板：类型、页数、vault 目标、边界声明
├── GRIMOIRE.md.json         # 机器可读版本（schema: grimoire.workspace.v1）
├── GRIMOIRE_TASK.md         # Agent 合同（两段式：阶段1 笔记 → 阶段2 从笔记挖技能）
├── README.md                # 人类可读摘要
│
├── source/                  # 原始文件（PDF/DOC/PPT）或 source_url.txt
│
├── mineru/                  # MinerU 解析产物（仅此一份，两半共享）
│   ├── parse_manifest.json  # 解析清单（含 extract_dir、page_count）
│   └── <extracted .md ...>  # MinerU 输出的 Markdown
│
├── notes/                   # 阅读笔记包（reading-notes-pack.sh 产出）
│   ├── manifest.json        # 类型、置信度、vault_target、llm_invoked: false
│   ├── classification.json  # 详细分类信号
│   ├── AI_CLASSIFY.md       # 仅在 confidence: low 时生成
│   ├── AI_READING_TASK.md   # 笔记阅读合同（entry point for notes half）
│   ├── OBSIDIAN_PLAN.md     # vault 落地路径 + 行文规范
│   ├── source-markdown/     # 复制过来的 MinerU Markdown
│   ├── segments/            # 章/节分段（book/document；paper 不分段）
│   │   ├── manifest.json
│   │   └── 001-<chapter>.md
│   └── notes/<slug>.md      # 笔记模板（来自对应类型的 template）
│
└── skills/                  # 技能包（source-skill-pack.sh 产出）
    ├── manifest.json        # schema: mineru.longform-skill-pack.v2
    ├── LLM_EXTRACTION_PROMPT.md
    ├── BOOK_SKILL_INDEX.md
    ├── MANAGE_SKILLS.md     # 晋升边界与 skills-mgr 使用说明
    ├── MINDMAP.md
    ├── SKILL_DISCOVERY_COVERAGE.md
    ├── source-markdown/
    ├── segments/
    │   ├── manifest.json
    │   └── 001-<chapter>.md
    ├── chapter-skills/
    │   └── 001-<chapter>/
    │       ├── CHAPTER_SKILL_INDEX.md
    │       └── skills/
    │           └── _skill-template.md
    ├── whole-book/
    │   └── WHOLE_BOOK_SUMMARY.md
    └── skills/              # 仅存放已审查的跨段候选 skill
        ├── README.md
        └── _skill-template.md

PDF / DOC / URL
      │
      ▼  grimoire.sh —— MinerU 解析（一次）
      │
      ├──► reading-notes-pack.sh  ──► notes/  （笔记脚手架）
      │
      └──► source-skill-pack.sh  ──► skills/ （技能脚手架）
                                              │
                              ┌───────────────┤ 全部交给 Agent
                              │  GRIMOIRE_TASK.md（单一合同）
                              ▼
                     Agent 逐段阅读（一 pass，两件事）
                     ┌─────────────────────────┐
                     │  Step 1+2: 写笔记         │  → notes/<slug>.md
                     │  Step 1+2: 挖掘技能候选  │  → chapter-skills/*/skills/
                     │  Step 3:   whole-book 合并│  → whole-book/WHOLE_BOOK_SUMMARY.md
                     │  Step 4:   笔记写入 vault │  → Obsidian vault
                     └─────────────────────────┘

本地文件上传云端 = 数据离开你的机器
Local file upload = data leaves your machine

Usage: grimoire.sh <url_or_file> [options]

  --title <title>    源标题（默认取文件名/URL basename）
  --slug <slug>      workspace + vault note 的 slug
  --type <type>      auto（默认）| book | paper | document
  --only <what>      both（默认）| notes | skills
  --model <m>        vlm（默认）| pipeline | MinerU-HTML
  --ocr              启用 OCR
  --pages <range>    页面范围，如 "1-50,80-120"
  --agent <name>     阅读 Agent 名称（写入合同文件）
  --vault <path>     Obsidian vault 根目录
  --output <dir>     输出根目录（默认 ./grimoires）
  --from-markdown <p>  跳过 MinerU，从已转好的 Markdown 文件/目录续跑
  --from-text <p|->    跳过 MinerU，原始文本/标准输入当源（配 --only skills 即文本→技能）
  --cloud-ok         确认本地文件上传到云端
  --install          产出后追加跨 agent 安装步骤到合同（显式可选，记入 manifest）
  --force            覆盖已存在的 grimoire

grimoire-skill/
├── scripts/
│   ├── forge.sh                 # ★ 一条命令入口：书/视频/文本 自动路由 → grimoire
│   ├── grimoire.sh              # 主管线：解析 → 笔记包 + 技能包 → 统一合同
│   ├── reading-notes-pack.sh    # 笔记管线：分类 + 分段 + 脚手架
│   ├── source-skill-pack.sh     # 技能管线：分段 + 提炼工作区
│   ├── mineru-parse.sh          # MinerU 云端解析 CLI 封装
│   ├── kedou-bili-subs.sh       # B站 单视频 Kedou 字幕下载（OpenCLI，--dry-run）
│   ├── kedou-bili-manifest.sh   # B站 空间→videos.jsonl（OpenCLI 网络捕获）
│   ├── kedou-bili-batch.sh      # B站 空间批量：可续跑、限额感知、progress.jsonl
│   ├── skill-install.sh         # 跨 agent 安装产出技能（显式 opt-in，记 manifest）
│   ├── skill-manage.sh          # 管理：scan/doctor/status/list/sync/uninstall/gate
│   ├── mineru-to-notes.sh / mineru-source-to-skill.sh  # 解析+笔记/技能（独立模式）
│   ├── vivo-workspace.sh / vivo-note-template.sh        # Vivo 多源 agent workspace
│   ├── book-skill-pack.sh · mineru-book-to-skill.sh · vivo-agent-workspace.sh
│   │                             #   ⚠️ 已弃用 compat wrapper（仍转发，将移除）
│   └── lib/
│       ├── common.sh            # 通用工具（slugify/require_cmd/ensure_fresh_dir…）
│       ├── reading-types.sh     # 阅读类型分类器（book/paper/document）
│       ├── source-types.sh      # 11 类来源类型分类器（技能包用）
│       ├── segment.sh           # 共享 Markdown 分段器（笔记+技能共用）
│       ├── agent-targets.sh     # 跨 agent 拓扑（copy/symlink、漂移备份、逐包）
│       └── kedou-progress.sh    # B站批量 progress.jsonl 助手（记录/计数/续跑）
├── skills/                      # 内置来源/管理技能（见「内置来源技能」）
│   ├── mineru-local/ · mineru/  # PDF/DOC/PPT/img → Markdown（本地+云）
│   ├── kedou-media-workflow/    # 网页视频/字幕解析（含 B站→笔记 recipe）
│   ├── youtube-clipper/         # YouTube 下载+字幕+分章
│   └── grimoire-manage/         # 跨 agent 安装/管理的配套技能
├── templates/
│   ├── reading-notes/{book,paper,document}-notes.md
│   ├── subtitle-note-template.md   # 字幕笔记固定模板（agent 填，脚本不写 vault）
│   └── vivo/…
├── docs/                        # reading-notes / vivo / skill-manager 参考
├── examples/                    # 旗舰 + 单步示例
├── tests/run.sh + Makefile      # `make test` 离线测试套件（全绿，零网络/零 token）
├── SKILL.md                     # Skill 元数据、API 参考、触发词
├── CHANGELOG.md · CONTRIBUTING.md · LICENSE