# Review Article

> 审查和优化已有教程文章、博客、草稿的格式与语言风格，确保文章兼具严谨的逻辑和自然的口语感

- Skill: `lingxiaobc/review-article` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lingxiaobc/review-article`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lingxiaobc/review-article/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lingxiaobc (https://skillmd.com/u/lingxiaobc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lingxiaobc/review-article

---


# 文章优化技能

## 技能定位

本技能专注于**优化已有文章**，不是创作新文章。

典型使用场景：
- 用户说"帮我看看这篇文章写得怎么样"
- 用户说"优化一下这个教程"
- 用户说"修改这篇文章，让它更适合小白阅读"
- 用户说"请审查这篇草稿"

目标风格：读起来像一个真正懂行的人在跟你讲话，不装、不绕弯，但逻辑清晰、重点突出。

---

## 审查流程

### 第 0 步：调用子代理读取上一篇文章（必须最先执行）

在审查正文之前，**必须**先调用 `prev-article-reader` 子代理，获取上一篇教程的结构化摘要。

**调用方式**：通过 Agent 工具，指定 `subagent_type: prev-article-reader`，传入当前文章的序号。

子代理定义路径：`.claude/agents/prev-article-reader.md`

子代理会返回：
- 上一篇的核心主题与结论
- 上一篇已引入的概念与比喻（本篇无需重复解释）
- 上一篇结尾的内容预告（本篇开头应与之呼应）
- 衔接建议

**如果当前是第 1 篇**或**非教程类文章**：子代理会返回"无上一篇"，跳过此步骤，直接进入第 1 步。

---

### 第 1 步：连贯性检查（仅限教程系列文章）

拿到子代理返回的摘要后，立即检查当前文章的**开头部分**是否与上一篇自然衔接：

**检查要点：**
- 文章开头是否呼应了上一篇的结尾预告或结论？
- 是否重复解释了上一篇已经详细介绍过的概念？（重复 = 冗余，需删减）
- 上一篇引入的比喻或术语，本篇是否直接使用而没有重新解释？（应直接用，无需再解释）
- 如果上一篇结尾有明确的"下一篇我们会讲……"，本篇开头是否有对应的承接？

**处理方式：**
- 若开头**未衔接**：在文章开头补写 1-3 句承接语，自然地从上一篇的结论过渡到本篇主题
- 若开头**重复解释**了上一篇的内容：删除重复段落，改为一句"上一篇我们已经了解了 XX，今天来看……"
- 若衔接已经自然：保留原文，继续下一步

---

### 第 2 步：调用子代理进行深度审查

**必须调用 `review-depth` 子代理**，对文章进行"小白可懂 + 底层原理 + 知识可迁移"三维审查。

**调用方式**：通过 Agent 工具，指定 `subagent_type: review-depth`，传入目标文章的路径和审查任务描述。

子代理定义路径：`.claude/agents/review-depth.md`

子代理会返回：
- 第一原则评估（换掉工具后价值剩余）
- 三个维度的评分（知识可迁移性、底层原理深度、小白可读性）
- 问题清单（含标记类型、位置、描述、修改建议）
- 优先修改项

---

### 第 3 步：内容准确性检查（必须执行）

**审查时必须对比官方文档，确保技术信息准确无误**

**1. 参考官方文件的位置**

官方文档位于：`reference/claude_code帮助文档/` 目录

审查教程文章时，必须：
- 读取官方文档中对应主题的内容
- 对比教程中的技术描述是否与官方文档一致
- 如果有冲突，**以官方文档为准**

**2. 需要检查的内容**

- **技术术语的定义**：是否与官方文档一致
- **功能描述**：功能是否如教程所说那样工作
- **操作步骤**：步骤顺序和操作方式是否正确
- **参数说明**：命令参数、配置项是否准确

**3. 发现错误时的处理**

当发现教程内容与官方文档不一致时：
1. 先标记出具体差异
2. 明确说明"官方文档是xxx，教程中写成了xxx"
3. 以官方文档为准进行修改
4. 如果官方文档表述过于技术化，需要用通俗语言重新解释，但核心含义不能变

---

### 第 4 步：语言风格检查

根据子代理审查报告中的问题，结合共享风格指南进行优化：

**→ 语言风格规范详见 `.claude/reference/style-guide.md`**

---

### 第 5 步：格式检查

基础排版规范（加粗高亮、段落留白、ASCII禁止）见 `CLAUDE.md`，审查时确保文章符合即可。以下为额外的格式审查项：

**1. 转折和对比处高亮**

出现"但是"、"然而"、"不过"、"相反"等转折词时，转折后的关键结论要加粗高亮。

**2. 核心概念引用块**

重要概念单独成行，使用引用块 + 加粗高亮：

```
> ==**核心概念：上下文窗口就像工作台面积，越大能放的东西越多。**==
```

**3. 警告和注意事项**

使用 ⚠️ 符号 + 加粗，确保显眼：

```
⚠️ **注意：这一步操作不可逆，执行前请确认已备份。**
```

**4. 留白与节奏**

- 避免大段文字堆在一起，让读者有停下来思考的空间
- 列表、代码块前后各留一行空行

---

### 第 6 步：输出修改版本

根据子代理审查报告和以上各步检查结果，对文章进行修改优化。

保存优化后的文章，并说明改动了哪些地方，其中**连贯性修改必须单独列出**，说明：

- 上一篇结尾预告了什么
- 本篇原开头是否有衔接
- 做了哪些调整

---

## 使用方法

用户可以通过以下方式调用此技能：
- `/review-article` 命令
- 说"帮我看看这篇文章写得怎么样"
- 说"优化一下这个教程"
- 说"修改这篇文章，让它更适合小白阅读"

技能会自动：
1. 调用 `prev-article-reader` 子代理（如果是教程系列），获取上一篇教程的摘要
2. 检查连贯性：根据摘要判断当前文章开头是否与上一篇自然衔接，必要时补写承接语
3. 调用 `review-depth` 子代理进行"小白可懂 + 底层原理 + 知识可迁移"三维审查
4. 对比官方文档进行内容准确性检查
5. 按语言风格、格式规范进行优化
6. 保存优化后的文章
7. 列出具体改动了哪些地方，以及改动原因（连贯性修改单独列出）