brainstorming
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).
book-distiller炼金书:输入书名或电子书,自动深度调研→方法论提炼→生成该书的可运行框架Skill。 两种入口:(1)明确书名→直接蒸馏 (2)模糊学习需求→诊断荐书→再蒸馏。 触发词:「蒸馏这本书」「炼金XX」「把XX这本书做成skill」「XX的方法论skill」「更新XX的书skill」。 模糊需求也触发:「我想系统学谈判」「有没有一本书能帮我提升XX」。 English triggers: "distill [book]", "turn [book] into a skill", "book to framework skill". 不在用户只要书摘、读书笔记、买书推荐或查某个概念时触发——只在需要生成「可运行的方法论Skill」时激活。
Independent GitHub snapshot · Automated classification · Original documentation governs
一本书值钱的从来不是它说了什么,是它让你在具体处境里知道该做什么。
炼金书不做读书笔记,做可运行的方法论。
一个好的书籍Skill是这本书的"执行引擎":
关键区分:捕捉的是这本书让你 HOW to act,不是这本书 WHAT it says。摘要回答"书讲了啥",框架Skill回答"现在我该怎么办"。
| 用户输入 | 路径 | 示例 |
|---|---|---|
| 明确书名 | 直接路径 → Phase 0A | 「蒸馏《影响力》」「把《高产出管理》做成skill」 |
| 模糊学习需求 | 诊断路径 → Phase 0B | 「我想系统学谈判」「有没有一本书能治我的拖延」 |
收到明确书名后,确认(每项都有默认值,确认不阻塞交付):
.claude/skills/ 是否已有该书的Skill| 档位 | 调研规模 | 适用场景 | 成本量级 |
|---|---|---|---|
| 快速 | 3个维度(骨架01+方法02+批评05),每维度限5个来源。案例索引从01/02顺带提取,产物中标注「快速档:案例颗粒度粗」 | 先试效果 / 薄书 / 预算敏感 | 约标准档1/3 |
| 标准(默认) | 6个维度完整调研 | 大多数场景 | 中等 |
| 深度 | 6维度 + 用户提供全书精读 + 领域后续研究追踪 | 打算开源发布的精品Skill | 最高 |
用户只说「就蒸这本」→ 默认:最新版 + 方法论顾问 + 无电子书 + 标准档,直接推进。
用户不知道该蒸哪本书,只有学习需求。通过≤2轮追问定位需求维度,然后推荐2-3本候选书。
| 需求维度 | 典型表达 | 候选书方向 |
|---|---|---|
| 说服与谈判 | 「总谈不下来」「不会拒绝」 | 影响力、掌控谈话、Never Split the Difference |
| 管理与组织 | 「带团队力不从心」 | 高产出管理、联盟、重来 |
| 决策与思维 | 「总是选错」「想不清楚」 | 思考快与慢、穷查理宝典、超越智商 |
| 写作与表达 | 「写不清楚」「没人看」 | 风格的要素、金字塔原理、On Writing Well |
| 习惯与执行 | 「坚持不下来」「拖延」 | 原子习惯、深度工作 |
| 产品与创业 | 「找不到PMF」「不知道做什么」 | 精益创业、从0到1、Mom Test |
候选展示格式(每本必须写局限):
### 候选1: 《书名》(作者) ⚡已有Skill / 🆕需要蒸馏
**核心方法**:[这本书最可操作的一套方法,一句话]
**为什么适合你**:[直接对应用户需求]
**局限与批评**:[这本书公认的弱点/过时之处/不适用场景]
推荐原则:≤3本、已有Skill优先、候选间要有差异、必须写局限。用户都不满意 → 回到追问或用户自己提书名。
收到确认后立即执行:
slug命名规则:英文书名取主标题小写连字符(influence-framework);中文书优先用其通行英文名(《影响力》→influence-framework),无英文名则用拼音(《定位》若无英文名→dingwei-framework)。同名书冲突时追加作者姓(influence-cialdini-framework)。
.claude/skills/[book-slug]-framework/
├── SKILL.md # 最终产物
└── references/
├── research/ # 每个调研任务的结果(必存)
│ ├── 01-skeleton.md # 本书骨架:章节结构、核心主张、概念定义
│ ├── 02-methods.md # 方法与工具:可操作步骤/清单/公式
│ ├── 03-cases.md # 案例库:书中案例及其教训
│ ├── 04-author-context.md # 作者语境:背景、动机、智识谱系
│ ├── 05-criticism.md # 外部批评:书评、反驳、过时之处
│ └── 06-aftermath.md # 实践检验:读者实践反馈、出版后领域新证据
└── sources/ # 一手素材(用户提供的电子书等)
关键规则:
| 模式 | 触发条件 | 策略 |
|---|---|---|
| 纯网络调研(默认) | 用户没有电子书 | 6个任务全走公开资料 |
| 电子书优先 | 用户提供PDF/epub | 先精读原书(覆盖01/02/03),网络调研只补04/05/06 |
| 纯本地 | 冷门书/内部资料,网上查不到 | 只读用户素材,05/06标注「信息不足」 |
| # | 任务 | 搜索/提取目标 | 输出文件 |
|---|---|---|---|
| 1 | 骨架 | 章节结构、每章核心主张、作者自创概念及定义 | 01-skeleton.md |
| 2 | 方法 | 书中所有可操作的步骤/清单/公式/话术,逐条记录原始出处章节 | 02-methods.md |
| 3 | 案例 | 书中案例:背景→做法→结果→作者用它证明什么 | 03-cases.md |
| 4 | 作者 | 作者背景、写此书的动机、受谁影响、后续作品中的立场变化 | 04-author-context.md |
| 5 | 批评 | 严肃书评、学术反驳、被指过时/夸大的部分、与同类书对比 | 05-criticism.md |
| 6 | 后效 | 出版后领域新证据(支持/推翻书中主张)、读者长期实践反馈 | 06-aftermath.md |
每个任务的硬性要求:
优先:原书(用户提供)> 作者本人演讲/访谈/官网 > 出版社官方资料 > 严肃书评(学术期刊、主流媒体书评版、Goodreads长评)> 读者实践帖。 黑名单:AI生成的书摘农场站、卖课号的「五分钟读完XX」、听书平台转述稿——这些是二手失真的重灾区,任何维度都不用。
| 触发条件 | 一线修复 | 兜底 |
|---|---|---|
| 运行环境不支持并行subagent | 6个任务降级串行,做完一个落盘一个 | 单agent分6轮,每轮一个维度并立即落盘 |
| 上下文窗口不足 | 分Phase续跑:调研文件本身就是断点,新会话先读已落盘文件 | 分3段会话:Phase 0-1 / 1.5-2.5 / 3-4 |
| 成本失控 / 用户中途喊停 | Phase 0A档位确认就是熔断器 | 已落盘调研文件即为可交付中间产物,下次续跑不清零 |
| 冷门书公开信息极少(<10条来源) | Phase 0.5就提醒用户、请求提供电子书 | 核心方法减至2-3个,诚实边界加大篇幅 |
| 搜索工具不可用 | 换运行环境可用的等价工具 | 切纯本地模式,引导用户提供素材 |
| 书太厚/方法太多(工具书类) | 与用户确认聚焦章节范围 | 按用途裁剪:只蒸用户场景相关的方法 |
| Phase 4 无法spawn独立子agent | 主agent以「批评者视角重读」执行三项测试,并在产物诚实边界标注「验证非独立执行」 | 交付时明确告知用户未通过独立验证,建议用户新开会话自行复测 |
所有任务完成后,暂停展示摘要表:每个维度的来源数、关键发现、书中主张与外部证据的矛盾点、信息不足的维度。用户确认OK → Phase 2;觉得某维度薄 → 补调研。
垃圾进垃圾出——在这里拦截比Phase 4返工便宜得多。
先读取 references/methodology.md 获取三重验证判据。
2.1 核心方法提取(3-7个):从02-methods.md列出全部候选(通常15-30个),逐个过三重验证:
三重全过 → 核心方法;过1-2重 → 降级为判断规则;0重 → 丢弃。宁少勿多。
2.2 判断规则提取(5-10条):书中「什么时候用哪个方法/什么信号说明方法失效」的规则,每条挂书中案例。
2.3 案例索引:每个核心方法挂1-2个书中案例(一句话背景+结论+原书章节号),供Skill运行时引用。
2.4 适用边界(来自05/06):这本书在什么条件下失效——时代局限、文化语境、被后续研究修正的主张、批评者指出的盲区。批评材料不足=调研不合格。
2.5 诚实边界:蒸馏不能替代读原书;案例细节有损;书的语境≠用户的语境;调研截止日期。
展示提炼摘要(核心方法N个+判断规则N条+适用边界N条),用户确认后再构建——避免写完几百行才发现方向不对。
读取 references/template.md,将Phase 2结果填入。要点:
[ 占位符,全部替换或明确留待用户填写;核对description中的数字声明(N个方法等)与正文实际数量一致$数字 禁用:SKILL.md正文不得出现「$紧跟数字」写法(如 $0.30)——部分runtime的skill加载器会把 $0/$1 当参数占位符插值污染正文。金额写「0.30美元」或「USD 0.30」先跑结构自检脚本(确定性检查,不耗token):python [skill目录]/scripts/quality_check.py <产物SKILL.md路径>——逐项输出PASS/FAIL,全过后再进入主观验证。
主观验证用独立子agent执行(生成者不自评):
通过标准:
| 检查项 | 通过 | 不通过信号 |
|---|---|---|
| 核心方法数量 | 3-7个,每个有章节出处 | <3或>10 |
| 每个方法的失效条件 | 明确写出 | 只写优点 |
| 适用边界 | ≥3条,含外部批评 | 只有「不能替代读书」 |
| 直接引语 | 每句有出处,总量克制 | 大段无出处引用 |
| 回答风格 | 框架运行 | 书摘复读 / 通用鸡汤 |
迭代上限2轮,超限则在诚实边界标注薄弱项后交付。宁可交付诚实标注局限的60分Skill,也不造看似完美实则编造的90分Skill。
离线验证(脚本+子agent读文件)测不到skill被loader真实加载后的行为——插值污染、触发命中、实搜分支都只有真实运行才暴露。Phase 4通过后执行:
$数字写法、残留模板占位符(实测教训:$0.30会被loader当参数占位符替换成用户输入)任一项失败 → 修复后只重测该项。runtime无法执行真实调用 → 在诚实边界标注「未经真实调用测试」,把以上4项转为用户自测清单随产物交付。
🔴 CHECKPOINT · 展示离线+真实调用两级验证结果,用户确认后交付。
「更新XX的skill」→ 只重跑任务5(新批评)+ 任务6(领域新证据),对比现有内容增量更新,刷新调研日期。不重写全书。
| # | 反模式 | 为什么 / 替代做法 |
|---|---|---|
| 1 | 大段复制原文 | 版权问题+根本不是提炼。方法自己重述+标注章节 |
| 2 | 把摘要冒充框架 | 摘要回答「书讲了啥」,框架回答「我该怎么办」。产物必须是后者 |
| 3 | 把常识包装成本书独特方法 | 通不过排他性验证的不进核心方法 |
| 4 | 忽略对书的批评 | 任务5的批评材料是防「书粉滤镜」的关键,占比不足=调研不合格 |
| 5 | 把过时方法当普适真理 | 任务6专门查出版后新证据;被推翻的主张必须标注 |
| 6 | 编造书里没有的案例/数据 | 查不到出处的内容宁可不用 |
| 7 | 不报成本量级直接开跑 | 完整蒸馏是重任务,用户有权先选档位 |
| 8 | 引导用户获取盗版电子书 | 电子书只接受用户自己提供,来源不过问但绝不代找 |
| 9 | 把检查点变成交付阻塞 | 能给默认值就给默认值,检查点是纠偏不是扣产出 |
炼金书炼的不是金句,是把一本书变成你处境里的一位顾问。读书笔记会忘,能运行的框架不会。