translate

name	translate
category	学习工作流
description	将考研英语阅读文章翻译为中文，按段落生成中英对照格式，保存到 intermediate 目录。用户粘贴英文文本或提供文件路径，并指定主题名(topic)时触发。

翻译技能 (translate)

将英文阅读文章逐段翻译为中文，生成中英对照的 Obsidian 笔记，保存在 intermediate/<topic>/translation.md。

前置条件

本技能生成的笔记遵循 Obsidian Flavored Markdown 规范。输出格式参考：

• obsidian-markdown 技能 — 完整 Obsidian 语法（wikilinks、callouts、properties、embeds）
• obsidian-markdown 的 references/PROPERTIES.md — YAML frontmatter 属性类型
• obsidian-markdown 的 references/CALLOUTS.md — callout 类型

输入

用户提供：

1. 英文文章 — 两种方式任选其一：
   • 直接在消息中粘贴英文文本
   • 提供文件路径，技能用 Read 工具读取

用户提供文章后，技能询问目标文件夹路径。

工作流

步骤 1：读取输入

• 若用户粘贴文本，直接使用
• 若用户提供文件路径，用 Read 工具读取文件内容
• 识别文章的语言和大致长度

步骤 1b：询问目标文件夹并检测更新模式

• 向用户询问："请提供 intermediate 下的目标文件夹路径（如 intermediate/2000-passage1-america/）："
• 从文件夹路径解析出 topic（取路径最后一段目录名）
• 用 Read 工具检查 intermediate/<folder>/translation.md 是否存在

若文件已存在（增量模式）：

• 读取已有 translation.md，以英文原文段落为 key 建立映射表（去除编号标记后做归一化匹配）
• 将新原文逐段与映射表比对：
  • 段落完全匹配（归一化后一致）→ 保留原翻译，不做改动
  • 段落不存在于映射表中 → 按正常流程新翻译
  • 段落存在于映射表但内容有变化 → 重新翻译，保留原 > [!note] 翻译说明视情况更新
• 增量模式跳过新建模式的步骤 5，直接执行步骤 5b

若文件不存在（新建模式）：

• 继续执行以下步骤，创建目录和新文件

步骤 2：分析结构

识别原文的层次结构：

• 标题（#、## 层级）
• 段落边界（空行分隔）
• 列表、引用、代码块
• 保持原文的章节结构不变

步骤 3：逐段翻译

新建模式： 对每个段落/句子：

• 保留原文段落
• 在其下方添加中文翻译（用空行分隔）
• 标题保留原文，附加中文翻译，如：## The Challenges of Standardized Testing 标准化考试的挑战
• 对长难句，在翻译后可附加 > [!note] 简要解析翻译难点

增量模式（在步骤 1b 中已建立映射表）：

• 遍历新原文的每个段落：
  • 段落未变 → 从已有文件中取对应翻译，直接复用
  • 段落新增 → 按正常流程翻译
  • 段落修改 → 重新翻译，标注变化
• 保持段落顺序与原文一致

步骤 4：构建 YAML frontmatter

---
title: "[文章标题] 中英对照翻译"
type: translation
topic: "[用户提供的 topic]"
tags:
  - english-reading
  - translation
  - bilingual
difficulty: intermediate
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources:
  - "[文章来源，若能识别]"
---

步骤 5：写入输出文件（新建模式）

• 输出路径：intermediate/<folder>/translation.md
• 如果 intermediate/<folder>/ 目录不存在，先创建（用 Bash mkdir -p）
• 写入双语笔记内容（frontmatter + 正文）
• 向用户报告输出路径和段落数

步骤 5b：写入输出文件（增量模式）

• 将合并后的完整内容（已有翻译 + 新增翻译 + 重译段落）用 Write 工具写入原文件
• 保留原 YAML frontmatter 的 created 字段，更新 updated 字段
• 向用户报告：X 段保持不变，Y 段新增翻译，Z 段重新翻译

步骤 6：验证

• 新建模式：确认文件已保存，显示段落计数和文件大小，提示用户检查翻译质量
• 增量模式：报告"更新完成：X 段保持不变，Y 段新增翻译，Z 段重新翻译"

步骤 7：自我学习（可选）

执行中若出现值得记录的问题（翻译选择、格式问题、输出改进点等），检查 .learnings/ 是否存在。若存在且有意义，追加到 LEARNINGS.md：

## [LRN-YYYYMMDD-XXX] translate
**Priority**: low | medium | high
**Area**: translate

### Summary
单行简述

### Details
具体问题和建议
---

无有意义内容则跳过。

输出格式

文件结构参见 references/TRANSLATION_TEMPLATE.md。

核心格式约定：

• 每个原文段落后紧跟中文翻译
• 段落间用空行分隔
• 用 > [!note] 标注翻译说明（惯用语、文化背景等）
• 保留原文完整内容，不删减

约束

• 不得删除原文内容——必须保留完整原文供对照学习
• 不得合并段落——保持与原文相同的段落结构
• 不得添加原文中不存在的解释性内容（翻译说明除外，放在 > [!note] 中）
• 增量模式下仅修改变化段落和新段落，不得改动已存在的翻译内容
• 段落匹配基于英文原文的逐段归一化比较，不进行语义模糊匹配

相关技能

此技能是考研英语阅读精讲工作流的第一步：

• format-article — 排版原始英文文章
• organize-grammar — 整理语法笔记
• compile-note — 将翻译、文章、语法整合为综合笔记
• extract-vocabulary — 从整合笔记中提取生词表