strategic-reading

strategic-reading — 基于源文本的应用分析

约定： 引用规则（每条建议都必须引用源文本）和反向链接约束，参见 conventions/quality.md。

约定： 参见 _brain-filing-rules.md，按主题归档输出文件：通用策略放入 concepts/，与具体问题相关的行动手册放入 projects/。

这是什么

输入一篇长文本以及一个具体的战略问题，产出把文本中的洞见映射到该问题上的分析。这不是书籍摘要，而是带着明确目标的阅读。

book-mirror 会把一本书个性化到读者的整个人生，strategic-reading 则把它个性化到一个当前问题上。两者结构相同（提取 → 分析 → 映照），只是视角不同。

典型示例： 一本关于权力动态的历史书，被用来对照一场具体的守门人与既得利益者之争，由此产出战术分析：把书中的策略映射到当前处境，给出反制战术，以及短期/中期/长期行动手册。

输入

1. 源文本：书籍（EPUB/PDF）、文章、访谈记录、历史案例研究，或任何长文档。
2. 战略问题：需要借助该文本视角来分析的具体处境。用户会明确描述，或从上下文中可以明显看出。

输出

brain 页面是产物。PDF 只是渲染形式，从来不是主要产物。

brain 页面结构

# [Source Title] — Applied to [Problem]

> One-paragraph executive summary: how the source maps to the situation,
> the key insight, the bottom line.

## The Core Parallel
How the source's central dynamic maps onto the user's situation.

## Chapter / Section Triage
For each major section of the source:
- 2-3 sentence summary of what it says
- Relevance to the problem: HIGH / MEDIUM / LOW
- One directly applicable quote (if any)

## The Source's Playbook
The author's framework, tactics, or strategies — organized as:
- What the protagonist DID (tactics)
- What WORKED and why
- What FAILED and why
- What OPPONENTS did that was effective

## Counter-Tactics
Specific moves from the source that map to the user's situation:
- What to DO (with source evidence)
- What to AVOID (with source evidence)
- What to WATCH FOR (warning signs from the source)

## Applied Playbook
The synthesis — actionable recommendations:
- **Short-term** (this week / this month)
- **Medium-term** (this quarter)
- **Long-term** (this year+)

## Key Quotes
Direct quotes from the source that are devastatingly relevant.
Maximum 5-10. Quality over quantity.

## See Also
Links to relevant brain pages (related concepts, related projects).

流程

Phase 1: Ingest the source
  ├── EPUB: extract chapters via BeautifulSoup (see book-mirror SKILL.md
  │   for the extraction pipeline)
  ├── PDF: pdftotext -layout
  ├── Article: web_fetch
  └── Identify Table of Contents and total size.

Phase 2: Triage chapters
  ├── Read first 2000 chars of each chapter.
  ├── Classify relevance to the problem (HIGH / MEDIUM / LOW).
  └── HIGH chapters get full reads. MEDIUM partial. LOW skipped.

Phase 3: Deep read HIGH chapters
  ├── Tactics and strategies used.
  ├── Power dynamics and how they shifted.
  ├── Specific quotes that map to the problem.
  └── Moments where the protagonist's approach succeeded or failed.

Phase 4: Synthesize
  ├── Map source insights onto the specific problem.
  ├── Build the playbook (do / avoid / watch for).
  ├── Generate short/medium/long-term recommendations.
  └── Select the most devastating quotes.

Phase 5: Write and deliver
  ├── Write the brain page at the right location:
  │     • If problem-specific: projects/<slug>/playbook.md
  │     • If general strategy: concepts/<slug>.md
  ├── put_page via the standard CLI flow.
  └── Optional: render to PDF via skills/brain-pdf.

质量标准

• 每条建议都必须引用源文本。 不要只说“直接去找市长”，而要说“直接去找市长，因为当主人公拒绝被辞职威胁吓倒（第 48 章）时，那个对五位市长都奏效的虚张声势终于失灵了。”
• 必须包含直接引语。 源文本自己的话比转述更有说服力。
• 分析必须可执行。 不是“这很有意思”，而是“做这件事，避开那件事，留意这个信号”。
• 必须包含短期/中期/长期拆分。 用户需要知道明天该做什么，也需要知道今年该做什么。

本技能不是什么

• 不是书籍摘要工具。如需一般性摘要，请使用其他技能；如需个性化分析，请使用 book-mirror。
• 不是研究工具。如需查找某个主题的新信息，请使用 perplexity-research。
• 不是学术文学分析。没人关心文学价值，只关心战略应用。

相关技能

• 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）均已落实。
• 隐私契约得到保持：不出现真实姓名、特定分支的文件系统路径字面量，也不引用上游分支。

完整的行为契约记录在上方正文各节中；本节存在的目的是供一致性测试使用。

输出格式

本技能的输出结构已在上方正文中说明（见“输出”“brain 页面格式”或同类章节）。此处的字面章节标题存在的目的是供一致性测试（test/skills-conformance.test.ts）使用。

失败处理

对于任何 gbrain 错误 code、退出码、[AGENT] 块或提示块，请遵循 agent 操作协议。针对本技能的补充如下：

• 源文本不可用或被截断：说明已读取的部分；不要把行动手册扩展到已读内容之外。
• 保存行动手册时返回 revision_conflict 或 write_pending（退出码 10）：重新读取并合并，或轮询 gbrain write-request <request_id>。

反模式

完整的反模式列表见上文正文部分;此标题用于一致性测试,以防正文使用了不同的大小写形式。