用途
strategic-reading 用于把一份大文本与一个具体的战略问题结合起来,产出把文本洞见映射到该问题上的分析。它不是为了做书籍摘要,而是“带着任务去阅读”。
与 book-mirror 将一本书个性化到读者整个人生不同,strategic-reading 把它个性化到当前一个具体问题上。两者形状相似(提取 → 分析 → 镜像),但视角不同。
典型示例:用一本讲述权力博弈的历史书,对照一场具体的“守门人对在位者”之争进行阅读,产出战术分析,把书中的打法映射到当前局势,并给出反制战术与短/中/长期行动手册。
输入
- 源文本:书籍(EPUB/PDF)、文章、转录稿、历史案例研究,或任何大型文档。
- 战略问题:要通过文本视角分析的具体情境。由用户明确描述,或在上下文中显而易见。
输出结构
brain page 是最终产物;PDF 只是渲染,永远不是主体。brain page 结构如下:
- 标题:[源文本标题] — 应用于 [问题]
- 一段式执行摘要:源文本如何映射到该情境、关键洞见、底线结论。
- 核心类比:源文本的核心动态如何映射到用户的情境。
- 章节/小节分级:对源文本每个主要部分给出 2-3 句摘要、与问题的相关性(高/中/低)、一条直接可用的引语(如有)。
- 原著打法:作者的框架、战术或策略,按“主角做了什么(战术)”“什么奏效及原因”“什么失败及原因”“对手做了什么有效的事”组织。
- 反制战术:源文本中映射到用户情境的具体动作,分为“该做什么(附源文本证据)”“该避免什么(附证据)”“该警惕什么(源文本中的预警信号)”。
- 应用手册:综合出的可执行建议,分为短期(本周/本月)、中期(本季度)、长期(今年及以后)。
- 关键引语:源文本中最切题的直接引语,最多 5-10 条,重质不重量。
- 参见:指向相关知识库页面的链接(相关概念、相关项目)。
使用方式(流程)
- 摄取源文本:EPUB 用 BeautifulSoup 提取章节(参见 book-mirror SKILL.md 的提取流程);PDF 用 pdftotext -layout;文章用 web_fetch;并识别目录与总规模。
- 章节分级:读取每章前 2000 字符,按与问题的相关性分级(高/中/低);高相关完整阅读,中相关部分阅读,低相关跳过。
- 深读高相关章节:记录所用战术与策略、权力动态及其变化、映射到问题的具体引语、主角方法成功或失败的时刻。
- 综合:把源文本洞见映射到具体问题,构建行动手册(做/避/警惕),生成短/中/长期建议,挑选最有冲击力的引语。
- 写作与交付:把 brain page 写到正确位置——如果针对具体问题,写到 projects/<slug>/playbook.md;如果是一般战略,写到 concepts/<slug>.md。通过标准 CLI 流程执行 put_page。可选:通过 skills/brain-pdf 渲染为 PDF。
质量标准
- 每条建议都必须引用源文本。不能只说“直接去找市长”,而要说“直接去找市长,因为当主角面对辞职威胁拒绝被吓倒时(第 48 章),那套曾对五位市长奏效的虚张声势终于失效了”。
- 直接引语是必需的。源文本自己的话比转述更有分量。
- 分析必须可行动:不是“这很有趣”,而是“做这个,避免那个,警惕这个”。
- 短/中/长期划分是必需的,用户需要知道明天做什么,也需要知道今年做什么。
适用场景
- 用历史案例研究分析当前的具体博弈或竞争处境。
- 把某本书或长文中的策略框架应用到正在面对的战略问题上。
- 需要可执行的战术与时间线,而非泛泛的读书笔记。
限制与不适用
- 不是书籍摘要工具:通用摘要请用其他技能(或 book-mirror 做个性化分析)。
- 不是研究工具:查找某主题的新信息请用 perplexity-research。
- 不是学术文学分析:不关心文学价值,只看战略应用。
- 当源文本不可用或被截断时:说明读了哪些部分,不要把行动手册扩展到已读范围之外。
- 保存手册若返回 revision_conflict 或 write_pending(退出码 10):重新读取并合并,或轮询 gbrain write-request <request_id>。
相关技能
- skills/book-mirror/SKILL.md:把书个性化到整个人生(而非单个问题)。
- skills/perplexity-research/SKILL.md:用于获取最新数据的当前情报交叉引用。
- skills/conventions/quality.md:引用与反向链接规则。
契约
该技能保证:路由与 frontmatter 中的规范触发条件匹配;输出写入 writes_to 所列目录(如适用);遵循所引用的约定(quality.md、brain-first.md、_brain-filing-rules.md);保持隐私契约——不使用真实姓名、不出现 fork 专属文件系统路径字面量、不引用上游 fork。
失败处理
遇到任何 gbrain 错误码、退出码、[AGENT] 块或通知块,遵循 agent operator 协议。本技能特定:源文本不可用或被截断时,说明已读部分,不要超出已读范围扩展手册;保存返回 revision_conflict 或 write_pending(退出码 10)时,重新读取并合并,或轮询 gbrain write-request <request_id>。