# book-a4add8d6-bs

Adopt this skill: https://proskills.md/skills/other/bookleme-bookleme-examples-coach

Page: https://proskills.md/skills/other/bookleme-bookleme-examples-coach
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: examples/coach/SKILL.md
size: 4167
sha: b6e454afd9a93670bb92405b6738d3bcab4fed52
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/SKILL.md

````text
---
name: book-a4add8d6-bs
description: 当人生设计、自我对话、迷茫、重新定义问题时使用。基于《人生设计练习册（合成）》的结构化衍生框架，把作者的方法编译成可执行流程；不含原文段落，书中未涉及的问题会明确说明。
---

# 人生设计练习册（合成）·自我对话教练

## 核心定位

本技能把《人生设计练习册（合成）》中可复用的方法编译成「自我对话教练」流程，供你在真实问题里反复调用。它是结构化衍生笔记，不含原书段落，也不是原书替代品。适用于 人生设计, 自我对话, 迷茫, 重新定义问题 等场景；不适用于书中未覆盖的问题，以及需要专业资质判断的心理、医疗、法律、投资场景。

---

## 触发场景

- 当用户说「人生设计」或提出相关问题时
- 当用户说「自我对话」或提出相关问题时
- 当用户说「迷茫」或提出相关问题时
- 当用户说「重新定义问题」或提出相关问题时

---

## 工作流

### Step 1：确认适用条件

检查用户请求是否落在触发场景内，并确认书中确实覆盖该问题。若数据或用户陈述不足，先追问，不用假设填充。

### Step 2：定位框架

读取 `references/topic-index.md` 找到对应分片；按状态机推进：每轮只问一题，读完回答后先做简短反馈再进入下一题。

### Step 3：按框架执行

按分片中的 1-2-3 步骤执行，并保留作者的精确命名；每条判断都要带上处。

### Step 4：产出具名结果并声明边界

按「输出格式」给出带板块的结果，显式写出不适用条件与「还需要哪些数据」。

### Step 5：遇到书中未覆盖的问题

明确回答「书里没讲」并说明能力边界，不编造章节、出处或结论。若属于心理/医疗/法律/投资等专业判断，提示寻求有资质的专业人士。

---

## 输出格式

个人人生设计蓝图 的必备板块：
你在这里 / 真问题（思维误区 → 重新定义） / 你的指南针 / 你的能量地图 / 三个奥德赛计划 / 原型行动清单 / 失败免疫

字数区间：8000 - 12000 字。
结论归属：user（用户自己说出结论，教练不代劳）。

示例结构：

```
## 个人人生设计蓝图
- 命中的框架：（名称 + 出处）
- 带出处的规则：（When X, do Y, because Z）
- 执行步骤：1. … 2. … 3. …
- 不适用边界：…
- 出处清单：segment_id / char_range
```

---

## Gotchas

- 每轮只问一个问题：你问 → 用户答 → 简短而走心地反馈 → 再问下一题；禁止一次性抛出全部问题。
- 全程主问题控制在 6-9 个之间；阶段间可依回答调整顺序，但追问要有度，追问结束必须回到主线。
- 主动区分「重力问题」与「可设计的真问题」，只对后者投入设计资源。
- 不评判用户的任何选择，不替用户做决定；结论必须由用户自己说出。
- 情绪护栏：察觉用户处在低谷或情绪脆弱时，跳过反向推演，先陪他找回能回血的东西，做完立刻转回正面。
- 支持可中断续聊：恢复时先读取 state.json 的 current_state / asked_questions，再接着问。
- 反模式：一次性抛出全部问题，把对话变成问卷。
- 反模式：说教、打鸡血、推销「正确的人生观」。
- 反模式：替用户下结论或替他做决定。
- 反模式：用户情绪低落时仍强行做反向推演。
- 反模式：把书本摘要当蓝图输出，没有回引用户自己说过的话。
- 书中未涉及的问题必须回答「书里没讲」，不得编造出处；这不是能力缺陷而是忠实度要求。
- 版权：本技能是《人生设计练习册（合成）》的结构化衍生笔记，不含原书段落，非原书替代品；版权与商标归原权利人所有。仅供学习，支持正版。
- 数据依赖：本 Skill 不绑定任何专有数据库；缺少用户陈述时先追问，不用假设填充。
- 错误路径：无法定位框架或证据不足时，回到 Step 1 追问，不要硬套框架。
````

## File: examples/coach/scripts/state_io.py
size: 951
sha: d8981438832e7a3b7aac977342f7b908be6d5097
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/scripts/state_io.py

```text
"""Minimal cross-turn state helper. Runtime state lives outside the skill package."""
import json
import os
from pathlib import Path

def state_path(slug, session_id, state_dir):
    return Path(state_dir) / slug / session_id / "state.json"

def load(slug, session_id, state_dir):
    p = state_path(slug, session_id, state_dir)
    if not p.exists():
        return {"slug": slug, "session_id": session_id, "current_state": "opening",
                "turn_index": 0, "asked_questions": [], "answers": [],
                "skipped_reverse": [], "version": 1}
    with p.open("r", encoding="utf-8") as fh:
        return json.load(fh)

def save(state, slug, session_id, state_dir):
    p = state_path(slug, session_id, state_dir)
    p.parent.mkdir(parents=True, exist_ok=True)
    tmp = p.with_name("state.json.tmp")
    with tmp.open("w", encoding="utf-8") as fh:
        json.dump(state, fh, ensure_ascii=False, indent=2)
    os.replace(tmp, p)
```

## File: examples/coach/references/framework-01.md
size: 895
sha: 310b7f74bf75e605f79bbaa50c43c896075e6507
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/framework-01.md

```text
## 何时读本文件

当用户说出「当用户说「我卡住了」「不知道该不该换方向」时触发。」、或对话进入某个提问阶段时，读取本文件对应的框架卡。

## 框架：重力问题与可设计的真问题

原文出处（≤150 字，可逐字追溯）：重力问题不是问题，它是环境的一部分。

重写为可执行规则：先判断困扰是否可被行动改变，只对可改变的部分投入设计资源。

书中用例：书中一位读者纠结通勤时间过长，教练把它重定义为可设计的居住与工作安排。

1-2-3 执行步骤：
1. 说出困扰
2. 判断它是否可被改变
3. 不可改变则接受并重定义

不适用边界：不适用：涉及临床心理危机或需要专业医疗判断时，应引导用户寻求有资质的人士。

出处：SRC-001 / seg-002 / char_range [503, 521) / 可信度 S
```

## File: examples/coach/references/framework-02.md
size: 823
sha: 3c89fe8a8c8c9aed175e62dc8057df8e055326bd
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/framework-02.md

```text
## 何时读本文件

当用户说出「当一次对话出现多个待答问题、或用户开始疲惫时触发。」、或对话进入某个提问阶段时，读取本文件对应的框架卡。

## 框架：一问一答的追问节奏

原文出处（≤150 字，可逐字追溯）：每轮只聚焦一个问题，追问要有度。

重写为可执行规则：把教练过程实现为单问题状态机，用户回答后再推进下一状态。

书中用例：书中示范了连续追问三次后主动收回主线，避免把对话变成审问。

1-2-3 执行步骤：
1. 只问一题
2. 等回答并简短反馈
3. 判定是否回到主线

不适用边界：不适用：用户明确要求一次性清单式自检时，可改用结构化表单。

出处：SRC-001 / seg-002 / char_range [774, 790) / 可信度 S
```

## File: examples/coach/references/framework-03.md
size: 879
sha: 73f25babc8605f5553600abfe6987f36b99faaee
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/framework-03.md

```text
## 何时读本文件

当用户说出「当用户说「说不上来哪里不对」「总觉得别扭」时触发。」、或对话进入某个提问阶段时，读取本文件对应的框架卡。

## 框架：工作观与人生观的一致性检查

原文出处（≤150 字，可逐字追溯）：指南针由工作观和人生观共同构成。

重写为可执行规则：分别采集两段陈述，比对冲突点，再判断是否偏离用户自认的正北方向。

书中用例：书中一位工程师发现「追求稳定」与「想做不确定产品」冲突，于是重新定义问题。

1-2-3 执行步骤：
1. 采集工作观
2. 采集人生观
3. 标出冲突并回问

不适用边界：不适用：用户尚未形成任何可表述的价值观陈述时，先补采集不要强行比对。

出处：SRC-001 / seg-003 / char_range [1058, 1074) / 可信度 S
```

## File: examples/coach/references/framework-04.md
size: 885
sha: 26f4f0977462866ea4b332dc7c8381f74aa954f7
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/framework-04.md

```text
## 何时读本文件

当用户说出「当用户说「我也不知道自己喜欢什么」时触发。」、或对话进入某个提问阶段时，读取本文件对应的框架卡。

## 框架：能量地图：擅长与热爱的分离

原文出处（≤150 字，可逐字追溯）：累但回血的事，往往比做得不错却被抽干的事更重要。

重写为可执行规则：用活动后的能量变化而非能力评分来筛选值得继续投入的方向。

书中用例：书中把「写技术方案」标为回血、把「跨部门协调」标为耗血，据此调整了原型方向。

1-2-3 执行步骤：
1. 列举具体时刻
2. 标记回血或耗血
3. 聚类出能量方向

不适用边界：不适用：涉及疲劳、抑郁等健康议题时，不做归因，引导寻求专业判断。

出处：SRC-001 / seg-004 / char_range [1366, 1390) / 可信度 S
```

## File: examples/coach/references/framework-05.md
size: 822
sha: 9edc0e881ffdb46274963dd3777ae9ba7937607f
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/framework-05.md

```text
## 何时读本文件

当用户说出「当用户反复回到同一个无解方案时触发。」、或对话进入某个提问阶段时，读取本文件对应的框架卡。

## 框架：重新定义锚问题

原文出处（≤150 字，可逐字追溯）：重新定义问题，比在原问题上更用力更有效。

重写为可执行规则：把执念拆成它要保护的东西，再改写成一个可以原型验证的新问题。

书中用例：书中把「必须进大厂」重新定义为「想获得稳定的深度技术协作」。

1-2-3 执行步骤：
1. 说出执念
2. 找出它要保护的东西
3. 改写成可测试问题

不适用边界：不适用：用户明确要求对既定方案做执行优化时，不强行重定义。

出处：SRC-001 / seg-005 / char_range [1661, 1681) / 可信度 S
```

## File: examples/coach/references/framework-06.md
size: 828
sha: c881b9bda5d70a72bcb79922bd2522e5d3ebe97a
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/framework-06.md

```text
## 何时读本文件

当用户说出「当用户说「帮我规划未来五年」时触发。」、或对话进入某个提问阶段时，读取本文件对应的框架卡。

## 框架：三个平等的奥德赛计划

原文出处（≤150 字，可逐字追溯）：三个都是 A 计划，没有哪个是备胎。

重写为可执行规则：强制生成三个等价方案，用统一维度评估，避免用户过早收敛到单一答案。

书中用例：书中示范了现路、路消失、无约束三版计划，用户最终选了混合原型。

1-2-3 执行步骤：
1. 生成三版
2. 统一四项评估
3. 各配待测试问题

不适用边界：不适用：用户已明确选定方向、只需要执行拆解时，改用原型行动清单。

出处：SRC-001 / seg-005 / char_range [1971, 1989) / 可信度 S
```

## File: examples/coach/references/provenance.md
size: 534
sha: ed6510e3ec887d8f2bdee8e24d5d37d4e397e1c4
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/provenance.md

```text
## 何时读本文件

当需要核对来源、可信度或版权边界时读取本文件。

- 书名：人生设计练习册（合成）
- 作者：
- ISBN：
- 使用权：owned
- 分发决策：private（自有/授权书籍生成的衍生笔记默认私有；公开需启动前显式确认）
- 本技能为结构化衍生笔记，不含原书段落；非原书替代品；版权与商标归原权利人所有。
- 仅供学习，支持正版。书中未涉及的问题会明确说明。
- 生成引擎：BookLeme 0.1.0 / 插件 
```

## File: examples/coach/references/state-guide.md
size: 232
sha: 874127df07fe0bd3af7433a997e0279ac81b6621
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/state-guide.md

```text
## 何时读本文件

需要实现可中断续聊或排查状态问题时读取。

运行期状态写入 out/sessions/<slug>/<session_id>/state.json；技能包内只放 state/schema.json 与 scripts/state_io.py，保持只读。
```

## File: examples/coach/references/topic-index.md
size: 1056
sha: 0fdb404a9ac7f6158cd00f6976915296695f6c9e
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/references/topic-index.md

```text
## 何时读本文件

当用户问题需要定位到具体框架分片时，先读本表；不要一次性加载所有分片。

| 用户问题 / 意图 | 读取文件 |
| --- | --- |
| 重力问题与可设计的真问题 / 当用户说「我卡住了」「不知道该不该换方向」时触发。 | `references/framework-01.md` |
| 一问一答的追问节奏 / 当一次对话出现多个待答问题、或用户开始疲惫时触发。 | `references/framework-02.md` |
| 工作观与人生观的一致性检查 / 当用户说「说不上来哪里不对」「总觉得别扭」时触发。 | `references/framework-03.md` |
| 能量地图：擅长与热爱的分离 / 当用户说「我也不知道自己喜欢什么」时触发。 | `references/framework-04.md` |
| 重新定义锚问题 / 当用户反复回到同一个无解方案时触发。 | `references/framework-05.md` |
| 三个平等的奥德赛计划 / 当用户说「帮我规划未来五年」时触发。 | `references/framework-06.md` |
| 出处与版权 | `references/provenance.md` |
```

## File: examples/coach/assets/blueprint-template.md
size: 333
sha: 46a0893800415bea7043c15091797c5a3734a924
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/assets/blueprint-template.md

```text
# 个人人生设计蓝图（模板）

## 你在这里

（待填写）

## 真问题（思维误区 → 重新定义）

（待填写）

## 你的指南针

（待填写）

## 你的能量地图

（待填写）

## 三个奥德赛计划

（待填写）

## 原型行动清单

（待填写）

## 失败免疫

（待填写）
```

## File: examples/coach/evals/smoke.md
size: 524
sha: e7266604dce67b0167fa881b3ac6f6cffc150a51
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/evals/smoke.md

```text
# 冒烟用例

- [positive] coach-positive：我最近很迷茫，不知道要不要换方向 → 只问一个问题，先确认当前状态与真问题
- [negative] coach-negative：请根据这本书预测我明年能不能升职 → 明确回答「书里没讲」，不编造出处，不预测未来
- [boundary] coach-boundary：帮我做完整的职业测评 → 声明不做职业测评，只做设计式对话，并给出能力边界
- [trigger_hit] coach-trigger：我想重新定义问题 → 命中 trigger_words
```

## File: examples/coach/state/schema.json
size: 534
sha: 824f01c412785eb68e7f89726f2126a28825c3a5
upstream: https://github.com/bookleme/bookleme/blob/main/examples/coach/state/schema.json

```text
{
  "type": "object",
  "required": [
    "slug",
    "session_id",
    "current_state",
    "turn_index"
  ],
  "properties": {
    "slug": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    },
    "current_state": {
      "type": "string"
    },
    "turn_index": {
      "type": "integer"
    },
    "asked_questions": {
      "type": "array"
    },
    "answers": {
      "type": "array"
    },
    "skipped_reverse": {
      "type": "array"
    },
    "version": {
      "type": "integer"
    }
  }
}
```

## File: README.md
upstream: https://github.com/bookleme/bookleme/blob/main/README.md

````text
<p align="center">
  <img src="docs/assets/bookleme-banner.png" alt="BookLeme — From Books to Skills" width="100%">
</p>

<h1 align="center">读了么 · BookLeme</h1>

<p align="center">
  <a href="README.md"><strong>简体中文</strong></a> ·
  <a href="README.en.md">English</a>
</p>

<p align="center">
  <strong>把一本书编译成可安装的 Agent Skill —— 从「读过」到「会用」。</strong>
</p>

<p align="center">
  <a href="https://github.com/bookleme/bookleme/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/bookleme/bookleme/ci.yml?style=for-the-badge&label=CI&color=brightgreen" alt="CI"></a>
  <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="MIT License">
  <img src="https://img.shields.io/badge/Python-3.9%2B-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.9+">
  <img src="https://img.shields.io/badge/runtime-zero%20third--party%20deps-brightgreen?style=for-the-badge" alt="Zero deps">
  <img src="https://img.shields.io/badge/formats-PDF%20%C2%B7%20EPUB%20%C2%B7%20DOCX%20%C2%B7%20MD%20%C2%B7%20HTML%20%C2%B7%20RTF%20%C2%B7%20MOBI-green?style=for-the-badge" alt="Formats">
</p>

<p align="center">
  <a href="#why">为什么</a> ·
  <a href="#what">生成什么</a> ·
  <a href="#engines">双引擎</a> ·
  <a href="#fidelity">忠实度</a> ·
  <a href="#quickstart">快速开始</a> ·
  <a href="#arch">架构</a> ·
  <a href="#compare">同类对比</a> ·
  <a href="#roadmap">路线图</a> ·
  <a href="#docs">文档</a>
</p>

---

<a id="why"></a>

## 为什么需要它

模型已经足够聪明，真正稀缺的是**人类实际的工作经验**。

而一本书里最值钱的，从来不是结论，而是作者的**工作方式**：

| 书 | 真正值钱的部分 |
|---|---|
| 《人生设计课》 | 不是人生答案，而是那串**提问顺序** —— 追问出用户自己的答案 |
| 《穿透财报》 | 不是行业结论，而是**判断条件 + 证据规则 + 证伪条件** |

问题是：读完之后，这些「工作方式」散落在 300 页里，无法被调用、无法被复用、无法被验证。

**BookLeme 把它们编译成可运行的 Agent Skill。**

<p align="center">
  <img src="docs/assets/bookleme-witch-study.png" alt="把知识编译成技能" width="72%">
</p>

### 三条设计原理

> ⚠️ **工程上采纳，但未经本项目验证** —— 「提炼结构而非摘要」只是设计选择，不是已被验证的结论。本项目把它标为 `UNVERIFIED`，不写成既成事实。

<table>
<tr>
<td width="33%" valign="top"><b>01 · 编译期 / 运行期分离</b><br/><br/>书只在编译时读一遍，运行时按需加载知识分片。</td>
<td width="33%" valign="top"><b>02 · 渐进式披露三级</b><br/><br/>常驻入口 → 按需分片 → 本地全文。</td>
<td width="33%" valign="top"><b>03 · 确定性 × 概率性解耦</b><br/><br/>确定性提取与概率性生成分离 —— 可单测、可 diff、可回归。</td>
</tr>
</table>

---

<a id="what"></a>

## 它生成什么

不是「读书笔记」，而是**两类可安装、可调用、可验证的产物**：

<p align="center">
  <img src="docs/assets/bookleme-witch-library.png" alt="双引擎产物" width="62%">
</p>

<table>
<tr><th></th><th>📚 知识包 · <code>knowledge_pack</code></th><th>⚡ 行为 Skill · <code>behavior_skill</code></th></tr>
<tr><td><b>形态</b></td><td>可查阅的结构化知识库</td><td>会运行的流程与状态机</td></tr>
<tr><td><b>装的是</b></td><td>Topic Index 路由表 + 按需加载的框架分片 + 决策速查 + 出处清单</td><td>角色 + 硬约束 + 状态机 + 具名输出契约 + 反模式 + 情绪护栏</td></tr>
<tr><td><b>典型场景</b></td><td>「这本书里 X 框架怎么用？」</td><td>「陪我做一次完整的人生设计对话」</td></tr>
<tr><td><b>样例</b></td><td><code>examples/reference/</code>（11 文件）</td><td><code>examples/coach/</code>（14 文件）</td></tr>
</table>

**核心特性**

- 🎛 **双引擎自动路由** —— 按 12 个确定性体裁特征自动判定，也可人工指定；两引擎共享中间表示，一本书不会被读两遍
- 🧩 **可插拔体裁插件** —— 新增体裁只需写一个文件（schema / 状态机 / 输出契约 / 反模式），零改核心
- 🔍 **逐字忠实度回验** —— 每条引文必须是原文精确子串，7 个指标区分 `measured` / `heuristic`
- 🛡 **版权工程化** —— 6 条确定性硬门 + provenance manifest + 默认私有，杜绝原文复现
- ⚙️ **零第三方依赖** —— 核心只用 Python 标准库
- 🔁 **stage 级幂等** —— sha256 断点续跑，删任一阶段产物只补该阶段

---

<a id="engines"></a>

## 双引擎 · 可插拔体裁

**体裁插件**决定一本书长成什么样子。内置 4 种：

| 插件 | 体裁 | 状态 | 关键设计 |
|---|---|---|---|
| `coach_dialogue` | 教练 / 自我对话 | ✅ 已实现 | 一问一答状态机、结论归用户、情绪护栏、可中断续聊 |
| `knowledge_reference` | 框架速查 | ✅ 已实现 | Topic Index 路由、按需加载、「书里没讲」必须拒答 |
| `professional_analysis` | 专业分析流水线 | 🔜 M4 | 证据绑定、口径表、**每条结论必填证伪条件** |
| `decision_checklist` | 决策清单 | 🔜 M4 | 阈值 / 权衡矩阵 / 决策树 / 不适用边界 |

> 新增体裁 = 在 `bookleme/plugins/user/<genre_id>.py` 写一个文件。字段契约见 [docs/PLUGIN_SPEC.md](docs/PLUGIN_SPEC.md)。

**插件强制声明**（缺一即拒绝加载）：`state_machine`、`output_contract`、`hard_constraints`、`anti_patterns`、`voice_calibration`（语气 / 称谓 / 禁用语 / **结论归属**）、`copyright_profile`、`trigger_words`（3–5 个中文触发词）、`eval_prompts`（必须含至少 1 个负例）。

---

<a id="fidelity"></a>

## 忠实度与版权

上游项目把「no hallucination」写成主张，却没有自动回验。**我们把「零幻觉」拆成 7 个可测指标**：

| 指标 | 类型 | 目标 | 实测 · 真实书稿批 |
|---|---|---|---|
| `citation_resolution_rate` | measured | 1.00 | ✅ 1.00 |
| `verbatim_violation_rate` | measured | 0.00 | ✅ 0.00 |
| `negative_refusal_rate` | measured | 1.00 | ✅ 1.00 |
| `trigger_hit_rate` | measured | ≥0.90 | ✅ 1.00 |
| `artifact_compliance_rate` | measured | 1.00 | ✅ 1.00 |
| `shingle_overlap_max` | measured | ≤0.10 | ✅ 0.0006 |
| `coverage_score` | measured | ≥0.85 | ✅ **1.00** |
| `groundedness` | heuristic | 只报告 | `null`（LLM judge 未接入） |

> 📎 指标取自真实书稿批（273 页中文书，run 20261109-164758）：14/14 能力 verified、双引擎冒烟全过、版权六门全过（引文占比 0.016 / 上限 0.03）。早期合成书批过程值（`coverage_score` 0.667）如实留档。

> 🧪 **真实书稿实战**：273 页中文书端到端编译出的教练 Skill，已通过 9 轮真实对话回归 —— 一次一问 · 重力问题甄别 · 中断续聊断点恢复 · 万字蓝图交付。

**6 条版权硬门**（任一失败即不安装、不发布）：单条引文 ≤150 字且逐字可追溯 · 总引文比 ≤0.03 · 连续复制 ≤150 字 · 13 字 shingle 重叠 ≤0.10 · 产物不含全文 / 切片 · `contains_original_text = false`。

**版权边界**：输出是**结构化衍生笔记，不含原文段落**。第三方书籍生成的 Skill 默认私有、不得分发；公开分发需在启动命令显式给 `--public --confirm-public PUBLISH`。MIT 只覆盖转换器，不覆盖任何书籍。详见 [docs/COPYRIGHT.md](docs/COPYRIGHT.md)。

---

<a id="quickstart"></a>

## 快速开始

```bash
git clone https://github.com/bookleme/bookleme.git
cd bookleme

# 零第三方依赖，Python ≥ 3.9 即可
python3 -m bookleme --version

# 端到端：书 → Skill
python3 -m bookleme run --input evals/cases/synthetic/coach_book.md --title "我的第一本书"

# 校验产物（官方校验器 + 自有 lint + 版权硬门）
python3 -m bookleme validate examples/coach

# 回归测试
python3 -m unittest discover -s tests -v
```

**常用参数**

```bash
--engine auto|knowledge_pack|behavior_skill|both   # 引擎选择
--genre <plugin_id>                                # 强制指定体裁
--no-router                                        # 关闭路由，双引擎全出
--install                                          # 写入技能真源（默认关闭）
--user-rights owned|licensed|public_domain|unknown # 使用权声明
--public --confirm-public PUBLISH                  # 公开分发（裸词确认）
```

---

<a id="arch"></a>

## 架构 · S0–S9 编译流水线

```
S0 输入登记 ─► S1 确定性提取 ─► S2 中文分段 ─┬─► S3 体裁路由 ────────┐
                                              └─► S4 原子能力抽取 ────┼─► S5 忠实度校验
                                                    （共享中间表示）  ┘
                                                                          │
                                S9 冒烟评测 ◄─ S8 安装 ◄─ S7 四重校验 ◄─ S6 双引擎渲染
```

**关键设计**：S3 与 S4 并行且都以 S2 为输入；两引擎共享 S1/S2/S4/S5 全部中间表示，**只有 S6 分流** —— 一本书不会被读两遍。

| 层 | 职责 | 执行者 |
|---|---|---|
| S0–S2 | 提取、归一、中文分段（不依赖 "Chapter N"） | 确定性 Python |
| S3 | 12 特征体裁路由 + 歧义兜底（自动双引擎，不停人） | 确定性 + 可插拔 LLM |
| S4 | 原子能力抽取（RIA++ 六段） | 确定性抽取器 + 可选 LLM 抽取器（OpenAI 兼容 · 引文终身逐字回验 · 缺配置自动回退） |
| S5 | 逐字引文校验 + claim ledger + 7 指标 | 确定性 + judge 占位 |
| S6 | 插件驱动渲染（标准库字符串模板） | 确定性 Python |
| S7–S9 | 四重校验、幂等安装、冒烟评测 | 确定性 Python |

详细设计：[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)

---

<a id="compare"></a>

## 与同类项目对比

<table>
<tr><th></th><th><b>读了么 BookLeme</b></th><th><code>virgiliojr94/book-to-skill</code></th><th><code>bookforge-ai/bookforge-skills</code></th></tr>
<tr><td><b>定位</b></td><td>书 → Skill 的<b>编译器工具链</b></td><td>书 → 知识包（靠宿主 Agent 执行）</td><td>已蒸馏 skills 的<b>产物库</b></td></tr>
<tr><td><b>产物</b></td><td>知识包 <b>＋</b> 会运行的行为 Skill</td><td>仅知识包</td><td>skills 文件集合</td></tr>
<tr><td><b>生成器</b></td><td>代码化 stage DAG，可单测 / 可 diff</td><td>一份巨型 SKILL.md 操作规程</td><td>—</td></tr>
<tr><td><b>忠实度</b></td><td>7 指标 + 逐字引文校验 + 负例拒答</td><td>无自动回验</td><td>—</td></tr>
<tr><td><b>体裁</b></td><td>可插拔插件，新增体裁只写一文件</td><td>固定 5 文件 + 10 节模板</td><td>—</td></tr>
<tr><td><b>版权</b></td><td>6 条确定性硬门 + 默认私有</td><td>prompt 规则 + 自律</td><td>CC-BY-SA-4.0</td></tr>
<tr><td><b>许可</b></td><td>MIT</td><td>MIT</td><td>CC-BY-SA-4.0</td></tr>
</table>

> 本项目自研自对 `book-to-skill` 的源码审计之后，**未导入其任何代码或模板**；与 `bookforge-ai` 无隶属关系，未使用其任何内容。逐条差异见 [docs/decisions/ADR-001-research-convergence.md](docs/decisions/ADR-001-research-convergence.md)。

---

<a id="roadmap"></a>

## 路线图

- ✅ **M0–M3** 研究对齐 · 设计冻结 · 核心引擎 · 首批插件与产物（**当前**）
- 🔜 **M4** 补齐 `professional_analysis` / `decision_chec
````
