Community생산성 & 협업github.com

book-plugin — 蒸馏 → 出图 → 审计 → 放行/回炉

完整的知识蒸馏闭环工作流:将一本书/长视频/播客蒸馏为可执行技能(生成),绘制 SVG 示意图(出图),然后进行逐字原文回溯审计与四闸门状态判断(审计),仅当全部通过后才编译交付。

回炉란 무엇인가요?

book-plugin 是一个全流程知识蒸馏与质量保证工具链,专门用于将书籍、长视频或播客等长篇内容转化为可复用的 AI 技能(Skill)。它遵循“蒸馏 → 出图 → 审计 → 放行/回炉”的闭环,确保每个技能产物不仅内容准确,而且引用可追溯、可视化一致、质量可控。 该插件集成三个上游模块(cangjie-skill 蒸馏方法论、svg-diagram 出图房规、dsh-distillation-director 审计判定),在本地运行,零 API 成本。工作流分为四个阶段: 1. 使用 cangjie 方法从原文中提取、验证并生成能力卡片; 2. 根据能力类型,按预设房规手绘 SVG 示意图; 3. 通过桥接脚本逐字比对原文与技能引用,并运行四道闸门(证据包完整性、G-66 池覆盖、G-67 锚一致性、G-68 证据闭包)进行审计; 4. 依据审计状态(全绿/红灯)决定是放行编译还是定向回炉修正。 平台支持:Mac/Linux(Python ≥3.10,需 Node.js 用于 SVG lint)。典型使用场景包括用户要求“拆书”、“蒸馏一本书”、“把这本书做成 skill”、“蒸馏后审计”、“audit the distilled skills”等。注意:本插件不用于简单摘要、读后感或作者角色扮演。

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cloudxy/book-plugin/tree/HEAD/skills/book-workflow

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

标题

문서

book-workflow — 蒸馏 → 出图 → 审计 → 放行/回炉

路径约定(先读这个)

  • 插件根(= 仓库根) = 本 SKILL.md 所在目录的上两级(skills/book-workflow/ 的 ../../),记作 $PLUGIN。
  • 工作区 = 用户当前打开的项目根(cwd),记作 $WS。蒸馏产物(books/、.work/、tools/、.dsh/)全部落在 $WS。
  • 桥接/审计脚本不在工作区内,调用时必须带 --ws $WS,否则找不到工作区根。
  • 原则:先审计后编译——阶段 5 的 compile 只对判态全绿的 Bundle 做。
cangjie 蒸馏(阶段0-4) → svg 出图(按需) → 桥接(逐字回源) → 四闸审计 → 全绿 compile 交付
        ▲                                                        │
        └────────────────── 回炉(按判态映射) ◀── 红 ────────────┘

第 0 步 — 工作区自举(每个工作区一次,幂等)

python3 $PLUGIN/scripts/bootstrap.py $WS

它建 $WS/.venv(Python ≥3.10 + PyYAML + PyMuPDF)、装入 dsh 闸门套装($WS/tools/ 与 $WS/.dsh/),并体检 node(图件闸的 svg-lint 依赖,缺失时该闸判"不适用")。之后的命令统一用 $WS/.venv/bin/python(下文记作 $PY)。

阶段一 — cangjie 蒸馏(生成侧)

先确认输入:原书文本(PDF/EPUB/TXT/转写稿路径,没有文本就停下来向用户要,不凭记忆拆书)、书名+作者+出版年、使用目的(学习查阅→single;接入日常/跨书组合→pack)。

然后完整阅读 $PLUGIN/vendor/cangjie-skill/SKILL.md 并严格按它执行(RIA-TV++ 五阶段:Adler 整书理解 → 5 路并行提取 → 三重验证 → 晋级门 → RIA++ 能力卡 → Zettelkasten → 压力测试)。本工作流要求:

  • 产物落在 $WS/books/<slug>/(含 verified.md、candidates/、rejected/、.cangjie/capabilities/);
  • 跑到阶段 4(压力测试)之后、阶段 5(编译交付)之前停下,先进入本工作流的出图与审计;
  • 保留全部审计轨迹,断点续跑状态(PIPELINE_STATE.md)每阶段更新。

阶段 1.5 — 出图(svg-diagram,按需)

框架/流程/计算类能力卡或 DIGEST 需要配图时,先读 $PLUGIN/vendor/svg-diagram/SKILL.md 的房规再手绘 SVG(CJK 字体栈、五组语义配色、盒高=字号×3、盒间距≥25px、C/Q 曲线连线、一次画对)。落位:

场景位置引用方式
能力卡配图$WS/books/<slug>/.cangjie/capabilities/resources/<cap-slug>.svg卡片正文写资源名 + Bundle 该能力 resources: 声明
DIGEST/OVERVIEW 配图$WS/books/<slug>/assets/<名>.svg![标题](assets/<名>.svg) 相对路径

自查(error 必须清零):

node $PLUGIN/vendor/svg-diagram/tools/svg-lint/bin/svg-lint.mjs <图.svg>

阶段二 — 桥接(逐字回源核验)

$PY $PLUGIN/bridge/cangjie_to_dsh.py --book-dir $WS/books/<slug> --source <原书.txt|.md|.pdf> --task <slug> --ws $WS

它把原文落成 $WS/.work/<task>/book_text.md(PDF 自动抽取——审计锚定对象永远是原始书文),解析每张能力卡 R 段引文并去空白逐字比对,铸稳定池 id(CJ-NNN)生成 dsh 格式池与技能审计副本。任何引文对不上 ⇒ rc=1 红牌,回阶段一修 R 层。

阶段三 — 四闸审计(判态)

$PY $PLUGIN/bridge/run_audit.py --task <slug> --ws $WS

依次跑:证据包构建件 → G-66 池覆盖 → G-67 锚一致 → G-68 证据闭包 → 图件闸(svg 引用完整 + svg-lint 合规)。判态追加到 $WS/.work/<task>/audit-verdict.md(审计时间线)。

阶段四 — 放行或回炉

判态去向
全绿放行 → $PY $PLUGIN/vendor/cangjie-skill/scripts/cangjie.py compile --bundle $WS/books/<slug>/.cangjie/capabilities --out <用户确认的安装目标> --output auto
桥接回源红 / G-67 红回 cangjie 阶段 2(R 层引文/日期锚修正),重跑桥接
G-66 红(精选未落 R 层)回 cangjie 阶段 1/1.5(补采候选/复核淘汰),重跑桥接
G-68 红(闭包/漂移)先重跑审计入口;仍红查阶段 3/4 的 id 映射
图件闸红按房规修图或补引用,重跑审计入口

回炉是常态不是失败——带着闸门给出的具体失败项(哪条引文、哪个 id、哪张图)定向修,不要整册重做。

判据口径(谁在查什么)

  • 回源:引文去空白后必须是原文逐字子串——防"引了但原文没有"。
  • G-66:critical/high 能力(桥接打"总纲"标记)的引文必须落在某卡 R 层——防重要单元被静默漏掉。
  • G-67:同行"日期×引文"必须在原文 400 字窗口共现——防张冠李戴的时间锚。
  • G-68:技能引用的每个池 id 有 sha256 闭包且池不漂移——防"引了找不到原文/池改包未重建"。
  • 图件闸:引用的 svg 必须存在、所有 svg 过 lint error=0——防断链与烂图。

质量红线

  1. 没有原文不蒸馏;引文 ≤150 字/段(英文 ≤100 词)。
  2. 合成演练不得冒充书中案例;A1 无原书案例时如实标注。
  3. 审计全绿前不 compile、不安装。
  4. 淘汰项(rejected/)保留理由;重要缺口如实登记,不虚报零遗漏。
  5. 图与正文一致——数据变了图必须跟着变;与正文矛盾的图比没图更糟。
  6. 版权合规由使用者按原书授权判断;本工作流只保证"准则可执行、引文可核验"。

生态位

  • cangjie-skill(随包于 $PLUGIN/vendor/):蒸馏方法论与流程的权威定义。
  • dsh-distillation-director(同上):三闸判态的权威实现,本地脚本零 API 成本。
  • svg-diagram(同上):出图房规与 lint。
  • 本技能只做编排与判态收口;上游规范以三个 vendor 的 SKILL.md/README 为准,冲突时以 vendor 原文为准并在此登记偏差。

관련 스킬