文章优化技能

技能定位

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

典型使用场景：

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

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

审查流程

第 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. 列出具体改动了哪些地方，以及改动原因（连贯性修改单独列出）