读书成技 jlsupero/To-Know-What-You-Read

读懂你所读

把一本书读成可复用的 skill：先读懂概要与他人体会，再用苏格拉底式提问锁定你的真实需求，把核心概念提炼成「概念-例子」并泛化为可用模型，最终生成一个以书名命名的 skill。

把一本书变成可复用的 skill：掌握其概要与他人见解，通过苏格拉底式提问锁定你的真实需求，将核心概念提炼为「概念-例子」对并泛化为模型，最终生成一个以书名命名的 skill。

目录结构 / Directory Structure

cn/skills/to-know-what-you-read/ # 中文版技能 en/skills/to-know-what-you-read/ # English version DSH_plugs/cn/ # 中文版 Harness 插件 DSH_plugs/en/ # English Harness plugin

核心流程 / Workflow

严格按序，禁止跳过/合并/增删。严格按序；禁止跳过、合并、增删步骤。

| # | 中文 | English |
| 0 | 初始化：识别模型，载入对应 _output_format.md，脑科学家+skill专家常驻 | Initialize: detect the model, load the matching _output_format.md, keep the persona active |
| 1 | 总结概要 | Summarize |
| 2 | 他人体会：搜读后感/书评，找异同 | Others' takes: find common & different points |
| 3 | 苏格拉底式提问：像甲方反复追问，直到喊停 | Socratic questioning: repeat until the user says stop |
| 4 | 概念-例子 → 泛化模型 → 写 README | Concept-example → generalize → README |
| 5 | 历史评价与自进化（评价之前的 skill，更新 SKILL.md） | History review & self-evolution (rate prior skills, update SKILL.md) |
| 6 | 生成 英文名_skill/ | Generate _skill/ |

人格 / Personas

- 脑科学家 / Brain Scientist：提取概念、串联泛化为可用模型、苏格拉底式提问。提取概念，将其串联并泛化为可用模型，提出苏格拉底式问题。
- SKILL 制作专家 / Skill Author Expert：把模型转成可执行 skill 流程与文件。将模型转化为可执行的 skill 流程与文件。

模型格式文件 / Model Format Files

references/ 内置 19 个主流模型的 _output_format.md，按各模型的输出特点把它定义为「脑科学家 + SKILL 制作专家」子人格，防止换模型后生成的 skill 结构漂移。

references/ 内置 19 个 _output_format.md 文件，每个文件将主流模型调校为「脑科学家 + skill 制作专家」人格，使生成的 skill 在不同模型间保持一致。

支持 / Supported：Claude、Claude Sonnet 5、Codex Auto Review、DeepSeek、Doubao、ERNIE、Gemini、GLM、GPT、GPT-5.5、Grok 4.6、Hunyuan、Llama、MiniMax、Mistral、Moonshot、Qwen、Seedance、Yi。

提取脚本 / Extract Script

scripts/extract_text.py 从常见文档格式提取纯文本，并对电子书按章节拆解。

从常见文档格式中提取纯文本；按章节拆解电子书。

python3 extract_text.py 书.epub --split # 按章节拆解（epub/fb2）/ split by chapter
python3 extract_text.py 书.pdf # 纯文本 / plain text

支持 / Supported：.txt .md .markdown .pdf .docx .epub .fb2。

Harness 插件 / Harness Plugin

DSH_plugs/ 提供 DeepSeek Harness 的 Host 插件，注册动态模型工具 to-know-what-you-read：读取书籍内容、联网搜他人体会，返回六步流程与素材，供模型继续完成制 skill。

DSH_plugs/ 提供 DeepSeek Harness 的 Host 插件，注册动态工具 to-know-what-you-read，用于读取书籍内容、搜索他人见解，并返回六步流程与素材，供模型继续制作 skill。

使用方法 / Usage

1. 按当前模型语言选择 cn/ 或 en/ 版本。根据语言选择 cn/ 或 en/。
2. 将对应 SKILL.md 作为技能加载；或把 DSH_plugs/ 下的 Host 插件通过 cordis_define 载入。将 SKILL.md 作为技能加载，或通过 cordis_define 载入 DSH_plugs/ 下的 Host 插件。
3. 对目标书执行六步流程，输出落盘在 output/英文名/。执行六步流程；输出落盘在 output//。

输出约定 / Output Convention

- 输出目录固定 output/英文名/。输出目录固定为 output//。
- 概念必须写成「概念-例子」，能串联的必须串联。概念必须写成「概念-例子」；能串联的必须串联。
- 最终 skill 命名固定 英文名_skill。最终 skill 命名固定为 _skill。