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公開前QAプロセスの構築
  2. 02AI支援の原稿レビュー
  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

詳細

編集品質保証

公開前のコンテンツ品質保証に関する、シニアエディターの実践ガイドです。問題を公開後ではなく、公開前に見つけるための規律です。

コンテンツの品質保証には、よくある問題が二つの方向にあります。簡素すぎる方法は、「一度読んで、スペルに問題がないか確認したか」というもので、誤字は見つけられても、ブリーフからの逸脱、語り口の不統一、事実の捏造、AI らしさの兆候、構造上の問題は見逃し、読者に「問題はないけれど印象に残らない」と受け取られます。反対に、47項目のチェックリストを使う方法では、誰も正直に最後まで確認しません。問題を見つけられると誰も実際には信じていないチェックボックスを並べただけの、プロセスを演じる作業になってしまうからです。

このスキルは、問題を見つけるための品質保証の実践です。それぞれのチェックには、見逃せば読者に届いてしまう特定の失敗を見つける役割があります。何も見つけられないチェックは削除します。制作量に見合わないチェックは、全件監査ではなくサンプリングにする、手作業ではなく自動化するなど、再設計します。プロセスを演じるだけの作業を取り除いたあとに残るものが、この品質保証フレームワークです。

このスキルでは、制作形態を三つ扱います。一つずつ制作し、全件を品質保証する単体の編集記事、以前よりもAI コンテンツ監査が重要になったAI 生成のドラフト、そしてサンプリングの規律としきい値によるゲートを必要とする、大規模なプログラマティック SEO のページ群です。それぞれに適した品質保証の形がありますが、基盤となる手法はどの形態にも適用できます。

このスキルを使う場面:コンテンツの品質保証プロセスを一から構築するとき、雑な成果物を公開してしまう、またはチームを疲弊させる既存のプロセスを監査するとき、AI 支援ワークフローの品質保証ゲートを設計するとき、プログラマティック SEO のページ群に対するサンプリングの規律を構築するときです。


このスキルの目的

このスキルは、公開前の品質管理を扱います。他のすべてのコンテンツスキルの成果物に、最後の工程として組み込みます。コンテンツスキル6種の違いは次のとおりです。

  • content-strategy はプログラムの範囲を扱います。何を制作するかを定めます。
  • pillar-content-architecture はハブの範囲を扱います。トピックハブをどう組み立てるかを定めます。
  • content-brief-authoring は記事単位の範囲を扱います。各記事のブリーフを作成します。
  • content-and-copy は実行の範囲を扱います。各記事を執筆します。
  • programmatic-seo は大規模展開の範囲を扱います。データから多数のページを生成します。
  • このスキルはゲートの範囲を扱います。公開前に確認します。

上記の各スキルはドラフトを作成します。このスキルは、ドラフトを公開可能な状態に仕上げます。品質を実際に担保するゲートです。

対象者は、編集リーダー、コンテンツディレクター、社内のコンテンツ品質保証担当者、制作ラインを持つエージェンシー、コンテンツオペレーションマネージャー、そして人間またはAI のライターを起用し、公開する成果物に責任を持つすべての人です。語りかける相手は、ジュニアエディターまたはコンテンツマーケターです。具体的で、明確な見解を示し、品質保証が本当に役立つ場面と、プロセスを演じる作業になってしまう場面を率直に伝えます。


問題を見つけるQAとチェックボックス式QA

最も重要な違いです。2つの失敗パターンと、その規律について説明します。

薄い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 ごとの長さをおおむね均等にします。1 つの巨大なセクションと、80 語ほどのセクションが 4 つある構成は、構成に問題があることを示しています。
  • 読み進めやすさ。 段落同士をつなげ、文の長さに変化をつけます。
  • 具体性と抽象性のバランス。 主張は曖昧にせず、具体的にします。
  • 締めくくり。 最後は、具体的な行動、問い、アイデアで締めくくり、言いよどむような不要な文言は避けます。

詳細は references/structure-and-clarity-review.md を参照してください。


AI コンテンツ監査

2年前にはそれほど目立たなかった QA チェックです。AI が共同作成したコンテンツには、優れた人間の編集者が手を加えていても、検出可能なパターンがあります。

AI 特有の兆候(パターン認識)。

  • em ダッシュの過剰な使用(モデルのデフォルトの句読点)
  • 予測可能な書き出し表現(記事の内容を予告する前置き。変化の激しい現代社会について述べる書き出し、重要性を強調する書き出し、「あなたが X でも Y でも」という書き出し)
  • 予測可能な結びの段落(前置きのようなまとめ、「これらの手順に従うことで」)
  • 文章で十分に伝わる箇所でも箇条書きを多用
  • 「一方で」/「しかし」の多用
  • 無理な二項対立の構成(一方が正しい場合でも、常に「2つの側面」を提示する)
  • 文末の埋め草(「……など。」「……といったものがあります。」「……たとえば。」)
  • 文のリズムの反復(各段落が2~3文で、長さも似通っている)
  • 汎用的な書き出し(そのトピックを扱うどの記事にも使える説明的な段落)
  • つなぎの冗長表現(「とはいえ」「それを踏まえて」「次に」)
  • 本来は具体的であるべき主張に対する、ぼかし表現の重ね掛け(「通常は」「一般的に」「しばしば」)

ハルシネーションのパターン(事実誤認)。

  • 権威がありそうに見える統計(小数点以下まで細かい数字、出典名がある)だが、その出典が存在しない、または記載内容が主張と異なる
  • 実在の人物が言っていない言葉を、その人物の発言として引用する
  • 実在しない企業の事例研究
  • 404 エラーになる、または最初から存在しない URL の引用
  • 実際の研究が裏付けていない「研究によると」という主張
  • 実在しない製品機能

文体のぶれ。

  • ブランドの文体で始まるが、4つ目のセクションまでに汎用的な文体へと変わる
  • 語彙がモデルのデフォルトに戻る
  • ブランドの立場が明確だったのに、「どちらの立場にも妥当な主張がある」と外交的な表現になる

監査の進め方。これらのパターンを念頭に置いて読み、該当するものをすべて指摘してください。基準は「AI が使われたか」(今ではほぼ常に使われています)ではなく、「注意深い人間の編集者が公開したか」です。上記のパターンが見られる場合は、該当箇所を明示して、もう一度修正する必要があります。

詳細は references/ai-content-audit-patterns.md をご覧ください。


SEO と AEO の準拠チェック

そのコンテンツは、検索エンジンと回答エンジンの両方に役立っていますか?

SEO チェック。

  • ターゲットキーワードがタイトル、H1、最初の段落、スラッグに含まれている
  • 見出しの階層が適切(孤立した H3 がない、H3 なしで H4 を使っていない)
  • 画像の代替テキストが具体的
  • メタディスクリプションが魅力的で、キーワードを意識している
  • 概要で指定された内部リンクが含まれている
  • 外部リンクが新しいタブで開き(通常)、適切な rel 属性が設定されている
  • URL スラッグが短く、内容を的確に表している

AEO チェック。

  • 各 H2 の質問の直後に、40~60語の回答段落がある
  • TL;DR セクションがある(ピラーページの場合)
  • FAQ セクションと FAQPage スキーマがある(Q&A 形式が適しているコンテンツの場合)
  • 出典を引用した具体的な統計がある(AI エンジンは出典付きの統計を重視します)
  • 固有名詞(専門家、手法、ツール)が一貫して記載されている(エンティティの網羅性を示すシグナル)
  • ブランドに結び付く、独自の視点がある

詳細は references/seo-aeo-compliance-checklist.md をご覧ください。


内部リンクとスキーマの検証

内部リンク。

  • ブリーフで指定された外部リンクが、適切なアンカーテキストで設置されている
  • アンカーテキストに変化をつける(すべてのリンクを「こちらをクリック」にしたり、すべてを完全一致のターゲットキーワードにしたりしない)
  • リンク先が有効である(404 エラーや、廃止されたページへのリンクがない)
  • コンテンツの長さに応じて内部リンクの数が適切である(通常の1,500語の記事では3~7件、ピラーページでは8~15件)
  • 自己カニバリゼーションを確認する。同じターゲットキーワードで既存の記事と競合していない

スキーマの検証。

  • 大半の記事に Article スキーマがあり、手順を説明する記事には HowTo スキーマ、Q&A が該当する場合は FAQPage スキーマがある
  • スキーマが schema.org の定義に照らして有効である(必須フィールドの欠落や、JSON-LD の形式不備がない)
  • スキーマとページ上のコンテンツに一貫性がある(ページ上に評価がないのに、スキーマで5つ星評価を主張しない)

詳細は references/internal-linking-and-schema-validation.md を参照してください。


大規模な QA

プログラマティック SEO 規模(数百~数万ページ)のコンテンツでは、すべてを監査する QA は現実的ではありません。サンプリングの規律で代替します。

サンプリング戦略。

  • 監査サイクルごとに無作為抽出します。サンプル数は、数値の基準となる references/qa-at-scale-patterns.md のサンプルサイズスケジュールに従います
  • データの形状(疎なレコードと密なレコード、最近生成されたものと古いもの、人気カテゴリとニッチなカテゴリ)全体でサンプルのバランスを取ります
  • スケジュールでは、セットサイズの各区分に対して固定件数を定め、最大の区分では上限に達します。そのため、セットが大きくなるほどサンプリング率は下がります。これは意図的なものです。一定の規模を超えると、ページを増やしても新たに得られる情報が増えなくなるためです

大規模環境での自動チェック。

  • 見出し構成の検証
  • スキーママークアップの検証
  • 単語数(例として600語など、最低基準を下回るページにフラグを立てる)
  • 重複コンテンツのチェック(各ページをセット内の他のページと比較する)
  • リンク切れのチェック
  • 画像の有無のチェック(テンプレートで画像が想定されている場合)

サンプルページの手動チェック。

  • ブリーフへの準拠と同等の確認(テンプレートへの準拠チェック:ページがテンプレートに沿って作られているか)
  • 冒頭200語の回答品質
  • 想定される人間のユーザーのクエリをページが満たすかどうか
  • ページがテンプレート的ではなく、独自性のある内容として読めるかどうか
  • AI が関与している場合は、AI による幻覚がないかを抜き取り確認する

しきい値によるゲート管理。

  • サンプルページの5%を超えて手動レビューに不合格となった場合、新規生成を停止する
  • 再開する前に、テンプレートまたはデータ品質の問題を修正する
  • 傾向を把握できるよう、QA ログにしきい値超過を記録する

詳細は references/qa-at-scale-patterns.md を参照してください。


QA ワークフロー

担当と順序。

1 つのコンテンツにつき QA 担当者は 1 人とし、委員会にはしません。担当者は公開した内容に責任を負います。委員会では責任が分散し、読者に届いた問題の責任者が誰もいなくなります。

順序。 references/qa-workflow-templates.md のシーケンステンプレートで定められた順序でゲートを実施します。ゲートの一覧と順序はこのテンプレートで管理します。ブリーフへの準拠チェックを最初に実施します。これはコンテンツの進行を止められるゲートの中で最もコストが低く、最も広範な種類の失敗を検出できるためです。SEO/AEO ゲートとリンク・スキーマゲートは終盤に置きます。これらで見つかる問題のほとんどは自動修正でき、進行を止めることもほとんどないためです。最後に読み直して一連のチェックを終えます。

停止・指摘・自動修正。

  • ブリーフへの準拠チェックと事実の正確性チェックでは、進行を停止できます(ライターに差し戻します)。
  • 文体と構成については修正案を示して指摘し、停止するかインラインで修正するかは編集者の判断に委ねます。
  • SEO/AEO とスキーマは通常、自動修正します(スラッグ、メタディスクリプション、スキーママークアップは機械的な編集であり、ライターの関与なしに編集者またはスクリプトで反映できます)。

エスカレーション。 QA でパターン(同じチェックに複数のコンテンツが不合格となること)が見つかった場合は、ブリーフの作成者、ライター、または編集プロセスの責任者にエスカレーションします。パターンは、各コンテンツの個別の問題だけでなく、プロセス上の問題を示しています。

詳細は references/qa-workflow-templates.md を参照してください。


よくある失敗例

次々と挙げます。診断については references/common-qa-failures.md を参照してください。

  • 「QA プロセスには 47 項目のチェックリストがありますが、誰も最後まで完了しません。」チェックボックスを埋めるだけになっています。役に立つと確認できたチェックだけに絞りましょう。
  • 「前四半期の QA で問題を 1 つも見つけられませんでした。」プロセスが機能していないか、ライターが並外れて優秀かのどちらかです。原因を調べましょう。
  • 「編集者とライターで文体について意見が合いません。」文体ガイドラインが曖昧です。具体例を挙げてブランドの文体を文書化しましょう。
  • 「AI の幻覚が公開されてしまいました。」事実の正確性チェックが省略されたか、急いで行われました。停止条件として再設定しましょう。
  • 「pSEO のコンテンツ群で内容の薄いページを公開してしまいます。」サンプリングの規律が欠けているか、しきい値が守られていません。
  • 「QA に執筆より時間がかかります。」順序が適切ではありません。ブリーフへの準拠チェックを早い段階で行えば、文体や構成に時間をかける前に問題を検出できます。
  • 「レビュー担当者が燃え尽きています。」問題を検出できないチェックがレビュー担当者の注意力を消耗させています。そうしたチェックは削除しましょう。
  • 「長いコンテンツの途中で文体がぶれます。」冒頭と末尾だけでなく、途中の段落もサンプリングしましょう。
  • 「評価を振り返ることがありません。」QA ログのアーカイブをパターン検出に活用し、四半期ごとにレビューしましょう。
  • 「編集者によって適用する基準が異なります。」編集者が同じコンテンツを個別にレビューし、結果をすり合わせる調整セッションを行いましょう。
  • 「公開後にソーシャルメディアで問題が見つかります。」QA で読者に届いている種類の問題を検出できていません。その種類の問題をチェックする項目を追加しましょう。

フレームワーク:編集品質保証(QA)における12の検討事項

QA プロセスを設計または監査する際は、次の12項目を確認してください。

  1. 問題の検出とチェックリスト化。 各チェックは、特定の失敗パターンを検出することで価値を発揮します。
  2. ブリーフへの準拠を最優先。 最も低コストで、迅速かつ価値の高いゲートです。
  3. 事実の正確性を停止条件にする。 AI のハルシネーションを読者に届けてはいけません。
  4. 途中のサンプリングも含めて、文体の一貫性を確認。 長文では文体がぶれるため、全体を通してサンプリングします。
  5. AI 生成コンテンツの監査。 AI 生成コンテンツ特有の兆候、ハルシネーション、文体のぶれをパターン認識で検出します。
  6. 構成と明瞭さ。 リード、セクション分け、均等に近い長さ、具体的な結びを確認します。
  7. SEO と AEO への準拠。 回答段落、スキーマ、エンティティの網羅性を確認します。
  8. 内部リンクとスキーマの検証。 外部リンクが有効であること、アンカーテキストに変化があること、スキーマが検証に通ることを確認します。
  9. 大規模な場合のサンプリング。 プログラムで生成したコンテンツや大量のコンテンツには、全件監査ではなくサンプリングが必要です。
  10. しきい値によるゲート。 失敗率がしきい値を超えた場合は生成を停止し、違反を記録します。
  11. 記事ごとに QA 担当者を1人決める。 委員会全体に責任を分散させません。
  12. 実施順序。 ブリーフへの準拠、事実の正確性、構成、AI 生成コンテンツの監査、文体、SEO/AEO、リンク、スキーマの順に進めます。

このフレームワークの成果は、チームが繰り返し実行できる QA プロセスです。各チェック、担当者、停止条件を明記し、プログラムで生成したコンテンツについては各サンプリングルールを指定します。


参考ファイル

まとめ:品質が担保されるのは QA によるチェックがあってこそです

コンテンツスイートのほかのスキルは、すべてドラフトを作成します。ドラフトを公開可能な成果物に仕上げるのが、QA という規律です。また、これまでに下したすべての決定(ブリーフの形式、文体ガイドライン、ハブの設計、プログラマティックなテンプレート)が、実際の出力に照らして検証される場でもあります。QA を省略するのは「スピードを優先する」ことではありません。上流のすべての決定に潜む失敗要因を、フィルタリングせずに公開することです。

QA プロセスはコンテンツプログラムの免疫システムです。正常に機能しているときは目立ちませんが、なければ壊滅的な事態を招きます。

QA プロセスの準備が整っているか迷ったときは、次の点を確認してください。各チェック項目で、検出する失敗の種類が明示されているか。各チェック項目が過去 6 か月以内に実際に何かを検出したか。手順の最初にブリーフへの準拠チェックがあるか。事実の正確性が作業停止の条件になっているか。AI コンテンツの監査が含まれているか。サンプリングの規律が、規模を拡大したコンテンツにも適用されているか。すべてに「はい」と答えられるなら、そのプロセスは実際に機能しています。どれか一つでも「いいえ」なら、そのギャップで QA が検出できなかった問題に読者が遭遇することになります。

コメント