mcpField
E
editorial-qa

editorial-qa

github.com/rampstackco营销与增长1.0k285 次安装1 周前更新
代码仓库

关于 editorial-qa

面向编辑负责人和内容团队的发布前质检方法,涵盖简报遵循度、品牌语气、事实、结构及 AI 内容特征。强调保留能发现实际问题的检查,避免流于勾选清单。

主要功能

  1. 01简报遵循度检查
  2. 02品牌语气审查
  3. 03事实与引用核验
  4. 04结构与清晰度审查
  5. 05AI 内容审计
  6. 06SEO 与 AEO 检查

适用场景

  1. 01建立发布前质检流程
  2. 02审查 AI 辅助撰写的草稿
  3. 03为程序化 SEO 设置抽样门槛

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rampstackco/claude-skills --skill editorial-qa

安装后在 Claude Code 中输入/editorial-qa确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
ai-content-audit-patterns.md
brief-adherence-checklist.md
common-qa-failures.md
fact-accuracy-and-citation-discipline.md
internal-linking-and-schema-validation.md
qa-at-scale-patterns.md
qa-workflow-templates.md
seo-aeo-compliance-checklist.md
structure-and-clarity-review.md
voice-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 项。

  1. 抓问题,而非打勾。 每项检查都应发挥作用,捕捉一类失败。
  2. 优先检查是否遵循简报。 这是成本最低、速度最快、价值最高的关卡。
  3. 将事实准确性设为停止条件。 AI 幻觉不能交付给读者。
  4. 保持语气一致,包括在正文中段抽样。 长篇内容的语气会逐渐偏移;应在全文中抽样检查。
  5. 审查 AI 生成内容。 识别 AI 特征、幻觉和语气偏移。
  6. 检查结构和清晰度。 导语、分节、篇幅大致均衡、结尾具体。
  7. 确保符合 SEO 和 AEO 要求。 答案段落、schema、实体覆盖。
  8. 验证内链和 schema。 外链可正常访问、锚文本多样、schema 验证通过。
  9. 大规模抽样。 对程序化生成内容和高产量内容集,应进行抽样,而非全面审查。
  10. 设置阈值门控。 失败率超过阈值时,停止生成;记录超标情况。
  11. 每篇内容指定一位 QA 负责人。 明确责任归属,避免责任分散到整个委员会。
  12. 安排检查顺序。 依次检查是否遵循简报、事实准确性、结构、AI 生成内容、语气、SEO/AEO、链接和 schema。

该框架的产出是一套团队可重复执行的 QA 流程:每项检查都有名称、每项检查都指定负责人、每个停止条件都有记录,且为程序化内容明确规定抽样规则。


参考文件


总结:质量保障是质量得到落实的关键环节

内容套件中的其他技能都会产出草稿。质量保障这门工作能将草稿变成可发布的内容。它也会检验此前的每项决策(简报结构、语气指南、中心架构、程序化模板)是否经得起实际产出的考验。跳过质量保障并不是“加快进度”,而是未经筛查就发布上游各项决策导致的所有失败模式。

质量保障流程是内容项目的免疫系统:运作正常时无形无迹,缺失时则后果惨重。

如果不确定质量保障流程是否已准备就绪,可以问问自己:每项检查是否都明确指出了要捕捉的失败类型?过去 6 个月里,每项检查是否确实捕捉到过问题?流程是否将简报遵循度检查放在首位?事实准确性是否属于必须暂停发布的条件?是否包含 AI 内容审查?抽样规范是否适用于规模化内容?如果以上答案全部为是,说明流程确实有效。如果有任何一项为否,读者就可能遭遇质量保障未能捕捉到的问题。

评论

支持 Markdown