| name | format-article |
| description | 对英文文章进行美化排版，清理原始格式，添加正确的标题层级、段落分隔和列表结构，输出为规范的Obsidian Markdown格式，保存到 intermediate 目录。用户提供原始英文文章和主题名时触发。 |
文章排版技能 (format-article)
将原始/未格式化的英文文章转换为干净、结构化的 Obsidian Markdown，保留原文内容不变，仅改善排版和可读性。
前置条件
输出遵循 Obsidian Flavored Markdown 规范。参考：
obsidian-markdown 技能 — 完整语法参考obsidian-markdown/references/PROPERTIES.md — frontmatter 属性类型
输入
用户提供：
- 原始英文文章 — 两种方式：
- 直接在消息中粘贴文本
- 提供文件路径，技能用 Read 工具读取
用户提供文章后，技能询问目标文件夹路径。
工作流
步骤 1：读取输入
步骤 1b：询问目标文件夹并检测更新模式
- 向用户询问："请提供 intermediate 下的目标文件夹路径（如
intermediate/2000-passage1-america/）："
- 从文件夹路径解析出 topic（取路径最后一段目录名）
- 用 Read 工具检查
intermediate/<folder>/formatted-article.md 是否存在
若文件已存在（更新模式）：
- 逐段比较新排版内容与已有文件内容
- 仅对变化的段落/部分用 Edit 工具做最小改动
- 更新 YAML frontmatter 中的
updated 字段，保留 created
- 报告用户：哪些部分变了、哪些未变
- 检查同文件夹中
translation.md 是否存在，若存在则询问用户："检测到翻译文件也存在于该文件夹，是否需要同步更新翻译？"
- 若用户确认，对 translation.md 中对应的变化段落重新翻译
- 更新模式到此结束，跳过后续新建步骤
若文件不存在（新建模式）：
步骤 2：清理和标准化
- 合并连续空行（3+ 个空行 → 1 个空行）
- 标准化换行为 Unix 风格
\n
- 去除行首/行尾空格
- 将 Tab 缩进转换为空格
- 修复断行（散文中不自然的换行）
步骤 3：检测结构
识别以下元素，推测原作者意图：
- 标题：没有
# 标记但有标题特征的文字（全大写行、短行后跟空行、编号如 "I."、"Part 1" 等）
- 段落：由空行分隔的文本块
- 列表：以
-、*、1.、a) 等开头的行
- 引用：缩进段落或以引号包裹的段落
- 强调词：原文中用引号、斜体、大写等标记的重点词汇
步骤 4：应用 Obsidian Markdown 格式
- 为章节标题添加
#、##、### 前缀
- 确保段落间有且仅有一个空行
- 正确格式化嵌套列表（子项缩进 4 空格或 1 Tab）
- 将引用包裹在
> 语法中
- 用
**粗体** 标记关键术语（考研重点词汇）
- 用
==高亮== 标记文章中值得注意的表达
步骤 5：构建 YAML frontmatter
---
title: "[文章标题]"
type: article
topic: "[用户提供的 topic]"
tags:
- english-reading
- formatted-article
created: YYYY-MM-DD
updated: YYYY-MM-DD
sources:
- "[来源名称，若能识别]"
---
步骤 6：保存并验证（仅新建模式）
- 输出路径：
intermediate/<folder>/formatted-article.md
- 自动创建目录（如不存在，用 Bash
mkdir -p）
- 写入文件后验证：
- 向用户报告输出路径
步骤 7：自我学习（可选）
若执行中出现值得记录的模式（排版识别问题、结构检测改进等），检查 .learnings/ 是否存在。若存在且有内容，追加到 LEARNINGS.md，格式同 translate 技能。
输出格式
示例参见 references/ARTICLE_TEMPLATE.md。
核心约定：
- 每段后一个空行
- 标题层级清晰（
# → ## → ###）
- 列表缩进一致
- 关键术语用
**粗体** 标记
约束
- 不得改动文章内容或词汇——只改善排版
- 不得添加原文中不存在的章节、评论或分析
- 不得删除原文的任何部分
- 更新模式下仅改动发生变化的部分，保持原有格式和内容不变
相关技能
此技能是考研英语阅读精讲工作流的第二步：
translate — 翻译排版后的文章organize-grammar — 整理语法笔记compile-note — 整合为综合笔记extract-vocabulary — 提取生词表
