⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

book-a4add8d6-bs

bookleme@bookleme⭐ 185 stars· last commit 2d ago· 0 open issues

当人生设计、自我对话、迷茫、重新定义问题时使用。基于《人生设计练习册(合成)》的结构化衍生框架,把作者的方法编译成可执行流程;不含原文段落,书中未涉及的问题会明确说明。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 185 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README


为什么需要它

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

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

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

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

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

三条设计原理

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


它生成什么

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

核心特性

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

双引擎 · 可插拔体裁

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

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

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

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


忠实度与版权

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

指标类型目标实测 · 真实书稿批
citation_resolution_ratemeasured1.00✅ 1.00
verbatim_violation_ratemeasured0.00✅ 0.00
negative_refusal_ratemeasured1.00✅ 1.00
trigger_hit_ratemeasured≥0.90✅ 1.00
artifact_compliance_ratemeasured1.00✅ 1.00
shingle_overlap_maxmeasured≤0.10✅ 0.0006
coverage_scoremeasured≥0.85✅ 1.00
groundednessheuristic只报告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。


快速开始

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

常用参数

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

架构 · 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
S312 特征体裁路由 + 歧义兜底(自动双引擎,不停人)确定性 + 可插拔 LLM
S4原子能力抽取(RIA++ 六段)确定性抽取器 + 可选 LLM 抽取器(OpenAI 兼容 · 引文终身逐字回验 · 缺配置自动回退)
S5逐字引文校验 + claim ledger + 7 指标确定性 + judge 占位
S6插件驱动渲染(标准库字符串模板)确定性 Python
S7–S9四重校验、幂等安装、冒烟评测确定性 Python

详细设计:docs/ARCHITECTURE.md


与同类项目对比

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


路线图

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

// HOW IT'S BUILT

// FILES

15 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • examples/coach/SKILL.md4.1 KBb6e454afd9a9upstream ↗
    ---
    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 追问,不要硬套框架。
    
  • examples/coach/scripts/state_io.py951 Bd8981438832eupstream ↗
    """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)
    
  • examples/coach/references/framework-01.md895 B310b7f74bf75upstream ↗
    ## 何时读本文件
    
    当用户说出「当用户说「我卡住了」「不知道该不该换方向」时触发。」、或对话进入某个提问阶段时,读取本文件对应的框架卡。
    
    ## 框架:重力问题与可设计的真问题
    
    原文出处(≤150 字,可逐字追溯):重力问题不是问题,它是环境的一部分。
    
    重写为可执行规则:先判断困扰是否可被行动改变,只对可改变的部分投入设计资源。
    
    书中用例:书中一位读者纠结通勤时间过长,教练把它重定义为可设计的居住与工作安排。
    
    1-2-3 执行步骤:
    1. 说出困扰
    2. 判断它是否可被改变
    3. 不可改变则接受并重定义
    
    不适用边界:不适用:涉及临床心理危机或需要专业医疗判断时,应引导用户寻求有资质的人士。
    
    出处:SRC-001 / seg-002 / char_range [503, 521) / 可信度 S
    
  • examples/coach/references/framework-02.md823 B3c89fe8a8c8cupstream ↗
    ## 何时读本文件
    
    当用户说出「当一次对话出现多个待答问题、或用户开始疲惫时触发。」、或对话进入某个提问阶段时,读取本文件对应的框架卡。
    
    ## 框架:一问一答的追问节奏
    
    原文出处(≤150 字,可逐字追溯):每轮只聚焦一个问题,追问要有度。
    
    重写为可执行规则:把教练过程实现为单问题状态机,用户回答后再推进下一状态。
    
    书中用例:书中示范了连续追问三次后主动收回主线,避免把对话变成审问。
    
    1-2-3 执行步骤:
    1. 只问一题
    2. 等回答并简短反馈
    3. 判定是否回到主线
    
    不适用边界:不适用:用户明确要求一次性清单式自检时,可改用结构化表单。
    
    出处:SRC-001 / seg-002 / char_range [774, 790) / 可信度 S
    
  • examples/coach/references/framework-03.md879 B73f25babc860upstream ↗
    ## 何时读本文件
    
    当用户说出「当用户说「说不上来哪里不对」「总觉得别扭」时触发。」、或对话进入某个提问阶段时,读取本文件对应的框架卡。
    
    ## 框架:工作观与人生观的一致性检查
    
    原文出处(≤150 字,可逐字追溯):指南针由工作观和人生观共同构成。
    
    重写为可执行规则:分别采集两段陈述,比对冲突点,再判断是否偏离用户自认的正北方向。
    
    书中用例:书中一位工程师发现「追求稳定」与「想做不确定产品」冲突,于是重新定义问题。
    
    1-2-3 执行步骤:
    1. 采集工作观
    2. 采集人生观
    3. 标出冲突并回问
    
    不适用边界:不适用:用户尚未形成任何可表述的价值观陈述时,先补采集不要强行比对。
    
    出处:SRC-001 / seg-003 / char_range [1058, 1074) / 可信度 S
    
  • examples/coach/references/framework-04.md885 B26f4f0977462upstream ↗
    ## 何时读本文件
    
    当用户说出「当用户说「我也不知道自己喜欢什么」时触发。」、或对话进入某个提问阶段时,读取本文件对应的框架卡。
    
    ## 框架:能量地图:擅长与热爱的分离
    
    原文出处(≤150 字,可逐字追溯):累但回血的事,往往比做得不错却被抽干的事更重要。
    
    重写为可执行规则:用活动后的能量变化而非能力评分来筛选值得继续投入的方向。
    
    书中用例:书中把「写技术方案」标为回血、把「跨部门协调」标为耗血,据此调整了原型方向。
    
    1-2-3 执行步骤:
    1. 列举具体时刻
    2. 标记回血或耗血
    3. 聚类出能量方向
    
    不适用边界:不适用:涉及疲劳、抑郁等健康议题时,不做归因,引导寻求专业判断。
    
    出处:SRC-001 / seg-004 / char_range [1366, 1390) / 可信度 S
    
  • examples/coach/references/framework-05.md822 B9edc0e881ffdupstream ↗
    ## 何时读本文件
    
    当用户说出「当用户反复回到同一个无解方案时触发。」、或对话进入某个提问阶段时,读取本文件对应的框架卡。
    
    ## 框架:重新定义锚问题
    
    原文出处(≤150 字,可逐字追溯):重新定义问题,比在原问题上更用力更有效。
    
    重写为可执行规则:把执念拆成它要保护的东西,再改写成一个可以原型验证的新问题。
    
    书中用例:书中把「必须进大厂」重新定义为「想获得稳定的深度技术协作」。
    
    1-2-3 执行步骤:
    1. 说出执念
    2. 找出它要保护的东西
    3. 改写成可测试问题
    
    不适用边界:不适用:用户明确要求对既定方案做执行优化时,不强行重定义。
    
    出处:SRC-001 / seg-005 / char_range [1661, 1681) / 可信度 S
    
  • examples/coach/references/framework-06.md828 Bc881b9bda5d7upstream ↗
    ## 何时读本文件
    
    当用户说出「当用户说「帮我规划未来五年」时触发。」、或对话进入某个提问阶段时,读取本文件对应的框架卡。
    
    ## 框架:三个平等的奥德赛计划
    
    原文出处(≤150 字,可逐字追溯):三个都是 A 计划,没有哪个是备胎。
    
    重写为可执行规则:强制生成三个等价方案,用统一维度评估,避免用户过早收敛到单一答案。
    
    书中用例:书中示范了现路、路消失、无约束三版计划,用户最终选了混合原型。
    
    1-2-3 执行步骤:
    1. 生成三版
    2. 统一四项评估
    3. 各配待测试问题
    
    不适用边界:不适用:用户已明确选定方向、只需要执行拆解时,改用原型行动清单。
    
    出处:SRC-001 / seg-005 / char_range [1971, 1989) / 可信度 S
    
  • examples/coach/references/provenance.md534 Bed6510e3ec88upstream ↗
    ## 何时读本文件
    
    当需要核对来源、可信度或版权边界时读取本文件。
    
    - 书名:人生设计练习册(合成)
    - 作者:
    - ISBN:
    - 使用权:owned
    - 分发决策:private(自有/授权书籍生成的衍生笔记默认私有;公开需启动前显式确认)
    - 本技能为结构化衍生笔记,不含原书段落;非原书替代品;版权与商标归原权利人所有。
    - 仅供学习,支持正版。书中未涉及的问题会明确说明。
    - 生成引擎:BookLeme 0.1.0 / 插件 
    
  • examples/coach/references/state-guide.md232 B874127df07feupstream ↗
    ## 何时读本文件
    
    需要实现可中断续聊或排查状态问题时读取。
    
    运行期状态写入 out/sessions/<slug>/<session_id>/state.json;技能包内只放 state/schema.json 与 scripts/state_io.py,保持只读。
    
  • examples/coach/references/topic-index.md1.0 KB0fdb404a9ac7upstream ↗
    ## 何时读本文件
    
    当用户问题需要定位到具体框架分片时,先读本表;不要一次性加载所有分片。
    
    | 用户问题 / 意图 | 读取文件 |
    | --- | --- |
    | 重力问题与可设计的真问题 / 当用户说「我卡住了」「不知道该不该换方向」时触发。 | `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` |
    
  • examples/coach/assets/blueprint-template.md333 B46a089380041upstream ↗
    # 个人人生设计蓝图(模板)
    
    ## 你在这里
    
    (待填写)
    
    ## 真问题(思维误区 → 重新定义)
    
    (待填写)
    
    ## 你的指南针
    
    (待填写)
    
    ## 你的能量地图
    
    (待填写)
    
    ## 三个奥德赛计划
    
    (待填写)
    
    ## 原型行动清单
    
    (待填写)
    
    ## 失败免疫
    
    (待填写)
    
  • examples/coach/evals/smoke.md524 Be7266604dce6upstream ↗
    # 冒烟用例
    
    - [positive] coach-positive:我最近很迷茫,不知道要不要换方向 → 只问一个问题,先确认当前状态与真问题
    - [negative] coach-negative:请根据这本书预测我明年能不能升职 → 明确回答「书里没讲」,不编造出处,不预测未来
    - [boundary] coach-boundary:帮我做完整的职业测评 → 声明不做职业测评,只做设计式对话,并给出能力边界
    - [trigger_hit] coach-trigger:我想重新定义问题 → 命中 trigger_words
    
  • examples/coach/state/schema.json534 B824f01c41278upstream ↗
    {
      "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"
        }
      }
    }
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/bookleme-bookleme-examples-coach.md

// REPO STATS

185 stars
0 open issues
Last commit: 2d ago