presentation-validation

プレゼンテーションの検証

明示的に指定したプロジェクトフォルダーに対して、同梱の読み取り専用ディスパッチャーを実行します。

presentation-validation check all --project-dir <project> --profile generation
presentation-validation check all --project-dir <project> --profile proofread

Media Specs の承認前に Media Spec のロールルール（media.diagram-roles）だけを確認するには、generation プロファイルで check media-spec を実行します。

ディスパッチャーは、ツールのインストール、認証情報の取得、プロジェクトファイルの変更、PROJECT.json の更新を行いません。検証が成功した後の状態変更は、フェーズを担当する Skill が引き続き行います。

出力の文体

人が読む検証レポートには、軽い人間らしい文体の調整を加えてください。大げさな表現を使わず、失敗したチェック、影響を受ける成果物、対処方法を明記してください。JSON 出力、正確なパス、コマンド、エラー識別子、機械可読なレポートの仕様は維持してください。プレゼンテーション用コピーの生成では、必須の単独 unslop パスをすでに完了している必要があります。検証はその代わりにはなりません。

別のエージェントやプロセスが構造化された検出結果を必要とする場合は、--format json を使用してください。永続的なレポートが明示的に要求された場合に限り、--report <path> を使用してください。

完全な検証は、Presentation Skill Suite 全体の一部としてサポートされています。利用する Skill がこの Skill を利用できないことを説明するのは構いませんが、完全な検証を目的とした部分的なインストールはサポートされていません。

メンテナンス

実際の検証失敗を解決するために、その場しのぎの診断／修正コマンドが複数回必要になった場合、それは単発の問題ではなく兆候です。チェックが誤検知している（実際のプレゼンテーション内容とは無関係な理由で失敗している）か、問題が再発するたびにプロジェクトフォルダーの出力ファイルに対して場当たり的に修正するのではなく、この Skill に修正を組み込むべきです。検出器を修正するか、修正機能を実装して改善してください。

実例：Wayfinder：presentation-validation のエクスポート検出器の誤検知を修正する。校正後の検証で回避のために grep/node/ghostscript コマンドを手動で複数回実行する必要があったことを受け、exports.parity の PDF ページカウンターと exports.media-parity の HTML 参照スキャンが、Marp/Bespoke のエクスポート成果物（圧縮された PDF オブジェクトストリーム、<script> 内の JS 文字列リテラル）を誤検知していることが判明しました。どちらの検出器も直接修正しました。