validate-output

/digital-marketing-pro:validate-output

目的

マーケティングコンテンツが想定される構造スキーマに適合しているかを検証し、完全性、書式の一貫性、本番公開への準備が整っていることを確認します。必須セクション、語数の範囲、Markdown の書式ルールへの準拠、プレースホルダーテキスト（未入力のテンプレート変数、lorem ipsum、TBD マーカー）の検出、コンテンツと CTA の一貫性をチェックします。一般的なマーケティングコンテンツ向けの組み込みスキーマを 8 種類備えているほか、ブランド固有のテンプレート向けにカスタムスキーマもサポートしています。

このコマンドは、品質評価では見落とされる構造や書式の問題を検出します。たとえば、SEO を損なう H2 の欠落、見逃された「[INSERT COMPANY NAME]」というプレースホルダー、要件より 300 語少ないブログ記事、または CTA ではデモを約束しているのに本文ではホワイトペーパーについて述べているメールなどです。/digital-marketing-pro:eval-content を使ってコンテンツの品質を評価した後、公開前の最終チェックとして実行するよう設計されています。

必要な入力

ユーザーは次の情報を提供する必要があります（または入力を促されます）。

• 検証するコンテンツ：チェック対象のテキストです。直接入力、貼り付けたテキスト、またはファイルパスで指定できます。あらゆる形式のマーケティングコンテンツに対応しています。
• スキーマ名またはファイル（任意）：組み込みスキーマ 8 種類のいずれか（blog_post、email、ad_copy、social_post、landing_page、press_release、content_brief、campaign_plan）、またはカスタム JSON スキーマのファイルパスです。省略した場合、バリデーターはコンテンツの構造、長さ、書式パターンに基づいて、最も可能性の高いスキーマを自動検出します。カスタムスキーマは skills/context-engine/eval-framework-guide.md で定義されている形式に従います。

プロセス

1. ブランドコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み込み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドの書式基準とコンテンツ要件を適用します。~/.claude-marketing/brands/{slug}/guidelines/_manifest.json にガイドラインがあるかも確認します。存在する場合は、ブランド固有の必須セクション、文字数の範囲、書式ルールを定義している可能性がある templates/ のテンプレート定義を読み込みます。~/.claude-marketing/brands/{slug}/schemas/ にカスタムスキーマがあるか確認します。~/.claude-marketing/sops/ に代理店の SOP があるか確認します。ブランドが設定されていない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねます。または、デフォルト設定で続行します。
2. スキーマを決定する：スキーマ名またはファイルが指定されている場合は、それを直接使用します。指定されていない場合は、scripts/output-validator.py --action list-schemas を実行して利用可能なすべてのスキーマを取得し、コンテンツの特性（長さ、構成、書式パターン）に基づいて最も適切なものを選択します。選択が誤っていた場合にユーザーが変更できるよう、選択したスキーマとその理由を報告します。
3. 構造を検証する：組み込みスキーマを使う場合は、8 種類の組み込みスキーマのいずれかを指定して scripts/output-validator.py --action validate --text "{content}" --schema {builtin_schema_name} を実行します。カスタムスキーマファイルを使う場合は、--custom-schema {path/to/schema.json} を指定します（2 つのフラグは別々です。--schema が受け取るのは組み込みスキーマ名のみで、--custom-schema が受け取るのはファイルパスです）。バリデーターは次の項目を確認します。
   • 必須セクション：スキーマで定義されたすべてのセクションが、適切な見出しとともに含まれていること。各不足セクションについて、必要な内容とコンテンツ構成内で追加すべき位置を特定します
   • 文字数：総文字数とセクションごとの文字数が、スキーマで定義された範囲内であること。文字数不足（内容が薄く、掘り下げが足りない場合）と文字数超過（長すぎて削る必要がある場合）の両方を指摘します
   • 書式の準拠：Markdown の見出し階層が正しいこと（階層の飛び越しがないこと）、リストが適切に書式設定されていること、リンクの構文が有効であること、画像に代替テキストがあること、コードブロックが閉じられていること、表が正しく表示されること
   • プレースホルダーの検出：未入力のテンプレート変数（{placeholder}、[PLACEHOLDER]、[INSERT X]、TODO、TBD、FIXME、Lorem ipsum、xxx、プレースホルダーとして使用されている ACME Corp）、部分的な完成箇所、カスタマイズされていないことが明らかなテンプレートコンテンツを検索します
   • CTA の一貫性：コールトゥアクションがコンテンツのトピックと訴求内容に合致していること。メールマーケティングに関するブログ記事でソーシャルメディアガイドへ誘導していないこと、ウェビナーを宣伝するメールで一般的な問い合わせページではなくウェビナー登録ページにリンクしていることを確認します
   • SEO 構成（blog_post および landing_page スキーマの場合）：H1 があり、1 つだけであること、メタディスクリプションが 150～160 文字であること、タイトルタグが 50～60 文字であること、内部リンクがあること、キーワードが H1 と最初の 100 語に含まれていること
   • コンプライアンスマーカー（規制対象業界の場合）：必要な免責事項があること、必須の開示事項が含まれていること、必要に応じて利用規約に言及していること
4. 修正方法を提示する：不合格となった各チェック項目について、具体的なガイダンスを提示します。
   • 不足または誤りの内容と、コンテンツ内の正確な位置
   • スキーマが求める要件（適用されるルール）
   • 修正方法と、修正後のセクションの例
   • 修正が必須（スキーマで必須）か推奨（ベストプラクティス）か
5. カスタムスキーマのリクエストに対応する：組み込みの選択肢に合わないスキーマが必要な場合は、JSON スキーマの形式を案内します。
   • 必須フィールド：name、sections（name、required フラグ、最小／最大文字数を含むセクション定義の配列）、total_word_count（最小／最大）、formatting_rules、placeholder_patterns
   • 現在のコンテンツ構成に基づいて、ユーザーが調整できるスターター用スキーマを生成することを提案します
6. チェックリスト形式で結果を提示する：すべての検証結果を、ユーザーが順番に確認できる合格／不合格チェックリストとして書式設定し、特に重要な不合格項目を最初に示します。

出力

以下を含む、構造化された検証レポートです。

• 検証スコア：実行したチェック総数のうち合格したチェックの割合。構造上の完全性を示す主要指標です
• 使用したスキーマ：適用したスキーマ（組み込みの名称またはカスタムファイルパス）、ユーザー指定か自動検出か、自動検出の場合は検出の信頼度
• 合格／不合格チェックリスト：合格または不合格のステータスを添えた各チェック項目：
  • セクションチェック：必須セクションを一覧にし、存在／欠落のステータスを示します。欠落しているセクションごとに、想定される見出し、配置すべき場所、含める内容の例を示します
  • 単語数チェック：合計単語数とスキーマの範囲を比較し、想定範囲外のセクションがある場合は、そのセクションごとの単語数も示します。不足分も表示します（例：「最低1,500語に対して247語不足」）
  • 書式チェック：見出し階層、リストの書式、リンク構文、画像の代替テキスト、コードブロックの閉じ忘れ、表のレンダリングを検証します。問題ごとに、場所と違反した具体的な書式ルールを示します
  • プレースホルダーチェック：検出されたプレースホルダーの全インスタンスについて、正確なテキスト、行番号、推奨する対応（実際の内容に置き換える、削除する、意図的なものか確認する）を示します。テンプレート変数、lorem ipsum、TBD／TODO マーカー、明らかな仮名などの種類ごとに分類します
  • CTA の整合性チェック：CTA がコンテンツのトピックと約束に合致しているかを確認します。合致していない場合は、不整合の具体的な内容と修正案を示します
  • SEO 構造チェック（該当する場合）：H1 の有無と一意性、メタディスクリプションの長さ、title タグの長さ、キーワードの配置、内部リンク
  • コンプライアンスチェック（該当する場合）：必須の免責事項、開示事項、法的参照
• 修正チェックリスト：すべての不合格項目を優先度順に並べ、具体的な修正手順を示します。必須の修正を先に、推奨される改善を後に記載し、それぞれに修正文の例を添えます
• プレースホルダー一覧：コンテンツ全体で検出されたプレースホルダーを重複なくすべて列挙し、入力が必要な項目を一か所で確認できるようにします
• スキーマの参照情報：必要に応じて、適用したスキーマルールの概要を示します。執筆者が次の記事に取りかかる前に、構造上の要件を把握するのに役立ちます

使用エージェント

• quality-assurance — スキーマの選択と自動検出、すべてのチェック項目（セクション、単語数、書式、プレースホルダー、CTA の整合性、SEO 構造、コンプライアンスマーカー）にわたる構造検証の実行、具体例を用いた修正ガイダンスの作成、チェックリストの書式設定、カスタムスキーマ作成のガイダンス