qiaomu-content-interpreter

name	qiaomu-content-interpreter
description	Transform content with Qiaomu's conversational style using TWO-PASS refinement. Pass 1: Rewrite with Qiaomu style. Pass 2: Compare with original, supplement missing content. Sequential workflow with automatic execution.

乔木内容解读 v3.3

概述

将任意长文本内容转化为乔木风格文章，采用真正的两遍精炼工作流和并发配图生成。

🚨 重要更新（v3.3）：配图逻辑优化 + 文件组织规范化

• 配图提示词生成：基于H2对应段落内容理解核心观点，而非仅看标题
• 文件组织规范：草稿放工作区（content_interpretations/），终稿放根目录
• 路径修复机制：自动检测和修复图片路径问题（papers/ → content_interpretations/）
• 完整示例流程：从读取段落→提炼观点→设计视觉隐喻的详细步骤

🚨 重要更新（v3.2）：新增中文规范检查

• 标点符号：强制使用中文标点（，。：？！），禁止英文标点
• 中英翻译：除人名/产品名外，所有英文必须翻译成中文
• 质量检查：在步骤1、步骤2、质量检查清单中全面添加规范要求

🚨 重要更新（v3.1）：优化命名和内容质量

• 主题命名：工作区用文章主题命名，不用时间戳
• 文件命名：用"主题-初稿/改进.md"，不用draft_v1/v2
• 禁止编造：明确禁止编造故事、案例、数据
• 非中文处理：增加翻译步骤

🚨 重大更新（v3.0）：修复workflow理解错误

• 不是两种模式，而是依次执行的两步workflow
• 步骤1（初稿）：用乔木风格重写原文（专注风格转换）
• 步骤2（改进）：对比原文和初稿，补充遗漏内容（专注内容完整性）

核心思想：

• 第一遍：专注于风格转换，可能会遗漏一些细节
• 第二遍：专注于内容完整性，补充遗漏的重要内容
• 两遍结合：既有乔木风格，又有完整内容
• 绝不编造：只使用原文的例子和数据

核心特点：

• ✅ 全自动执行，无需中途确认
• ✅ 真正的两遍精炼：风格转换 + 内容补充
• ✅ 并发配图生成，速度提升3倍
• ✅ 对话式语言，深度洞察
• ✅ 严格去AI感表达
• ✅ 《纽约客》风格配图

输出：

• 与原文等长的乔木风格文章（±10%）
• 配《纽约客》风格插画（每个H2标题一张）
• 完整工作档案（draft_v1初稿 + draft_v2改进版）
• 可对比两版，看风格转换和内容补充的过程

---

自动化工作流程

🚨 CRITICAL - 执行原则（必须严格遵守）：

1. ✅ 全自动执行：步骤0→1→2→3→4→5，不跳过任何步骤
2. ✅ 不询问用户：不问"是否需要配图"、"是否需要XX"，直接执行
3. ✅ 先保存文件再展示：每一步生成内容后，立即保存到文件，不要只在对话中输出
4. ✅ 必须生成配图：步骤3必须执行，不要跳过或询问用户
5. ✅ 实时更新进度：每完成一步立即更新TodoWrite状态

❌ 禁止行为：

• ❌ 不要只在对话中输出文章内容而不保存文件
• ❌ 不要问用户"是否需要配图"、"是否需要XX"
• ❌ 不要跳过任何步骤
• ❌ 不要在未完成所有步骤前就告知用户"完成"

推荐顺序：步骤0 → 1 → 2 → 3 → 4 → 5（严格按顺序）

---

初始化：创建进度追踪

第一步：创建todo list，让用户看到进度

TodoWrite([
    {"content": "准备工作空间", "status": "in_progress", "activeForm": "正在准备工作空间"},
    {"content": "生成初稿（第一遍）", "status": "pending", "activeForm": "正在生成初稿"},
    {"content": "生成改进版（第二遍）", "status": "pending", "activeForm": "正在生成改进版"},
    {"content": "生成纽约客风格配图", "status": "pending", "activeForm": "正在生成配图"},
    {"content": "保存最终文件", "status": "pending", "activeForm": "正在保存最终文件"}
])

每完成一步，立即更新状态为completed，下一步为in_progress

---

步骤0：准备工作空间和内容预处理

目标：创建工作目录，保存原始内容，如果是非中文则翻译，自动判断内容类型和目标路径

执行步骤：

步骤0.1：自动判断内容类型并选择目标路径

🚨 新增功能：自动识别内容类型，无需询问用户

根据输入内容自动判断类型，并选择正确的保存路径：

内容类型	关键词	目标路径	配图风格
YouTube/视频访谈	YouTube、视频、interview、访谈、对话	20-29 学习/23 播客转录/	纸雕水彩封面（4张）
公众号文章	公众号、文章、解读、分析	03.项目/AI不插电/ 或 11 公众号-向阳乔木推荐看/	纽约客风格插画
论文/学术	paper、论文、arxiv、PDF、学术	25 论文库/21.02 论文解读/	学术风格配图
小红书	小红书、xhs、图文	13 小红书/	手绘配图
默认	其他	20-29 学习/23 播客转录/	纸雕水彩封面

自动判断逻辑：

# 伪代码：自动判断内容类型
def get_content_type(user_input):
    if "youtube.com" in user_input or "YouTube" in user_input or "访谈" in user_input:
        return "podcast"  # 播客访谈
    elif "公众号" in user_input or "文章" in user_input:
        return "wechat"   # 公众号文章
    elif "论文" in user_input or "arxiv" in user_input or ".pdf" in user_input:
        return "paper"    # 学术论文
    elif "小红书" in user_input or "xhs" in user_input:
        return "xiaohongshu"
    else:
        return "podcast"  # 默认当播客访谈处理

🚨 重要：判断出内容类型后，不要询问用户，直接使用对应的路径和配图风格

步骤0.2：提炼文章主题，创建工作目录

重要：不要用时间戳，要用文章核心主题命名

# 根据内容类型选择基础路径
base_path = get_base_path(content_type)  # 如 "20-29 学习/23 播客转录/"

cd "/Users/joe/乔木新知识库/{base_path}"

# 1. 快速阅读原文，提炼核心主题（3-5个字）
# 例如："AnthropicCEO访谈"、"大鹏的十年"、"AI时代的选择"

# 2. 用主题+日期创建工作目录（避免重名）
work_dir="content_interpretations/停下来才能想清楚"
mkdir -p "$work_dir/images/illustrations"

步骤0.3：保存原文并判断语言

使用.md格式保存原文：

# 保存原始内容（使用.md格式）
Write(
    file_path="{work_dir}/original_content.md",
    content="{user_provided_content}"
)

判断语言：

• 如果是中文：直接进入步骤1
• 如果是非中文（英文等）：执行步骤0.3

步骤0.3：翻译非中文内容（如需要）

如果原文是非中文，先翻译成中文：

请将以下内容翻译成中文，保留原文的完整信息：

{original_content}

翻译要求：
- 准确传达原意
- 保留所有细节、数据、引用
- 自然流畅的中文表达
- 不要添加原文没有的内容

保存翻译版本（使用.md格式）：

Write(
    file_path="{work_dir}/translated_content.md",
    content="{translated_content}"
)

后续步骤使用translated_content作为"原文"

输出结构（工作区 + 终稿）：

AI不插电/                                      ← 根目录
├── 写文案就像做菜.md                          ← 终稿（步骤4生成，无H1标题）
│
└── content_interpretations/                   ← 工作区（所有中间产物）
    └── 停下来才能想清楚/                      ← 用主题命名
        ├── original_content.md                ← 原始内容（可能是英文）
        ├── translated_content.md              ← 翻译版本（如果需要）
        ├── 停下来才能想清楚-初稿.md           ← 初稿（第一遍，保留H1）
        ├── 停下来才能想清楚-改进.md           ← 改进版（第二遍，保留H1）
        ├── visual_config.json                 ← 配图配置
        └── images/
            └── illustrations/                 ← 配图目录
                ├── illustration_1.png
                ├── illustration_2.png
                └── ...

🚨 关键点 - 文件组织原则：

1. 草稿在工作区：

   • 所有中间版本（初稿、改进版）都放在content_interpretations/{主题}/
   • 保留H1标题，方便对比不同版本
   • 包含所有配图和配置文件

2. 终稿在根目录：

   • 步骤4用finalize_markdown.py脚本处理
   • 提取H1标题作为文件名
   • 从文章中删除H1行
   • 图片路径指向工作区的content_interpretations/{主题}/images/

3. 路径引用规范：

   • 工作区内的文件：相对路径images/illustrations/illustration_1.png
   • 根目录的终稿：相对路径content_interpretations/{主题}/images/illustrations/illustration_1.png
   • 脚本会自动处理路径转换

完成后：记录工作目录路径，更新todo状态

---

步骤1：生成初稿（第一遍 - 专注风格转换）

🚨 重要提醒：生成后必须立即使用Write工具保存到文件，不要只在对话中展示

目标：用乔木风格改写原文，专注于风格转换

核心提示词：

## 乔木写作风格参考 v2

### 语言特质
- 口语化、对话感强，像和读者面对面聊天
- 善用生活化类比解释复杂概念
- 在专业性和可读性之间自然平衡

### 人称视角（重要）
- **转述性内容**（YouTube视频、采访、论文等）：**必须用第三人称**
  - ✅ "作者说..."、"他认为..."、"研究者发现..."
  - ❌ "我觉得..."、"我认为..."、"我们看到..."
- **和读者互动**：可以用"你"来制造对话感
  - ✅ "你可能会想..."、"这对你意味着什么？"
- **引述原文观点**：明确归属，不占为己有
  - ✅ "作者的观点是..."
  - ❌ "我的观点是..."（除非是作者乔木本人的原创内容）

### 表达习惯
- 短段落，多留白，视觉舒适
- 重要观点用**加粗**突出
- 频繁用设问和"你"来制造互动感
- 要用中文逗号（，）不要加dash破折号
- **绝对不要用"不是"，"而是"，"想象一下","你有没有想过" 这种AI感表达**
- **绝对不要用破折号**

### 内容层次
- 不满足于表面解释，会延伸到更深的思考
- 善于在不同领域间建立联系（技术→生活→认知）
- 既讲"是什么"，也讲"为什么重要"

### 风格调性
- 真诚、不装、客观转述
- 专业但不掉书袋，数据和案例支撑观点
- 有洞察力，能给读者"原来如此"的感觉

---

### 待改写内容

{original_content}

---

### 改写要求（步骤1：初稿）

**重点**：专注于风格转换，用乔木风格重写原文

1. **H1标题**：
   - 必须从原文核心主题提炼
   - 概括全文，不只是抓一个细节
   - 吸引人，点题

2. **结构**：
   - 保持原文的主要内容结构
   - 根据原文长度决定H2章节数量（不限制）
   - 短段落，多留白

3. **内容处理**：
   - 尽量保留原文的核心内容
   - 用乔木风格重新表达
   - **可以接受**：为了流畅性，初稿可能会遗漏一些细节（步骤2会补充）
   - **不应该**：故意删减重要内容

4. **风格要求**：
   - 口语化表达
   - 生活化类比
   - 重要观点加粗
   - **第三人称转述**：用"他说..."、"作者认为..."，避免"我觉得..."
   - 可以用"你"和读者互动："你可能会想..."
   - 绝对禁止："不是...而是..."、"想象一下"、破折号

5. ：
   - ：100%使用中文标点
     - 用 `，` 不用 `,`
     - 用 `。` 不用 `.`（句末）
     - 用 `：` 不用 `:`
     - 用 `？` 不用 `?`
     - 用 `！` 不用 `!`
     - 用 `""` 不用 `""`（引号）

   - ：
     - ✅ 的3类英文：
       1. 人名（如 Naval Ravikant, Elon Musk, 李开复）
       2. 知名产品/公司名（如 GitHub, Google, Tesla, ChatGPT）
       3. 行业通用缩写（如 AI, API, CEO, CTO, VC, SaaS）

     - ❌ ：除上述3类外的所有其他英文词

     - ：如果一个普通中国读者（非IT专业人士）看到这个英文词会困惑或不理解，就必须翻译成中文

     - （必须避免）：
       - ❌ 形容词 + 中文：如 "真正amazing"、"很cool的想法"
       - ❌ 动词 + 中文：如 "properly使用"、"deeply理解"
       - ❌ 名词短语：如 "这个concept很重要"、"他的insight很深刻"
       - 正确做法：理解含义后用纯中文重写整句

     - （可以保留英文）：
       - ✅ 人名保留："Steve Jobs说..."、"李开复认为..."
       - ✅ 知名产品保留："在GitHub上..."、"用ChatGPT写代码"
       - ✅ 通用缩写保留："这家公司的CEO..."、"AI技术"

6. ：
   - 
   - 不要说"这让我想起一个朋友的故事"然后编造
   - 不要说"我认识一个人"然后编造
   - 只使用原文提供的例子和数据
   - 如果要类比，明确标注是类比，不要伪装成真实案例
   - 

6. ：
   - 与原文相当（±20%可接受）
   - 不追求严格等长，步骤2会调整

请用乔木风格改写，生成draft_v1。

🚨 生成并立即保存（强制）：

使用Write工具保存，文件名使用"主题-初稿.md"格式：

Write(
    file_path="{work_dir}/{article_theme}-初稿.md",
    content="{generated_draft_v1}"
)

# 例如：content_interpretations/停下来才能想清楚/停下来才能想清楚-初稿.md

🚨 严重错误示例（禁止）：

• ❌ 直接在对话中输出最终版本，没有保存初稿文件
• ❌ 使用draft_v1.md这种无意义的文件名
• ❌ 跳过步骤1，直接进入步骤2
• ❌ 编造故事、案例、数据

正确做法：

• ✅ 必须先生成初稿并保存到文件
• ✅ 文件名使用"主题-初稿.md"格式
• ✅ 然后才能进入步骤2生成改进版
• ✅ 工作目录必须同时包含"主题-初稿.md"和"主题-改进.md"
• ✅ 只使用原文的例子，不编造内容

完成后：

1. 立即更新TodoWrite状态为completed
2. 可以简短告知用户："✅ 初稿已生成并保存到 {work_dir}/{主题}-初稿.md"

---

步骤2：生成改进版（第二遍 - 专注内容完整性）

🚨 重要提醒：生成后必须立即使用Write工具保存到文件，然后直接进入步骤3生成配图

目标：对比原文和初稿，补充遗漏的内容

反思提示词：

你刚才用乔木风格生成了以下初稿：

---
{draft_v1_content}
---

现在需要**对比原文**，检查初稿是否遗漏了重要内容。

## 原文内容回顾

{original_content}

---

## 反思检查清单（按优先级排序）

### 🚨 1. 内容完整性检查（最高优先级）

**逐段对比原文和初稿**：

- [ ] 原文的核心观点是否全部保留？
- [ ] 具体的对话、数据、案例是否完整？
- [ ] 原文中的关键细节是否遗漏？
- [ ] 原文的论证逻辑是否完整？

**找出遗漏内容**：
- 列出初稿中**缺失但重要**的内容
- 列出初稿中**被过度简化**的部分
- 列出初稿中**需要补充**的细节

**字数检查**：
- 原文约X字，初稿约Y字
- 如果字数相差30%以上，说明删减过多，需要补充

### 2. 中文规范检查（必须100%符合）

**🔍 逐句阅读初稿，检查以下问题**：

- [ ] **标点符号**：是否100%使用中文标点？
  - 查找并替换：所有 `,` → `，`
  - 查找并替换：所有 `:` → `：`（排除URL中的）
  - 查找并替换：所有 `?` → `？`
  - 查找并替换：所有 `!` → `！`

- [ ] **中英混杂**：逐句检查是否有不该保留的英文词
  - **判断标准**：普通中国读者看到会困惑的英文词就要翻译
  - **可以保留**：人名、知名产品名、通用缩写（如 CEO, AI）
  - **必须翻译**：其他所有英文词和短语

  - **检查方法**：逐句阅读，看到英文词就问自己3个问题：
    1. 这是人名吗？（是→保留，否→继续）
    2. 这是知名产品/公司名吗？（是→保留，否→继续）
    3. 这是通用缩写吗？如CEO/AI（是→保留，否→必须翻译）

  - **常见错误模式**（全部必须修复）：
    - 形容词 + 中文：如"很amazing的方法"、"真正powerful的工具"
    - 动词 + 中文：如"properly执行"、"deeply分析"
    - 名词短语：如"这个concept"、"他的framework"

### 3. AI感表达检查（必须100%消除）

- [ ] 是否用了"想象一下"、"你有没有想过"？
- [ ] 是否用了"不是...而是..."？
- [ ] 是否用了破折号（—）？

### 4. 风格优化检查

- [ ] **内容是否重复啰嗦**：
  - 逐段检查是否有重复表达同一观点
  - 是否有意思相同但换了说法的句子
  - 删除冗余内容，保持简洁有力
  - 每个观点只说一次，不要反复强调
- [ ] **人称视角**：是否用第三人称转述？
  - 检查是否有"我觉得"、"我认为"等第一人称表达
  - 应该用"他说..."、"作者认为..."、"研究者发现..."
  - 可以用"你"和读者互动
- [ ] 生活化类比是否足够？（需要≥3处）
- [ ] 段落是否够短？（每段≤5行）
- [ ] 是否有互动感（设问、"你"）？

---

## 改进任务（步骤2：补充完善）

**重点**：补充遗漏内容，生成完整版

1. **🚨 补充遗漏内容（最优先）**：
   - 将初稿中遗漏的重要内容补充回来
   - 扩充被过度简化的部分
   - 确保所有关键细节都保留

2. **保持乔木风格**：
   - 补充的内容也要用乔木风格表达
   - 保持口语化、对话感
   - 继续使用生活化类比

3. **🚨 确保中文规范（必须严格执行）**：

   **标点符号修复**：
   - 全文替换：`,` → `，`
   - 全文替换：`:` → `：`（URL除外）
   - 全文替换：`?` → `？`
   - 全文替换：`!` → `！`

   **中英混杂修复**（最重要）：
   - **不要用简单替换**，要理解句子含义后重写
   - **方法**：
     1. 逐句阅读，找出所有中英混杂的句子
     2. 理解英文词的含义
     3. 用纯中文重新表达整句话
     4. 确保表达自然流畅

   - ：
     ```
     ❌ 原句："他会去找那些他真正admire的产品"
     ✅ 改写："他会去找那些他真正欣赏的产品"

     ❌ 原句："这是很weird的东西，不是主流"
     ✅ 改写："这是很奇特的东西，不是主流"

     ❌ 原句："properly leveraged的人"
     ✅ 改写："充分运用杠杆的人"
     ```

   - ：
     - 人名：Naval Ravikant, Elon Musk
     - 知名产品：GitHub, Google, Tesla
     - 通用缩写：AI, API, CEO, CTO

4. ：
   - 逐段检查，删除重复表达的内容
   - 同一观点不要反复说
   - 保持简洁有力，不拖沓

5. ：
   - 删除所有"不是...而是..."、"想象一下"
   - 删除破折号

6. ：
   - 短段落，多留白
   - 重要观点加粗

7. ：
   - 与原文相当（误差±10%）

：生成改进版draft_v2，应该既有乔木风格又有完整内容。

🚨 生成并立即保存（强制）：

使用Write工具保存，文件名使用"主题-改进.md"格式：

Write(
    file_path="{work_dir}/{article_theme}-改进.md",
    content="{generated_draft_v2}"
)

# 例如：content_interpretations/停下来才能想清楚/停下来才能想清楚-改进.md

完成后：

1. 立即更新TodoWrite状态为completed
2. 可以简短告知用户："✅ 改进版已生成并保存到 {work_dir}/{主题}-改进.md"
3. 🚨 必须立即执行步骤3生成配图，不要跳过，不要问用户，直接执行

---

步骤3：根据内容类型自动生成配图

🚨 🚨 🚨 CRITICAL - 此步骤必须执行，不得跳过，不得询问用户 🚨 🚨 🚨

强制执行规则：

• ✅ 必须执行：每次运行都必须生成配图
• ✅ 自动选择风格：根据内容类型自动选择配图风格，不需要询问用户
• ❌ 禁止跳过：不要以任何理由跳过此步骤
• ❌ 禁止询问：不要问用户"是否需要配图"或"用什么风格"
• ❌ 禁止提前结束：完成步骤2后，必须立即执行步骤3

🚨 自动判断配图风格（根据内容类型）：

内容类型	配图风格	尺寸	数量	位置
YouTube/访谈	纸雕水彩封面（MEMORY.md中的模板）	1280x720	4张	65 附件库/articles/{主题}_{日期}/
公众号文章	《纽约客》风格（每个H2一张）	16:9	N张	工作区 images/
论文	学术风格配图	16:9	N张	工作区 images/
小红书	手绘插图	1:1	N张	工作区 images/

🚨 纸雕水彩封面提示词模板（用于访谈/视频类内容）：

根据内容主题自动匹配关键词和设计风格。关键词符合纸雕风格融合水彩层次美学，字体结构立体精致如水彩纸雕工艺，边缘细腻带水彩渐变与阴影效果，柔和红色与淡蓝水彩背景中营造纸艺空间，点缀立体几何图形与水彩装饰元素，文字表面呈现高级纸张与水彩光泽质感，字形排列层次分明如精美纸雕作品，整体营造出精致工艺与艺术学习的优雅层次，温和而富有艺术感的教学氛围中透出水彩的精致美感，高级水彩工艺视觉。主题内容："{keyword}"超宽横向构图，画面宽度是高度的约两倍，电影级宽屏比例。

🚨 存储规则（访谈类内容）：

• 文件夹：~/乔木新知识库/60-69 素材/65 附件库/articles/{主题}_{YYYY-MM-DD}/
• 文件名：{主题}_1.png ~ {主题}_4.png
• 4张全部下载保存

目标：为每个H2标题并发生成配图（公众号/论文），或生成封面（访谈类）

工作流：

步骤3.1：Claude直接创建 visual_config.json

在 {work_dir}/ 目录下创建 visual_config.json（格式与 generate.py 对齐）：

{
  "task_id": "illustrations_{article_theme}",
  "template": "article",
  "source": "{work_dir}/{article_theme}-改进.md",
  "output_dir": "{work_dir}/images/illustrations",
  "cover": { "enabled": false },
  "illustrations": [
    {
      "id": "01",
      "h2_title": "H2标题",
      "visual_description": "50-80字中文具体场景描述",
      "filename": "01-slug.png"
    },
    {
      "id": "02",
      "h2_title": "H2标题",
      "visual_description" 
       
    
  
   
     
     
     
  

步骤3.2：Claude深度分析并填写visual_config.json

必须基于H2对应的段落内容来设计配图，而不只是标题

visual_description 必须用中文（即梦API是国产模型，中文描述更准确）

分析方法（每个H2都要执行）：

1. 定位章节内容：

   • 找到H2标题在文章中的位置
   • 读取该H2下的所有段落内容（直到下一个H2或文章结尾）
   • 理解这个章节在讲什么核心观点

2. 提炼核心观点：

   • 这个章节的中心思想是什么？
   • 有哪些关键概念、对比、隐喻？
   • 哪个具体场景或例子最能代表这个观点？

3. 设计视觉隐喻：

   • 用具象的物体、场景、动作来隐喻抽象概念
   • 50-80字的中文描述
   • 不包含文字指令（"底部标题"）和风格指令（"黑白线条"、"朱红色"）

示例流程：

H2标题："故事营销到底是什么玩意儿"

Step 1 - 读取段落内容：
"很多人一听'故事营销'，脑子里就开始编凤梨酥的传说...
你见过麦当劳汉堡在米其林餐厅端上来的样子吗？美食家们戴着白手套...
还是那个汉堡，只是换了个盘子、换了个环境。
这就是心理价值的魔法。"

Step 2 - 提炼核心观点：
- 核心思想：同样的东西，不同的呈现方式，感知完全不同
- 关键对比：快餐托盘 vs 高级餐盘，同一个汉堡
- 具体例子：麦当劳汉堡在米其林餐厅

Step 3 - 设计视觉隐喻：
"画面分为左右两半，左边是快餐店塑料托盘上的普通汉堡，日光灯照射；右边是同一个汉堡放在精致瓷盘上，配银叉和烛光，体现包装如何改变感知价值"

必须遵守的规则：

✅ 正确做法：

• 用中文描述
• 描述具体的物体、场景、动作
• 用隐喻手法表达抽象概念
• 50-80字之间
• 不包含"底部标题"、"标注文字"等文字指令
• 不包含"黑白线条"、"朱红色"等风格指令

❌ 错误做法：

• 只看标题不看内容就设计配图
• 包含文字指令："底部标题：XXX"
• 包含风格指令："用黑白墨水绘制"、"朱红色标注"
• 描述过于抽象，无法可视化

步骤3.3：批量并发生成配图

cd "{work_dir}"
python ~/.claude/skills/qiaomu-image-generator/scripts/generate.py \
  visual_config.json --workers 3

配图要求（系统自动控制，无需在visual_description中描述）：

• 钢笔墨水速写，16:9比例
• 黑白线条 + 朱红色点缀
• 简洁留白，松弛线条
• 底部中文标题（自动添加）

配图位置：

• 图片自动插入到H2标题的下方（紧跟H2行）
• 结构：## H2标题 → ![图片](路径) → 内容段落
• 脚本会自动检测并避免重复插入

性能：

• 并发生成，12张图约2分钟
• 自动重试机制（每张图最多重试2次）
• 线程安全（3线程并发）

完成后：

1. 立即更新TodoWrite状态为completed
2. 告知用户："✅ 已生成X张配图，耗时Y秒"
3. 直接进入步骤4保存最终文件，不要停顿

---

步骤4：保存最终文件

目标：用H1标题作为文件名，保存到根目录

执行步骤：

步骤4.1：运行finalize_markdown.py脚本

cd "/Users/joe/乔木新知识库/03.项目/AI不插电"
python3 ~/.claude/skills/qiaomu-paper-interpreter/scripts/finalize_markdown.py \
  "{work_dir}/{article_theme}-改进.md" .

脚本功能：

• 提取H1标题作为文件名
• 从文章中删除H1行
• 验证所有图片路径是否存在
• 保存到根目录

步骤4.2：修复图片路径（如需要）

检查路径格式：

# 检查最终文件的图片引用
grep "!\[" "{final_file}.md" | head -5

常见问题及修复：

1. 如果路径包含"papers/"前缀（从qiaomu-paper-interpreter脚本遗留）：

# 修复根目录的终稿
sed -i '' 's#papers/{work_dir_name}/images/#content_interpretations/{work_dir_name}/images/#g' "{final_file}.md"

# 同步修复工作区的改进版
sed -i '' 's#papers/{work_dir_name}/images/#content_interpretations/{work_dir_name}/images/#g' "{work_dir}/{article_theme}-改进.md"

2. 如果路径只有"images/"（相对路径不完整）：

# 补充完整的工作区路径
sed -i '' 's#images/illustrations/#content_interpretations/{work_dir_name}/images/illustrations/#g' "{final_file}.md"

正确的路径格式示例：

<!-- 根目录终稿中的图片引用 -->
![章节标题](content_interpretations/停下来才能想清楚/images/illustrations/illustration_1.png)

<!-- 工作区改进版中的图片引用 -->
![章节标题](images/illustrations/illustration_1.png)

步骤4.3：验证图片路径

# 验证所有图片文件确实存在
cd "/Users/joe/乔木新知识库/03.项目/AI不插电"
grep "!\[" "{final_file}.md" | grep -o "content_interpretations/[^)]*" | while read path; do
  if [ ! -f "$path" ]; then
    echo "❌ 图片不存在: $path"
  fi
done

效果：

• 根目录：写文案就像做菜.md（最终版，无H1，图片路径指向工作区）
• 工作目录：{work_dir}/{主题}-改进.md（保留H1，工作副本，相对路径）

完成后：

1. 立即更新TodoWrite状态为completed
2. 直接进入步骤5生成完成报告

---

步骤5：完成报告并打开文章

目标：告知用户完成情况，并自动在Obsidian中打开文章

执行：

# 自动在Obsidian中打开生成的文章
# file参数是相对于vault根目录的路径，不含.md后缀
open "obsidian://open?vault=乔木新知识库&file=03.项目/AI不插电/{h1_title}"

路径说明：

• vault：知识库名称（乔木新知识库）
• file：相对于vault根目录的路径，不含.md后缀
• 示例：03.项目/AI不插电/写文案就像做菜

简短告知用户：

✅ 内容解读完成！

📄 最终文件：{h1_title}.md
   位置：AI不插电/ (根目录)
   大小：XKB
   行数：约Y行

📝 字数统计：
   原文：约A字
   初稿：约B字
   改进版：约X字（补充了Z字）

🎨 配图生成：
   数量：X张《纽约客》风格插画
   耗时：约N秒（3线程并发）
   风格：钢笔墨水速写 + 朱红点缀
   比例：16:9

📁 工作档案：content_interpretations/{article_theme}/
   ├── original_content.md        ← 原始内容（可能是英文）
   ├── translated_content.md      ← 翻译版本（如果需要）
   ├── {主题}-初稿.md             ← 初稿（保留H1）
   ├── {主题}-改进.md             ← 改进版（保留H1，工作副本）
   ├── visual_config.json         ← 配图配置
   └── images/illustrations/      ← X张配图
       ├── illustration_1.png
       ├── illustration_2.png
       └── ...

✨ 改进对比：
   • 补充了初稿遗漏的N个要点
   • 消除AI感表达（"不是...而是..."、"想象一下"、破折号）
   • 修复中英混杂（除人名/产品名/通用缩写外全部翻译）
   • 统一中文标点（100%）
   • 优化段落结构（每段≤5行）
   • 删除重复啰嗦内容

🎯 质量保证：
   • 不编造故事、案例、数据
   • 只使用原文的例子和数据
   • 保留原文完整信息
   • 配图基于H2段落内容设计（非仅标题）

📊 文件组织：
   草稿在工作区 → content_interpretations/{主题}/
   终稿在根目录 → AI不插电/{H1标题}.md

📖 已在Obsidian中打开文章

---

质量检查清单

初稿检查

• 吸引人的H1标题
• 2-3段引入
• 4-6个H2章节
• 段落较短
• 重要观点加粗
• 有生活化类比
• 1500-2500字

改进版检查

• 100%中文标点：无英文逗号,、冒号:、问号?、感叹号!
• 0个中英混杂：除人名/产品名/通用缩写外，无任何英文词
  • 检查方法：逐句阅读，看到英文词就判断是否属于3类可保留英文
  • 错误模式：形容词+中文、动词+中文、英文名词短语
• 0个 "想象一下"、"你有没有想过"
• 0个 "不是...而是..."
• 0个 破折号（—）
• 0个 "首先"、"其次"、"最后"
• ≥3处生活化类比
• 每段≤5行
• 有跨领域联系
• 结尾有升华
• 核心观点全覆盖

配图检查

• 每个H2有配图
• 风格统一
• 已插入markdown
• 路径验证通过

---

与论文解读skill的对比

---

使用场景

1. 改写公众号文章：

   • 用户：用乔木风格改写这篇AI文章
   • 输出：深度解读版 + 配图

2. 技术文档通俗化：

   • 用户：这份API文档太难懂，帮我改写
   • 输出：对话式技术解读 + 配图

3. 读书笔记整理：

   • 用户：这是我的读书笔记，整理成文章
   • 输出：结构化文章 + 配图

4. 内容升级优化：

   • 用户：这篇文章太平淡，加工一下
   • 输出：优化版 + 配图

---

复用的脚本

从其他 skill 复用：

1. generate.py（配图生成器）

• 路径：~/.claude/skills/qiaomu-image-generator/scripts/generate.py
• 功能：并发生成《纽约客》风格配图、封面图等
• 特性：
  • 3线程并发，速度提升3倍
  • 自动重试2次
  • 支持 visual_config.json 配置
  • 统一的即梦API调用

2. finalize_markdown.py

• 路径：~/.claude/skills/qiaomu-paper-interpreter/scripts/finalize_markdown.py
• 功能：提取H1标题，用H1命名文件
• 特性：
  • 自动验证图片路径
  • 显示无效路径列表

---

新增脚本

prepare_workspace.py

• 路径：~/.claude/skills/qiaomu-content-interpreter/scripts/prepare_workspace.py
• 功能：创建工作空间，保存原始内容
• 用法：

  python prepare_workspace.py "原始内容文本"
  

---

故障处理

---

版本历史

• v3.3 (2025-12-26) - 配图逻辑优化 + 文件组织规范化

  • 配图提示词基于H2对应段落内容理解，而非仅标题
  • 文件组织规范：草稿在工作区，终稿在根目录
  • 路径修复机制：自动检测和修复papers/路径问题
  • 完整示例流程：读取段落→提炼观点→设计视觉隐喻

• v3.2 (2025-12-25) - 中文规范强制检查

  • 100%中文标点要求
  • 中英混杂零容忍（除人名/产品名/通用缩写）
  • 质量检查清单全面更新

• v3.1 (2025-12-24) - 优化命名和禁止编造

  • 工作区用主题命名，不用时间戳
  • 文件名用"主题-初稿/改进.md"
  • 明确禁止编造故事、案例、数据

• v3.0 (2025-12-23) - 修复workflow理解错误

  • 两遍精炼：步骤1专注风格转换，步骤2专注内容完整性
  • 强制保存初稿和改进版文件
  • 不是两种模式，而是依次执行的两步

• v2.0 (2025-12-23) - 整合并发配图、路径验证、完整脚本支持

• v1.0 (2024-12-22) - 初始版本，两遍精炼工作流

---

享受内容改写的乐趣！ 🎉