关于 editorial-qa
面向编辑负责人和内容团队的发布前质检方法,涵盖简报遵循度、品牌语气、事实、结构及 AI 内容特征。强调保留能发现实际问题的检查,避免流于勾选清单。
主要功能
- 01简报遵循度检查
- 02品牌语气审查
- 03事实与引用核验
- 04结构与清晰度审查
- 05AI 内容审计
- 06SEO 与 AEO 检查
适用场景
- 01建立发布前质检流程
- 02审查 AI 辅助撰写的草稿
- 03为程序化 SEO 设置抽样门槛
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rampstackco/ claude-skills --skill editorial-qa安装后在 Claude Code 中输入/editorial-qa确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/ai-content-audit-patterns.mdbrief-adherence-checklist.mdcommon-qa-failures.mdfact-accuracy-and-citation-discipline.mdinternal-linking-and-schema-validation.mdqa-at-scale-patterns.mdqa-workflow-templates.mdseo-aeo-compliance-checklist.mdstructure-and-clarity-review.mdvoice-consistency-patterns.md详细介绍
编辑 QA
资深编辑的发布前内容 QA 手册。它是一套在内容发布前发现问题的规范,而不是等发布后才发现。
大多数内容 QA 都存在两个极端的问题。过于简单的版本是“我通读了一遍,拼写没问题吧”,它能发现错别字,却会漏掉简报偏离、语气不一致、事实幻觉、AI 痕迹以及结构问题;这些问题会让读者觉得“内容还行,但没什么让人记住的地方”。过于繁琐的版本则是有 47 项的检查清单,没人会认真完成,因为这只是在做流程表演:没人真的相信那些复选框能发现问题。
这项技能讲的是如何通过 QA 发现问题。每项检查都有其价值,能发现一类具体问题;如果漏掉,这类问题就会出现在读者面前。发现不了任何问题的检查就删掉。生产量无法支撑的检查就重新设计(改为抽样而非全面审查,或改为自动化而非人工检查)。去掉形式主义后,剩下的就是 QA 框架。
这项技能涵盖三种生产模式:单篇编辑内容(一次一篇,全面 QA)、AI 生成的草稿(加入两年前还没有如此突出的 AI 内容审查),以及大规模程序化 SEO 内容集(抽样规范、阈值把关)。每种模式都需要自己的 QA 形式;其底层方法可以组合应用于这三种模式。
适用场景:从头搭建内容 QA 流程;审查现有 QA 流程,查明它为何总是发布粗糙内容或让团队精疲力竭;为 AI 辅助工作流设计 QA 把关;或为程序化 SEO 内容集建立抽样规范。
这项技能的用途
这项技能涵盖发布前的质量控制。它会在其他每项内容技能的输出末尾介入。六项内容技能的分工如下:
content-strategy的范围是项目层面:决定要制作什么。pillar-content-architecture的范围是主题中心:规划主题中心的组成结构。content-brief-authoring的范围是单篇内容:为每篇内容撰写简报。content-and-copy的范围是执行:撰写每篇内容。programmatic-seo的范围是规模化:根据数据生成大量页面。- 本技能的范围是把关:在发布前进行核验。
以上每项技能都会产出草稿。本技能负责让草稿达到可发布的标准。它是实际落实质量把关的环节。
适用对象:编辑负责人、内容总监、内部内容 QA 人员、设有生产线的代理机构、内容运营经理,以及任何负责管理写作者(人类或 AI)并对发布内容负责的人。语气采用资深编辑对初级编辑或内容营销人员的口吻。内容具体、有主见,并坦诚说明 QA 在何处能发挥价值、在何处会沦为流程表演。
问题捕捉型 QA 与勾选框型 QA
这是关键区别。两种失效模式,以及应遵循的原则。
薄层 QA(把错别字检查包装成质量控制)。“我读了一遍,没问题。”能发现明显错误,却会漏掉简报偏差、语气不一致、捏造的事实、结构问题和 AI 痕迹。结果:发布的内容“还行,但没什么记忆点”。代价:直到出现品牌失误、捏造统计数据,或竞争对手的内容不断积累、让薄层内容落后时,问题才会显现。
**厚重型 QA(列出 47 项,却没人能如实完成的清单)。**列出所有可能的检查项,却不做优先级排序。审核者要么草草浏览并勾选方框(作秀),要么因认知负担过重而精疲力竭。结果:发布的内容比薄层 QA 产出的稍加完善,但团队的审核速度会大幅下降。代价:产出量下滑;审核者离开;清单逐渐退化,最终只剩下少数真正会执行的检查项。
**问题捕捉型 QA(应遵循的原则)。**每项检查都必须发挥作用,捕捉一类若未发现就会传达给读者的问题。没有捕捉到问题的检查项就删除。根据产量决定抽样还是全面审查。审核者要为自己发现的问题负责,而非为勾选完清单负责。
试金石:如果团队能说出每项 QA 检查最近发现的 3 个问题,这项检查就发挥了作用。如果某项检查 6 个月都没发现任何问题,那它就是在作秀。删除它;将精力重新分配给能发现实际问题的检查项。
简报遵循情况检查
写作者是否按简报完成了内容?如果简报编写得当(参见 content-brief-authoring),检查起来很直接。
简报遵循情况检查项:
- **目标关键词和主题集群。**出现在标题、首段和各级标题中。
- **搜索意图和 SERP 格式。**内容符合 SERP 的主流格式(SERP 需要文章时就写文章,需要清单式文章时就写清单式文章)。
- **目标受众。**内容读起来像是写给指定受众的,而非泛泛的读者。
- **标题结构。**内容遵循简报中的 H2 / H3 大纲,或有记录在案的偏离理由。
- **必需实体。**简报中标记的每个实体都出现在内容中。
- **内部链接。**简报指定的出站链接均已添加,且锚文本正确。
- **反模式。**内容避免使用简报中列出的禁用语言和结构。
- **已考虑成功标准。**内容经过设计,能够根据成功标准进行衡量。
简报遵循情况检查是成本最低、速度最快、价值最高的 QA 关卡。它在 QA 流程中首先运行,因为尽早发现不符合简报的问题,可以避免编辑把时间花在一篇需要推倒重来的内容的语气和结构上。
如果简报含糊不清,这项检查就无从进行。先修正简报;QA 流程无法执行一份并不存在的约定。
详情请见 references/brief-adherence-checklist.md。
语气一致性检查
内容听起来符合品牌风格吗?
- **词汇。**正确使用品牌专属术语;不出现不符合品牌风格的术语。
- **句子节奏。**符合品牌语气(短促有力、沉稳有层次,或口语化)。
- **立场。**内容表达的观点与品牌立场一致。
- **语域。**正式或随意的语气与呈现形式相符(博客、白皮书或帮助文档)。
- **长篇内容中的语气偏移。**3,000 字的内容常常开头符合品牌语气,到第 4 节就逐渐变得泛泛而谈。抽查开头、中间和结尾处的段落。
对于 AI 共同创作的内容,语气偏移是最主要的失效模式。除非写作者主动引导,AI 助手往往会退回到模型默认语气。QA 检查不仅要关注文字,也要关注品牌语气。
详情请见 references/voice-consistency-patterns.md。
事实准确性与引用规范
文中的每项陈述都必须真实。检查内容:
- 统计数据。 所有数字都必须注明来源;没有来源的则删除。
- 引言。 每条引言都必须归于确实说过这句话的真实人物。
- 案例研究。 每个示例都必须对应真实公司或真实场景,或明确标注为假设情境。
- 日期和时间线。 必须经过核实,不能使用近似日期。
- 具名专家。 必须是真实人物,并同意被引用。
- 产品声明。 必须符合产品的实际行为,不能描述尚未实现的路线图或营销愿景。
幻觉是 AI 辅助写作中最常见的失败模式。AI 助手会生成看似可信的统计数据、引言和案例研究,但它们都不真实。事实准确性检查就是把关环节,负责发现这些问题。如果在 AI 生成的内容上跳过这道关卡,你发布的就会是幻觉内容。
引用规范:
- 文内引用应链接到权威来源(学术论文、行业报告、一手资料)。
- 避免引用其他内容营销页面(引用漂白)。
- 标注来源日期;对于快速变化的主题,超过 3 年的来源需要更新。
详情见 references/fact-accuracy-and-citation-discipline.md。
结构与清晰度检查
这篇文章整体是否成立?
- 导语。 前 200 个词应回答用户可能提出的问题(适用于 SEO/AEO 文章),或确立核心论点(适用于思想领导力文章)。
- 分节。 H2 应符合用户的思维模型,而非作者的兴趣。
- 章节长度。 各个 H2 下的篇幅应大致均衡。一节篇幅巨大,另外四节各 80 个词,说明结构存在问题。
- 阅读流畅度。 段落之间应衔接自然,句子长度应有所变化。
- 具体性与抽象性。 陈述应具体,而非含糊其辞。
- 结尾。 文章应以具体内容(行动、问题、想法)收尾,而不是用空洞的套话拖延。
详情见 references/structure-and-clarity-review.md。
AI 内容审核
这是一个两年前还没这么受重视的 QA 检查项。即使由称职的人类编辑润色,AI 共同创作的内容也会呈现出可识别的模式。
AI 特征(模式识别)。
- 过度使用 em-dash(模型默认的标点)
- 可预测的开篇措辞(先铺垫、再宣布文章接下来要讲什么;例如「在快节奏的世界中」式开篇、「强调重要性」式开篇、「无论你是 X 还是 Y」式开篇)
- 可预测的结尾段落(先铺垫再收尾,例如「按照以下步骤」)
- 本可以用散文表达的内容,却过度使用项目符号列表
- 过度使用「另一方面」/「然而」
- 生硬地采用双边论述框架(即使一方明显正确,也总要呈现「两面」)
- 句尾填充语(「……以及更多。」「……以及其他内容。」「……例如。」)
- 句子节奏重复(每段都是 2–3 句话,长度也相近)
- 泛泛的开篇(换成任何一篇同主题文章都适用的描述性段落)
- 过渡填充语(「话虽如此」「考虑到这一点」「接下来」)
- 对本应具体明确的论断叠加模糊限定词(「通常」「一般来说」「往往」)
幻觉模式(事实错误)。
- 看似权威的统计数据(精确到特定小数位,并注明来源),但来源并不存在,或来源并未如此表述
- 将真实人物没有说过的话归于他们
- 关于不存在的公司的案例研究
- 指向返回 404 页面或从未存在过的 URL 的引文
- 没有实际研究支撑的「研究表明」类论断
- 虚构的产品功能
语气偏移。
- 文章开头符合品牌语气,到第 4 节却变得泛泛而谈
- 词汇退回模型默认用语
- 品牌立场原本明确,却变得圆滑外交(「各方都有充分理由」)
审核方法。带着这些模式进行阅读,发现任何匹配之处都要标记。标准不是「是否使用了 AI」(现在几乎总会使用);而是「谨慎的人类编辑会不会批准发布」。如果文章中出现上述模式,就需要再修改一轮,并明确指出这些模式。
详见 references/ai-content-audit-patterns.md。
SEO 和 AEO 合规检查
这篇内容是否既服务于搜索引擎,又能回答引擎的问题?
SEO 检查。
- 目标关键词出现在标题、H1、首段和 slug 中
- 标题层级清晰(没有孤立的 H3,也没有缺少 H3 的 H4)
- 图片 alt 文本描述具体
- Meta description 有吸引力,并考虑到关键词
- 简报中指定的内部链接均已添加
- 外部链接通常在新标签页中打开,并带有适当的 rel 属性
- URL slug 简短且描述清晰
AEO 检查。
- 每个疑问式 H2 后紧接一段 40–60 个词的回答
- 包含 TL;DR 部分(适用于支柱文章)
- 包含带有 FAQPage schema 的 FAQ 部分(适用于采用问答格式的文章)
- 统计数据具体,并附有来源引用(AI 引擎会赋予带来源的统计数据更高权重)
- 始终提及具名实体(专家、方法、工具),确保实体覆盖
- 展现鲜明且可归因于品牌的观点
详见 references/seo-aeo-compliance-checklist.md。
内部链接与架构验证
内部链接。
- 简报中指定的出站链接均已添加,且锚文本正确
- 锚文本应有所变化(避免所有链接都使用“点击此处”,或都使用完全匹配的目标关键词)
- 链接目标均可正常访问(无 404,也不链接到已弃用的页面)
- 内部链接数量与内容长度相匹配(典型的 1,500 字文章为 3 到 7 个,支柱文章为 8 到 15 个)
- 自我蚕食检查:文章不会与现有文章竞争同一个目标关键词
架构验证。
- 大多数文章都包含 Article 架构;教程类文章使用 HowTo 架构;适用问答内容时使用 FAQPage 架构
- 架构符合 schema.org 定义(无缺失的必填字段,也无格式错误的 JSON-LD)
- 架构与页面内容一致(如果页面上没有评分,就不要在架构中声称有 5 星评分)
详见 references/internal-linking-and-schema-validation.md。
大规模 QA
对于以程序化 SEO 规模发布的内容(从数百页到 100,000 页),全面审计 QA 不可行。应以抽样规范取而代之。
抽样策略。
- 每个审计周期进行随机抽样,样本量按照
references/qa-at-scale-patterns.md中的样本量计划确定;具体数值以该文件为准 - 确保样本涵盖不同的数据形态(稀疏与密集记录、新近生成与较早生成、热门与小众类别)
- 该计划按数据集规模区间设定固定抽样数量,随着区间增大而上升,直至在最大区间达到平台期。因此,随着数据集增大,抽样百分比会下降,这是有意为之:超过一定规模后,增加页面不再带来更多有效信息
大规模自动化检查。
- 标题结构验证
- 架构标记验证
- 字数统计(标记低于下限的页面,例如少于 600 字)
- 重复内容检查(将每个页面与数据集中的其余页面进行比较)
- 失效链接检查
- 图片存在性检查(模板要求图片时)
对抽样页面进行人工检查。
- 简报遵循情况的等效检查(模板遵循情况检查:页面是否按模板编写?)
- 前 200 字的答案质量
- 页面是否能满足人类用户的可能需求
- 页面读起来是否有特色,而非模板化
- 如果流程中使用了 AI,则抽查 AI 幻觉
阈值把关。
- 如果抽样页面中超过 5% 未通过人工审核,则暂停生成新内容
- 恢复前先修复模板或数据质量问题
- 在 QA 日志中记录超出阈值的情况,以便发现规律
详见 references/qa-at-scale-patterns.md。
QA 工作流
负责人和顺序。
每篇内容由一位 QA 负责人负责,而非委员会。负责人对已发布的内容负责。委员会会稀释责任;问题到了读者面前,就没人负责了。
顺序。 按照 references/qa-workflow-templates.md 中排序模板设定的顺序运行各道关卡;该模板负责管理关卡列表及其顺序。简报遵循度检查优先运行:这是成本最低、能够叫停内容的关卡,也能发现最大一类问题。SEO/AEO 和链接与 schema 检查放在接近末尾的位置,因为大多数问题都能自动修复,而且很少会导致内容被叫停。最后通读一遍,结束整个流程。
叫停、标记还是自动修复。
- 简报遵循度和事实准确性检查可以叫停(退回给作者)。
- 语气和结构检查会标记问题并提出建议;由编辑判断是叫停,还是直接修订。
- SEO/AEO 和 schema 通常自动修复(slug、meta description 和 schema 标记都是机械性编辑,编辑或脚本无需作者参与即可完成发布)。
升级处理。 如果 QA 发现某种规律(多篇内容未通过同一项检查),应升级给简报作者、写作者或编辑流程负责人。规律性问题反映的是流程问题,而不只是单篇内容的问题。
详见 references/qa-workflow-templates.md。
常见失败模式
快速列举。诊断方法见 references/common-qa-failures.md。
- “我们的 QA 流程有一份包含 47 项内容的清单,但没人能完成。”这是检查清单表演;删减到真正发挥作用的检查项。
- “上季度 QA 一个问题都没发现。”要么流程出了问题,要么写作者表现非凡;需要调查。
- “编辑和写作者对语气意见不一。”语气指南太含糊;用具体示例记录品牌语气。
- “AI 幻觉被发布了。”事实准确性关卡被跳过或草草带过;恢复为叫停条件。
- “我们的 pSEO 内容集发布了内容单薄的页面。”缺少抽样规范,或未遵守阈值。
- “QA 花的时间比写作还长。”顺序不对;尽早检查简报遵循度,能在投入语气和结构工作之前发现问题。
- “审稿人精疲力竭。”那些发现不了问题的检查会消耗审稿人的精力;删掉它们。
- “长篇内容写到一半时,语气就跑偏了。”抽查文章中段的段落,而不只是开头和结尾。
- “我们从不回头评估。”归档的 QA 日志可用于发现规律;每季度进行一次复盘。
- “不同编辑采用的标准不一样。”开展校准会议,让编辑独立审阅同一篇内容并协调标准。
- “发布后才在社交媒体上发现问题。”QA 没有发现读者遇到的那类问题;针对这类问题增加检查项。
编辑 QA 的框架:12 项考量
设计或审查 QA 流程时,请逐一考虑以下 12 项。
- 抓问题,而非打勾。 每项检查都应发挥作用,捕捉一类失败。
- 优先检查是否遵循简报。 这是成本最低、速度最快、价值最高的关卡。
- 将事实准确性设为停止条件。 AI 幻觉不能交付给读者。
- 保持语气一致,包括在正文中段抽样。 长篇内容的语气会逐渐偏移;应在全文中抽样检查。
- 审查 AI 生成内容。 识别 AI 特征、幻觉和语气偏移。
- 检查结构和清晰度。 导语、分节、篇幅大致均衡、结尾具体。
- 确保符合 SEO 和 AEO 要求。 答案段落、schema、实体覆盖。
- 验证内链和 schema。 外链可正常访问、锚文本多样、schema 验证通过。
- 大规模抽样。 对程序化生成内容和高产量内容集,应进行抽样,而非全面审查。
- 设置阈值门控。 失败率超过阈值时,停止生成;记录超标情况。
- 每篇内容指定一位 QA 负责人。 明确责任归属,避免责任分散到整个委员会。
- 安排检查顺序。 依次检查是否遵循简报、事实准确性、结构、AI 生成内容、语气、SEO/AEO、链接和 schema。
该框架的产出是一套团队可重复执行的 QA 流程:每项检查都有名称、每项检查都指定负责人、每个停止条件都有记录,且为程序化内容明确规定抽样规则。
参考文件
references/brief-adherence-checklist.md- 将简报中的每个字段作为一项 QA 检查,并说明如何验证及失败时的表现。references/voice-consistency-patterns.md- 长篇内容的词汇、节奏、立场、语域,以及正文中段抽样规范。references/fact-accuracy-and-citation-discipline.md- 验证方法、幻觉检测、引用规则和来源时效指南。references/structure-and-clarity-review.md- 导语模式、分节原则、结尾和结构反模式。references/ai-content-audit-patterns.md- 11 种 AI 特征、6 种幻觉模式、语气偏移检测,以及附带修订的示例。references/seo-aeo-compliance-checklist.md- 将 SEO 和 AEO 检查合并为一个工作流。references/internal-linking-and-schema-validation.md- 链接规范、锚文本变化、schema 模式和验证。references/qa-at-scale-patterns.md- 抽样策略、自动化检查、大规模人工审查和阈值门控。references/qa-workflow-templates.md- 责任归属、检查顺序、停止与标记及自动修复,以及升级处理模式。references/common-qa-failures.md- 11 种以上失败模式及其诊断和修复方法。
总结:质量保障是质量得到落实的关键环节
内容套件中的其他技能都会产出草稿。质量保障这门工作能将草稿变成可发布的内容。它也会检验此前的每项决策(简报结构、语气指南、中心架构、程序化模板)是否经得起实际产出的考验。跳过质量保障并不是“加快进度”,而是未经筛查就发布上游各项决策导致的所有失败模式。
质量保障流程是内容项目的免疫系统:运作正常时无形无迹,缺失时则后果惨重。
如果不确定质量保障流程是否已准备就绪,可以问问自己:每项检查是否都明确指出了要捕捉的失败类型?过去 6 个月里,每项检查是否确实捕捉到过问题?流程是否将简报遵循度检查放在首位?事实准确性是否属于必须暂停发布的条件?是否包含 AI 内容审查?抽样规范是否适用于规模化内容?如果以上答案全部为是,说明流程确实有效。如果有任何一项为否,读者就可能遭遇质量保障未能捕捉到的问题。