lingxiaobc 文章优化技能
技能定位
本技能专注于优化已有文章，不是创作新文章。
典型使用场景：
- 用户说"帮我看看这篇文章写得怎么样"
- 用户说"优化一下这个教程"
- 用户说"修改这篇文章，让它更适合小白阅读"
- 用户说"请审查这篇草稿"
目标风格：读起来像一个真正懂行的人在跟你讲话，不装、不绕弯，但逻辑清晰、重点突出。
审查流程
第 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子代理进行"小白可懂 + 底层原理 + 知识可迁移"三维审查 - 对比官方文档进行内容准确性检查
- 按语言风格、格式规范进行优化
- 保存优化后的文章
- 列出具体改动了哪些地方，以及改动原因（连贯性修改单独列出）