| name | review-article |
| description | 审查和优化已有教程文章、博客、草稿的格式与语言风格,确保文章兼具严谨的逻辑和自然的口语感 |
文章优化技能
技能定位
本技能专注于优化已有文章,不是创作新文章。
典型使用场景:
- 用户说"帮我看看这篇文章写得怎么样"
- 用户说"优化一下这个教程"
- 用户说"修改这篇文章,让它更适合小白阅读"
- 用户说"请审查这篇草稿"
目标风格:读起来像一个真正懂行的人在跟你讲话,不装、不绕弯,但逻辑清晰、重点突出。
审查流程
第 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. 发现错误时的处理
当发现教程内容与官方文档不一致时:
- 先标记出具体差异
- 明确说明"官方文档是xxx,教程中写成了xxx"
- 以官方文档为准进行修改
- 如果官方文档表述过于技术化,需要用通俗语言重新解释,但核心含义不能变
第 4 步:语言风格检查
根据子代理审查报告中的问题,结合共享风格指南进行优化:
→ 语言风格规范详见 .claude/reference/style-guide.md
第 5 步:格式检查
基础排版规范(加粗高亮、段落留白、ASCII禁止)见 CLAUDE.md,审查时确保文章符合即可。以下为额外的格式审查项:
1. 转折和对比处高亮
出现"但是"、"然而"、"不过"、"相反"等转折词时,转折后的关键结论要加粗高亮。
2. 核心概念引用块
重要概念单独成行,使用引用块 + 加粗高亮:
> ==**核心概念:上下文窗口就像工作台面积,越大能放的东西越多。**==
3. 警告和注意事项
使用 ⚠️ 符号 + 加粗,确保显眼:
⚠️ **注意:这一步操作不可逆,执行前请确认已备份。**
4. 留白与节奏
- 避免大段文字堆在一起,让读者有停下来思考的空间
- 列表、代码块前后各留一行空行
第 6 步:输出修改版本
根据子代理审查报告和以上各步检查结果,对文章进行修改优化。
保存优化后的文章,并说明改动了哪些地方,其中连贯性修改必须单独列出,说明:
- 上一篇结尾预告了什么
- 本篇原开头是否有衔接
- 做了哪些调整
使用方法
用户可以通过以下方式调用此技能:
/review-article 命令
- 说"帮我看看这篇文章写得怎么样"
- 说"优化一下这个教程"
- 说"修改这篇文章,让它更适合小白阅读"
技能会自动:
- 调用
prev-article-reader 子代理(如果是教程系列),获取上一篇教程的摘要
- 检查连贯性:根据摘要判断当前文章开头是否与上一篇自然衔接,必要时补写承接语
- 调用
review-depth 子代理进行"小白可懂 + 底层原理 + 知识可迁移"三维审查
- 对比官方文档进行内容准确性检查
- 按语言风格、格式规范进行优化
- 保存优化后的文章
- 列出具体改动了哪些地方,以及改动原因(连贯性修改单独列出)